_impl_include/acdb17/AcString.h

Go to the documentation of this file.

#pragma once
 
//
// (C) Copyright 2005-2024 by Graebert GmbH.
//
// Permission to use, copy, modify, and distribute this software in
// object code form for any purpose and without fee is hereby granted,
// provided that the above copyright notice appears in all copies and
// that both that copyright notice and the limited warranty and
// restricted rights notice below appear in all supporting
// documentation.
//
// GRAEBERT PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS.
// GRAEBERT SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE.  GRAEBERT GMBH
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
 
class AcDbHandle;
class AcStringImpl;
 
class ARX_API AcString
{
private:
 
    friend class AcStringImpl;
    AcString( AcStringImpl * );
 
public:
    __int64  asDeci64( int )const;
    __int64  asHex64( int )const;
    AcString( char const * );
    AcString( char );
    AcString( AcDbHandle const & );
    AcString( AcString const & );
    AcString( AcString && acs );
    AcString( int, unsigned int );
    AcString( HINSTANCE__ *, unsigned int );
    AcString( void );
    AcString( wchar_t const * );
    AcString( wchar_t );
    ~AcString( void );
    bool  isAscii( void )const;
    bool  isEmpty( void )const;
    bool  loadString( HINSTANCE__ *, unsigned int );
    bool  loadString( unsigned int );
    char const *  kszPtr( void )const;
    AcDbHandle  asAcDbHandle( int )const;
    AcString &  append( char const * );
    AcString &  append( char );
    AcString &  append( AcString const & );
    AcString &  append( wchar_t const * );
    AcString &  append( wchar_t );
    AcString &  assign( char const * );
    AcString &  assign( char );
    AcString &  assign( AcDbHandle const & );
    AcString &  assign( AcString const & );
    AcString &  assign( wchar_t const * );
    AcString &  assign( wchar_t );
    AcString &  setEmpty( void );
    AcString  concat( char const * )const;
    AcString  concat( char )const;
    AcString  concat( AcString const & )const;
    AcString  concat( wchar_t const * )const;
    AcString  concat( wchar_t )const;
    AcString  precat( char const * )const;
    AcString  precat( wchar_t const * )const;
    AcString  precat( wchar_t )const;
    AcString  substr( int )const;
    AcString  substr( int, int )const;
    AcString  substrRev( int )const;
    AcString  mid( int ) const;
    AcString  mid( int, int ) const;
    AcString  left( int ) const;
    AcString  right( int ) const;
    int  asDeci( int )const;
    int  asHex( int )const;
    int  compare( char const * )const;
    int  compare( AcString const & )const;
    int  compare( wchar_t const * )const;
    int  compare( wchar_t )const;
    int  collate( wchar_t const * ) const;
    int  collate( AcString const & ) const;
    int  compareNoCase( char const * )const;
    int  compareNoCase( AcString const & )const;
    int  compareNoCase( wchar_t const * )const;
    int  compareNoCase( wchar_t )const;
    int  collateNoCase( wchar_t const * ) const;
    int  collateNoCase( AcString const & ) const;
    int  find( AcString const & )const;
    int  find( wchar_t const * )const;
    int  find( wchar_t )const;
    int  findOneOf( wchar_t const * )const;
    int  findOneOfRev( wchar_t const * )const;
    int  findNoneOf( wchar_t const *, int = 0 ) const;
    int  findRev( AcString const & )const;
    int  findRev( wchar_t const * )const;
    int  findRev( wchar_t )const;
    int  findLast( wchar_t, int = -1 ) const;
    int  findLast( wchar_t const *, int = -1 ) const;
    int  findLastOneOf( wchar_t const *, int = -1 ) const;
    int  findLastNoneOf( wchar_t const *, int = -1 ) const;
    int  match( char const * )const;
    int  match( AcString const & )const;
    int  match( wchar_t const * )const;
    int  matchNoCase( char const * )const;
    int  matchNoCase( AcString const & )const;
    int  matchNoCase( wchar_t const * )const;
    unsigned __int64  asUDeci64( int )const;
    unsigned __int64  asUHex64( int )const;
    unsigned int  asUDeci( int )const;
    unsigned int  asUHex( int )const;
    unsigned int  length( void )const;
    AcString & format( wchar_t const *, ... );
    AcString & formatV( wchar_t const *, va_list );
    AcString & appendFormat( wchar_t const *, ... );
    AcString & makeUpper();
    AcString & makeLower();
    AcString & makeReverse();
    AcString & trimLeft( wchar_t );
    AcString & trimRight( wchar_t );
    AcString & trim( wchar_t );
    AcString & trimLeft();
    AcString & trimLeft( wchar_t const * );
    AcString & trimRight();
    AcString & trimRight( wchar_t const * );
    AcString & trim();
    AcString & trim( wchar_t const * );
    int remove( wchar_t );
    int remove();
    AcString spanExcluding( wchar_t const * ) const;
    int replace( wchar_t const *, wchar_t const * );
    int replace( wchar_t, wchar_t );
    int deleteAtIndex( int, int = 1 );
    AcString tokenize( wchar_t const *, int & ) const;
    AcString &setAt( int, wchar_t );
    wchar_t getAt( int ) const;
    AcString &insert( int, wchar_t );
    AcString &insert( int, wchar_t const * );
    wchar_t *getBuffer( int = 0 );
    bool releaseBuffer( int = -1 );
 
