/*!**************************************************************************** @file PVRTString.h @copyright Copyright (c) Imagination Technologies Limited. @brief A string class that can be used as drop-in replacement for std::string on platforms/compilers that don't provide a full C++ standard library. ******************************************************************************/ #ifndef _PVRTSTRING_H_ #define _PVRTSTRING_H_ #include #define _USING_PVRTSTRING_ /*!*************************************************************************** @class CPVRTString @brief A string class *****************************************************************************/ #if defined(_WINDLL_EXPORT) class __declspec(dllexport) CPVRTString #elif defined(_WINDLL_IMPORT) class __declspec(dllimport) CPVRTString #else class CPVRTString #endif { private: // Checking printf and scanf format strings #if defined(_CC_GNU_) || defined(__GNUG__) || defined(__GNUC__) #define FX_PRINTF(fmt,arg) __attribute__((format(printf,fmt,arg))) #define FX_SCANF(fmt,arg) __attribute__((format(scanf,fmt,arg))) #else #define FX_PRINTF(fmt,arg) #define FX_SCANF(fmt,arg) #endif public: typedef size_t size_type; typedef char value_type; typedef char& reference; typedef const char& const_reference; static const size_type npos; /*!*********************************************************************** @brief CPVRTString constructor @param[in] _Ptr A string @param[in] _Count Length of _Ptr ************************************************************************/ CPVRTString(const char* _Ptr, size_t _Count = npos); /*!*********************************************************************** @brief CPVRTString constructor @param[in] _Right A string @param[in] _Roff Offset into _Right @param[in] _Count Number of chars from _Right to assign to the new string ************************************************************************/ CPVRTString(const CPVRTString& _Right, size_t _Roff = 0, size_t _Count = npos); /*!*********************************************************************** @brief CPVRTString constructor @param[in] _Count Length of new string @param[in] _Ch A char to fill it with *************************************************************************/ CPVRTString(size_t _Count, const char _Ch); /*!*********************************************************************** @brief Constructor @param[in] _Ch A char *************************************************************************/ CPVRTString(const char _Ch); /*!*********************************************************************** @brief Constructor ************************************************************************/ CPVRTString(); /*!*********************************************************************** @brief Destructor ************************************************************************/ virtual ~CPVRTString(); /*!*********************************************************************** @brief Appends a string @param[in] _Ptr A string @return Updated string *************************************************************************/ CPVRTString& append(const char* _Ptr); /*!*********************************************************************** @brief Appends a string of length _Count @param[in] _Ptr A string @param[in] _Count String length @return Updated string *************************************************************************/ CPVRTString& append(const char* _Ptr, size_t _Count); /*!*********************************************************************** @brief Appends a string @param[in] _Str A string @return Updated string *************************************************************************/ CPVRTString& append(const CPVRTString& _Str); /*!*********************************************************************** @brief Appends _Count letters of _Str from _Off in _Str @param[in] _Str A string @param[in] _Off A position in string @param[in] _Count Number of letters to append @return Updated string *************************************************************************/ CPVRTString& append(const CPVRTString& _Str, size_t _Off, size_t _Count); /*!*********************************************************************** @brief Appends _Ch _Count times @param[in] _Ch A char @param[in] _Count Number of times to append _Ch @return Updated string *************************************************************************/ CPVRTString& append(size_t _Count, const char _Ch); //template CPVRTString& append(InputIterator _First, InputIterator _Last); /*!*********************************************************************** @brief Assigns the string to the string _Ptr @param[in] _Ptr A string @return Updated string *************************************************************************/ CPVRTString& assign(const char* _Ptr); /*!*********************************************************************** @brief Assigns the string to the string _Ptr @param[in] _Ptr A string @param[in] _Count Length of _Ptr @return Updated string *************************************************************************/ CPVRTString& assign(const char* _Ptr, size_t _Count); /*!*********************************************************************** @brief Assigns the string to the string _Str @param[in] _Str A string @return Updated string *************************************************************************/ CPVRTString& assign(const CPVRTString& _Str); /*!*********************************************************************** @brief Assigns the string to _Count characters in string _Str starting at _Off @param[in] _Str A string @param[in] _Off First char to start assignment from @param[in] _Count Length of _Str @return Updated string *************************************************************************/ CPVRTString& assign(const CPVRTString& _Str, size_t _Off, size_t _Count=npos); /*!*********************************************************************** @brief Assigns the string to _Count copies of _Ch @param[in] _Ch A string @param[in] _Count Number of times to repeat _Ch @return Updated string *************************************************************************/ CPVRTString& assign(size_t _Count, char _Ch); //template CPVRTString& assign(InputIterator _First, InputIterator _Last); //const_reference at(size_t _Off) const; //reference at(size_t _Off); // const_iterator begin() const; // iterator begin(); /*!*********************************************************************** @brief Returns a const char* pointer of the string @return const char* pointer of the string *************************************************************************/ const char* c_str() const; /*!*********************************************************************** @brief Returns the size of the character array reserved @return The size of the character array reserved *************************************************************************/ size_t capacity() const; /*!*********************************************************************** @brief Clears the string *************************************************************************/ void clear(); /*!*********************************************************************** @brief Compares the string with _Str @param[in] _Str A string to compare with @return 0 if the strings match *************************************************************************/ int compare(const CPVRTString& _Str) const; /*!*********************************************************************** @brief Compares the string with _Str @param[in] _Pos1 Position to start comparing from @param[in] _Num1 Number of chars to compare @param[in] _Str A string to compare with @return 0 if the strings match *************************************************************************/ int compare(size_t _Pos1, size_t _Num1, const CPVRTString& _Str) const; /*!*********************************************************************** @brief Compares the string with _Str @param[in] _Pos1 Position to start comparing from @param[in] _Num1 Number of chars to compare @param[in] _Str A string to compare with @param[in] _Off Position in _Str to compare from @param[in] _Count Number of chars in _Str to compare with @return 0 if the strings match *************************************************************************/ int compare(size_t _Pos1, size_t _Num1, const CPVRTString& _Str, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Compares the string with _Ptr @param[in] _Ptr A string to compare with @return 0 if the strings match *************************************************************************/ int compare(const char* _Ptr) const; /*!*********************************************************************** @brief Compares the string with _Ptr @param[in] _Pos1 Position to start comparing from @param[in] _Num1 Number of chars to compare @param[in] _Ptr A string to compare with @return 0 if the strings match *************************************************************************/ int compare(size_t _Pos1, size_t _Num1, const char* _Ptr) const; /*!*********************************************************************** @brief Compares the string with _Str @param[in] _Pos1 Position to start comparing from @param[in] _Num1 Number of chars to compare @param[in] _Ptr A string to compare with @param[in] _Count Number of chars to compare @return 0 if the strings match *************************************************************************/ int compare(size_t _Pos1, size_t _Num1, const char* _Ptr, size_t _Count) const; /*!*********************************************************************** @brief Less than operator @param[in] _Str A string to compare with @return True on success *************************************************************************/ bool operator<(const CPVRTString & _Str) const; /*!*********************************************************************** @brief == Operator @param[in] _Str A string to compare with @return True if they match *************************************************************************/ bool operator==(const CPVRTString& _Str) const; /*!*********************************************************************** @brief == Operator @param[in] _Ptr A string to compare with @return True if they match *************************************************************************/ bool operator==(const char* const _Ptr) const; /*!*********************************************************************** @brief != Operator @param[in] _Str A string to compare with @return True if they don't match *************************************************************************/ bool operator!=(const CPVRTString& _Str) const; /*!*********************************************************************** @brief != Operator @param[in] _Ptr A string to compare with @return True if they don't match *************************************************************************/ bool operator!=(const char* const _Ptr) const; /*!*********************************************************************** @fn copy @param[in,out] _Ptr A string to copy to @param[in] _Count Size of _Ptr @param[in] _Off Position to start copying from @return Number of bytes copied @brief Copies the string to _Ptr *************************************************************************/ size_t copy(char* _Ptr, size_t _Count, size_t _Off = 0) const; /*!*********************************************************************** @fn data @return A const char* version of the string @brief Returns a const char* version of the string *************************************************************************/ const char* data( ) const; /*!*********************************************************************** @fn empty @return True if the string is empty @brief Returns true if the string is empty *************************************************************************/ bool empty() const; // const_iterator end() const; // iterator end(); //iterator erase(iterator _First, iterator _Last); //iterator erase(iterator _It); /*!*********************************************************************** @brief Erases a portion of the string @param[in] _Pos The position to start erasing from @param[in] _Count Number of chars to erase @return An updated string *************************************************************************/ CPVRTString& erase(size_t _Pos = 0, size_t _Count = npos); /*!*********************************************************************** @brief Erases a portion of the string @param[in] _src Character to search @param[in] _subDes Character to substitute for @param[in] _all Substitute all @return An updated string *************************************************************************/ CPVRTString& substitute(char _src,char _subDes, bool _all = true); /*!*********************************************************************** @brief Erases a portion of the string @param[in] _src Character to search @param[in] _subDes Character to substitute for @param[in] _all Substitute all @return An updated string *************************************************************************/ CPVRTString& substitute(const char* _src, const char* _subDes, bool _all = true); //size_t find(char _Ch, size_t _Off = 0) const; //size_t find(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Finds a substring within this string. @param[in] _Ptr String to search. @param[in] _Off Offset to search from. @param[in] _Count Number of characters in this string. @return Position of the first matched string. *************************************************************************/ size_t find(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Finds a substring within this string. @param[in] _Str String to search. @param[in] _Off Offset to search from. @return Position of the first matched string. *************************************************************************/ size_t find(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the first char that is not _Ch @param[in] _Ch A char @param[in] _Off Start position of the find @return Position of the first char that is not _Ch *************************************************************************/ size_t find_first_not_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the first char that is not in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @return Position of the first char that is not in _Ptr *************************************************************************/ size_t find_first_not_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the first char that is not in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Number of chars in _Ptr @return Position of the first char that is not in _Ptr *************************************************************************/ size_t find_first_not_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the position of the first char that is not in _Str @param[in] _Str A string @param[in] _Off Start position of the find @return Position of the first char that is not in _Str *************************************************************************/ size_t find_first_not_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the first char that is _Ch @param[in] _Ch A char @param[in] _Off Start position of the find @return Position of the first char that is _Ch *************************************************************************/ size_t find_first_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the first char that matches a char in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @return Position of the first char that matches a char in _Ptr *************************************************************************/ size_t find_first_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the first char that matches a char in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Size of _Ptr @return Position of the first char that matches a char in _Ptr *************************************************************************/ size_t find_first_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the position of the first char that matches all chars in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Size of _Ptr @return Position of the first char that matches a char in _Ptr *************************************************************************/ size_t find_first_ofn(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the position of the first char that matches a char in _Str @param[in] _Str A string @param[in] _Off Start position of the find @return Position of the first char that matches a char in _Str *************************************************************************/ size_t find_first_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the last char that is not _Ch @param[in] _Ch A char @param[in] _Off Start position of the find @return Position of the last char that is not _Ch *************************************************************************/ size_t find_last_not_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the last char that is not in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @return Position of the last char that is not in _Ptr *************************************************************************/ size_t find_last_not_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the last char that is not in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Length of _Ptr @return Position of the last char that is not in _Ptr *************************************************************************/ size_t find_last_not_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the position of the last char that is not in _Str @param[in] _Str A string @param[in] _Off Start position of the find @return Position of the last char that is not in _Str *************************************************************************/ size_t find_last_not_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the last char that is _Ch @param[in] _Ch A char @param[in] _Off Start position of the find @return Position of the last char that is _Ch *************************************************************************/ size_t find_last_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the last char that is in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @return Position of the last char that is in _Ptr *************************************************************************/ size_t find_last_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the position of the last char that is in _Ptr @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Length of _Ptr @return Position of the last char that is in _Ptr *************************************************************************/ size_t find_last_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the position of the last char that is in _Str @param[in] _Str A string @param[in] _Off Start position of the find @return Position of the last char that is in _Str *************************************************************************/ size_t find_last_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the number of occurances of _Ch in the parent string. @param[in] _Ch A char @param[in] _Off Start position of the find @return Number of occurances of _Ch in the parent string. *************************************************************************/ size_t find_number_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the number of occurances of _Ptr in the parent string. @param[in] _Ptr A string @param[in] _Off Start position of the find @return Number of occurances of _Ptr in the parent string. *************************************************************************/ size_t find_number_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the number of occurances of _Ptr in the parent string. @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Size of _Ptr @return Number of occurances of _Ptr in the parent string. *************************************************************************/ size_t find_number_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the number of occurances of _Str in the parent string. @param[in] _Str A string @param[in] _Off Start position of the find @return Number of occurances of _Str in the parent string. *************************************************************************/ size_t find_number_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the next occurance of _Ch in the parent string after or at _Off. If not found, returns the length of the string. @param[in] _Ch A char @param[in] _Off Start position of the find @return Next occurance of _Ch in the parent string. *************************************************************************/ int find_next_occurance_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the next occurance of _Ptr in the parent string after or at _Off. If not found, returns the length of the string. @param[in] _Ptr A string @param[in] _Off Start position of the find @return Next occurance of _Ptr in the parent string. *************************************************************************/ int find_next_occurance_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the next occurance of _Ptr in the parent string after or at _Off. If not found, returns the length of the string. @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Size of _Ptr @return Next occurance of _Ptr in the parent string. *************************************************************************/ int find_next_occurance_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the next occurance of _Str in the parent string after or at _Off. If not found, returns the length of the string. @param[in] _Str A string @param[in] _Off Start position of the find @return Next occurance of _Str in the parent string. *************************************************************************/ int find_next_occurance_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the previous occurance of _Ch in the parent string before _Off. If not found, returns -1. @param[in] _Ch A char @param[in] _Off Start position of the find @return Previous occurance of _Ch in the parent string. *************************************************************************/ int find_previous_occurance_of(char _Ch, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the previous occurance of _Ptr in the parent string before _Off. If not found, returns -1. @param[in] _Ptr A string @param[in] _Off Start position of the find @return Previous occurance of _Ptr in the parent string. *************************************************************************/ int find_previous_occurance_of(const char* _Ptr, size_t _Off = 0) const; /*!*********************************************************************** @brief Returns the previous occurance of _Ptr in the parent string before _Off. If not found, returns -1. @param[in] _Ptr A string @param[in] _Off Start position of the find @param[in] _Count Size of _Ptr @return Previous occurance of _Ptr in the parent string. *************************************************************************/ int find_previous_occurance_of(const char* _Ptr, size_t _Off, size_t _Count) const; /*!*********************************************************************** @brief Returns the previous occurance of _Str in the parent string before _Off. If not found, returns -1. @param[in] _Str A string @param[in] _Off Start position of the find @return Previous occurance of _Str in the parent string. *************************************************************************/ int find_previous_occurance_of(const CPVRTString& _Str, size_t _Off = 0) const; /*!*********************************************************************** @fn left @param[in] iSize number of characters to return (excluding null character) @return The leftmost 'iSize' characters of the string. @brief Returns the leftmost characters of the string (excluding the null character) in a new CPVRTString. If iSize is larger than the string, a copy of the original string is returned. *************************************************************************/ CPVRTString left(size_t iSize) const; /*!*********************************************************************** @fn right @param[in] iSize number of characters to return (excluding null character) @return The rightmost 'iSize' characters of the string. @brief Returns the rightmost characters of the string (excluding the null character) in a new CPVRTString. If iSize is larger than the string, a copy of the original string is returned. *************************************************************************/ CPVRTString right(size_t iSize) const; //allocator_type get_allocator( ) const; //CPVRTString& insert(size_t _P0, const char* _Ptr); //CPVRTString& insert(size_t _P0, const char* _Ptr, size_t _Count); //CPVRTString& insert(size_t _P0, const CPVRTString& _Str); //CPVRTString& insert(size_t _P0, const CPVRTString& _Str, size_t _Off, size_t _Count); //CPVRTString& insert(size_t _P0, size_t _Count, char _Ch); //iterator insert(iterator _It, char _Ch = char()); //template void insert(iterator _It, InputIterator _First, InputIterator _Last); //void insert(iterator _It, size_t _Count, char _Ch); /*!*********************************************************************** @fn length @return Length of the string @brief Returns the length of the string *************************************************************************/ size_t length() const; /*!*********************************************************************** @fn max_size @return The maximum number of chars that the string can contain @brief Returns the maximum number of chars that the string can contain *************************************************************************/ size_t max_size() const; /*!*********************************************************************** @fn push_back @param[in] _Ch A char to append @brief Appends _Ch to the string *************************************************************************/ void push_back(char _Ch); // const_reverse_iterator rbegin() const; // reverse_iterator rbegin(); // const_reverse_iterator rend() const; // reverse_iterator rend(); //CPVRTString& replace(size_t _Pos1, size_t _Num1, const char* _Ptr); //CPVRTString& replace(size_t _Pos1, size_t _Num1, const CPVRTString& _Str); //CPVRTString& replace(size_t _Pos1, size_t _Num1, const char* _Ptr, size_t _Num2); //CPVRTString& replace(size_t _Pos1, size_t _Num1, const CPVRTString& _Str, size_t _Pos2, size_t _Num2); //CPVRTString& replace(size_t _Pos1, size_t _Num1, size_t _Count, char _Ch); //CPVRTString& replace(iterator _First0, iterator _Last0, const char* _Ptr); //CPVRTString& replace(iterator _First0, iterator _Last0, const CPVRTString& _Str); //CPVRTString& replace(iterator _First0, iterator _Last0, const char* _Ptr, size_t _Num2); //CPVRTString& replace(iterator _First0, iterator _Last0, size_t _Num2, char _Ch); //template CPVRTString& replace(iterator _First0, iterator _Last0, InputIterator _First, InputIterator _Last); /*!*********************************************************************** @fn reserve @param[in] _Count Size of string to reserve @brief Reserves space for _Count number of chars *************************************************************************/ void reserve(size_t _Count = 0); /*!*********************************************************************** @fn resize @param[in] _Count Size of string to resize to @param[in] _Ch Character to use to fill any additional space @brief Resizes the string to _Count in length *************************************************************************/ void resize(size_t _Count, char _Ch = char()); //size_t rfind(char _Ch, size_t _Off = npos) const; //size_t rfind(const char* _Ptr, size_t _Off = npos) const; //size_t rfind(const char* _Ptr, size_t _Off = npos, size_t _Count) const; //size_t rfind(const CPVRTString& _Str, size_t _Off = npos) const; /*!*********************************************************************** @fn size @return Size of the string @brief Returns the size of the string *************************************************************************/ size_t size() const; /*!*********************************************************************** @fn substr @param[in] _Off Start of the substring @param[in] _Count Length of the substring @return A substring of the string @brief Returns the size of the string *************************************************************************/ CPVRTString substr(size_t _Off = 0, size_t _Count = npos) const; /*!*********************************************************************** @fn swap @param[in] _Str A string to swap with @brief Swaps the contents of the string with _Str *************************************************************************/ void swap(CPVRTString& _Str); /*!*********************************************************************** @fn toLower @return An updated string @brief Converts the string to lower case *************************************************************************/ CPVRTString& toLower(); /*!*********************************************************************** @fn toUpper @return An updated string @brief Converts the string to upper case *************************************************************************/ CPVRTString& toUpper(); /*!*********************************************************************** @fn format @param[in] pFormat A string containing the formating @return A formatted string @brief return the formatted string ************************************************************************/ CPVRTString format(const char *pFormat, ...); /*!*********************************************************************** @brief += Operator @param[in] _Ch A char @return An updated string *************************************************************************/ CPVRTString& operator+=(char _Ch); /*!*********************************************************************** @brief += Operator @param[in] _Ptr A string @return An updated string *************************************************************************/ CPVRTString& operator+=(const char* _Ptr); /*!*********************************************************************** @brief += Operator @param[in] _Right A string @return An updated string *************************************************************************/ CPVRTString& operator+=(const CPVRTString& _Right); /*!*********************************************************************** @brief = Operator @param[in] _Ch A char @return An updated string *************************************************************************/ CPVRTString& operator=(char _Ch); /*!*********************************************************************** @brief = Operator @param[in] _Ptr A string @return An updated string *************************************************************************/ CPVRTString& operator=(const char* _Ptr); /*!*********************************************************************** @brief = Operator @param[in] _Right A string @return An updated string *************************************************************************/ CPVRTString& operator=(const CPVRTString& _Right); /*!*********************************************************************** @brief [] Operator @param[in] _Off An index into the string @return A character *************************************************************************/ const_reference operator[](size_t _Off) const; /*!*********************************************************************** @brief [] Operator @param[in] _Off An index into the string @return A character *************************************************************************/ reference operator[](size_t _Off); /*!*********************************************************************** @brief + Operator @param[in] _Left A string @param[in] _Right A string @return An updated string *************************************************************************/ friend CPVRTString operator+ (const CPVRTString& _Left, const CPVRTString& _Right); /*!*********************************************************************** @brief + Operator @param[in] _Left A string @param[in] _Right A string @return An updated string *************************************************************************/ friend CPVRTString operator+ (const CPVRTString& _Left, const char* _Right); /*!*********************************************************************** @brief + Operator @param[in] _Left A string @param[in] _Right A string @return An updated string *************************************************************************/ friend CPVRTString operator+ (const CPVRTString& _Left, const char _Right); /*!*********************************************************************** @brief + Operator @param[in] _Left A string @param[in] _Right A string @return An updated string *************************************************************************/ friend CPVRTString operator+ (const char* _Left, const CPVRTString& _Right); /*!*********************************************************************** @brief + Operator @param[in] _Left A string @param[in] _Right A string @return An updated string *************************************************************************/ friend CPVRTString operator+ (const char _Left, const CPVRTString& _Right); protected: char* m_pString; size_t m_Size; size_t m_Capacity; }; /************************************************************************* * MISCELLANEOUS UTILITY FUNCTIONS *************************************************************************/ /*!*********************************************************************** @fn PVRTStringGetFileExtension @param[in] strFilePath A string @return Extension @brief Extracts the file extension from a file path. Returns an empty CPVRTString if no extension is found. ************************************************************************/ CPVRTString PVRTStringGetFileExtension(const CPVRTString& strFilePath); /*!*********************************************************************** @fn PVRTStringGetContainingDirectoryPath @param[in] strFilePath A string @return Directory @brief Extracts the directory portion from a file path. ************************************************************************/ CPVRTString PVRTStringGetContainingDirectoryPath(const CPVRTString& strFilePath); /*!*********************************************************************** @fn PVRTStringGetFileName @param[in] strFilePath A string @return FileName @brief Extracts the name and extension portion from a file path. ************************************************************************/ CPVRTString PVRTStringGetFileName(const CPVRTString& strFilePath); /*!*********************************************************************** @fn PVRTStringStripWhiteSpaceFromStartOf @param[in] strLine A string @return Result of the white space stripping @brief strips white space characters from the beginning of a CPVRTString. ************************************************************************/ CPVRTString PVRTStringStripWhiteSpaceFromStartOf(const CPVRTString& strLine); /*!*********************************************************************** @fn PVRTStringStripWhiteSpaceFromEndOf @param[in] strLine A string @return Result of the white space stripping @brief strips white space characters from the end of a CPVRTString. ************************************************************************/ CPVRTString PVRTStringStripWhiteSpaceFromEndOf(const CPVRTString& strLine); /*!*********************************************************************** @fn PVRTStringFromFormattedStr @param[in] pFormat A string containing the formating @return A formatted string @brief Creates a formatted string ************************************************************************/ CPVRTString PVRTStringFromFormattedStr(const char *pFormat, ...); #endif // _PVRTSTRING_H_ /***************************************************************************** End of file (PVRTString.h) *****************************************************************************/