    wchar_t const *  kwszPtr( void )const;
 
    const TCHAR* constPtr() const;
    const TCHAR* kTCharPtr() const;
    const char *utf8Ptr() const;
 
    unsigned int capacity() const;
    bool reserve( unsigned int );
 
    bool operator == ( wchar_t ) const;
    bool operator == ( const wchar_t * ) const;
    bool operator==( const AcString & ) const;
    AcString & operator= ( char );
    AcString & operator= ( wchar_t );
    AcString & operator= ( char const * );
    AcString & operator= ( wchar_t const * );
    AcString & operator= ( AcString const & );
    AcString & operator= ( AcString && );
    AcString & operator= ( const AcDbHandle & );
    operator const wchar_t *( ) const;
    wchar_t const * kACharPtr() const;
    AcString & operator+= ( char );
    AcString & operator+= ( wchar_t );
    AcString & operator+= ( char const * );
    AcString & operator+= ( wchar_t const * );
    AcString & operator+= ( AcString const & );
    AcString operator + ( wchar_t ) const;
    AcString operator + ( const wchar_t* ) const;
    AcString operator + ( const AcString& ) const;
    bool operator != ( wchar_t ) const;
    bool operator != ( const wchar_t * ) const;
    bool operator != ( const AcString & ) const;
    bool operator >  ( wchar_t ) const;
    bool operator >  ( const wchar_t * ) const;
    bool operator >  ( const AcString & ) const;
    bool operator >= ( wchar_t ) const;
    bool operator >= ( const wchar_t * ) const;
    bool operator >= ( const AcString & ) const;
    bool operator <  ( wchar_t ) const;
    bool operator <  ( const wchar_t * ) const;
    bool operator <  ( const AcString & ) const;
    bool operator <= ( wchar_t ) const;
    bool operator <= ( const wchar_t * ) const;
    bool operator <= ( const AcString & ) const;
 
    static bool equalsNoCase( AcString const &, AcString const & );
 
protected:
    AcStringImpl *m_pImpl;
};
 
ARX_API bool operator == ( wchar_t, AcString const & );
ARX_API bool operator == ( wchar_t const *, AcString const & );
ARX_API bool operator != ( wchar_t, AcString const & );
ARX_API bool operator != ( wchar_t const *, AcString const & );
ARX_API bool operator >  ( wchar_t, AcString const & );
ARX_API bool operator >  ( wchar_t const *, AcString const & );
ARX_API bool operator >= ( wchar_t, AcString const & );
ARX_API bool operator >= ( wchar_t const *, AcString const & );
ARX_API bool operator <  ( wchar_t, AcString const & );
ARX_API bool operator <  ( wchar_t const *, AcString const & );
ARX_API bool operator <= ( wchar_t, AcString const & );
ARX_API bool operator <= ( wchar_t const *, AcString const & );
ARX_API AcString operator + ( wchar_t, AcString const & );
ARX_API AcString operator + ( wchar_t const *, AcString const & );
 
class ARX_API AcUniqueString
{
public:
    static const AcUniqueString* Intern( wchar_t const * );
};
 
typedef AcArray< AcString, AcArrayObjectCopyReallocator< AcString > > AcStringArray;