SALongOrLob

A subsidiary class to bind a long or LOB parameter with SACommand << operator. More...

Inherits SAString.

Inherited by SABLob, SACLob, SALongBinary, and SALongChar.

Additional Inherited Members

- Public Member Functions inherited from SAString
 SAString ()
 Constructs an empty SAString. More...
 
 SAString (const SAString &stringSrc)
 Copy constructor.
 
 SAString (SAChar ch, size_t nRepeat)
 Initializes SAString from a single character.
 
 SAString (const char *lpsz)
 Initializes SAString from an ANSI (multibyte) string (converts to SAChar)
 
 SAString (const wchar_t *lpsz)
 Initializes SAString from an ANSI (multibyte) string.
 
 SAString (const char *lpch, size_t nLength)
 Initializes SAString from subset of characters from an ANSI (multibyte) string (converts to SAChar)
 
 SAString (const wchar_t *lpch, size_t nLength)
 SA_UNICODE.
 
 SAString (const unsigned char *psz)
 Initializes SAString from unsigned characters (converts to SAChar)
 
 SAString (const void *pBuffer, size_t nLengthInBytes)
 Special constructor for binary data (no conversion to SAChar)
 
size_t GetLength () const
 Returns the data length (in characters). More...
 
bool IsEmpty () const
 Tests whether a SAString object contains no characters. More...
 
void Empty ()
 Clears contents to empty. More...
 
 operator const SAChar * () const
 Directly accesses characters stored in a SAString object as a C-style string. More...
 
void MakeUpper ()
 Converts the object to uppercase.
 
void MakeLower ()
 Converts the object to lowercase.
 
const SAStringoperator= (const SAString &sSrc)
 Ref-counted copy from another SAString. More...
 
const SAStringoperator= (SAChar ch)
 Sets string content to single character. More...
 
const SAStringoperator= (char ch)
 Sets string content to single character. More...
 
const SAStringoperator= (const char *lpsz)
 Copies string content from ANSI (multi-byte) string (converts to SAChar) More...
 
const SAStringoperator= (const wchar_t *lpsz)
 Copies string content from UNICODE string (converts to SAChar) More...
 
const SAStringoperator= (const unsigned char *psz)
 Copies string content from unsigned chars. More...
 
int Compare (const SAChar *lpsz) const
 Compares two strings (case sensitive). More...
 
int CompareNoCase (const SAChar *lpsz) const
 Compares two strings (case insensitive). More...
 
int Collate (const SAChar *lpsz) const
 Compares two strings (case sensitive, uses locale-specific information). More...
 
SAString Mid (size_t nFirst) const
 Return all characters starting at zero-based nFirst. More...
 
SAString Mid (size_t nFirst, size_t nCount) const
 Return nCount characters starting at zero-based nFirst. More...
 
SAString Left (size_t nCount) const
 Extracts the left part of a string. More...
 
SAString Right (size_t nCount) const
 Extracts the right part of a string. More...
 
SAChar GetAt (size_t nPos) const
 Returns the character at the specified string position.
 
void TrimRight ()
 Removes whitespace starting from right edge. More...
 
void TrimLeft ()
 Removes whitespace starting from left side. More...
 
void TrimRight (SAChar chTarget)
 Removes continuous occurrences of chTarget starting from right. More...
 
void TrimRight (const SAChar *lpszTargets)
 Removes continuous occurrences of characters in passed string, starting from right. More...
 
void TrimLeft (SAChar chTarget)
 Removes continuous occurrences of chTarget starting from left. More...
 
void TrimLeft (const SAChar *lpszTargets)
 Removes continuous occurrences of characters in passed string, starting from left. More...
 
size_t Replace (const SAChar *lpszOld, const SAChar *lpszNew)
 Replaces indicated characters with other characters. More...
 
size_t Insert (size_t nIndex, SAChar ch)
 Inserts a single character or a substring at the given index within the string. More...
 
size_t Insert (size_t nIndex, const SAChar *pstr)
 Insert substring at zero-based index; concatenates if index is past end of string. More...
 
size_t Delete (size_t nIndex, size_t nCount=1)
 Deletes a character or characters from a string. More...
 
size_t Find (SAChar ch) const
 Finds a character or substring inside a larger string. More...
 
size_t Find (SAChar ch, size_t nStart) const
 Find character starting at zero-based index and going right. More...
 
size_t Find (const SAChar *lpszSub) const
 Finds first instance of substring. More...
 
size_t Find (const SAChar *lpszSub, size_t nStart) const
 Finds first instance of substring starting at zero-based index. More...
 
size_t ReverseFind (SAChar ch) const
 Finds a character inside a larger string; starts from the end. More...
 
size_t FindOneOf (const SAChar *lpszCharSet) const
 Finds the first matching character from a set. More...
 
void Format (const SAChar *lpszFormat,...)
 Printf-like formatting using passed string. More...
 
void FormatV (const SAChar *, va_list argList)
 Printf-like formatting using variable arguments parameter. More...
 
SACharGetBuffer (size_t nMinBufLength)
 Returns a pointer to the characters in the SAString. More...
 
void ReleaseBuffer (size_t nNewLength=SIZE_MAX)
 Releases control of the buffer returned by GetBuffer. More...
 
SACharLockBuffer ()
 Disables reference counting and protects the string in the buffer. More...
 
void UnlockBuffer ()
 Enables reference counting and releases the string in the buffer. More...
 
size_t GetBinaryLength () const
 Returns a count of the bytes in the binary data buffer. More...
 
 operator const void * () const
 Returns pointer to const binary data buffer. More...
 
const void * GetBinaryData () const
 Returns pointer to const binary data buffer. More...
 
void * GetBinaryBuffer (size_t nMinBufLengthInBytes)
 Gets pointer to modifiable binary data buffer. More...
 
void ReleaseBinaryBuffer (size_t nNewLengthInBytes)
 Releases control of the buffer returned by GetBinaryBuffer. More...
 
const wchar_t * GetWideChars () const
 Returns pointer to const Unicode string, converts the data if needed. More...
 
size_t GetWideCharsLength () const
 Returns the string length (in Unicode characters). More...
 
const char * GetMultiByteChars () const
 Return pointer to const multi-byte string, converts the data if needed. More...
 
size_t GetMultiByteCharsLength () const
 Returns the string length (in multi-byte characters). More...
 
const char * GetUTF8Chars () const
 Returns pointer to const UTF8 string.
 
size_t GetUTF8CharsLength () const
 Returns the string length (in UTF8 characters).
 
void SetUTF8Chars (const char *szSrc, size_t nSrcLen=SIZE_MAX)
 Assigns the UTF8 data into SAString object.
 
const void * GetUTF16Chars () const
 Returns pointer to const UTF16 string.
 
size_t GetUTF16CharsLength () const
 Returns the string length (in UTF16 characters).
 
void SetUTF16Chars (const void *szSrc, size_t nSrcLen=SIZE_MAX)
 Assigns the UTF16 data into SAString object.
 
const SAStringoperator+= (const SAString &string)
 Concatenates from another SAString.
 
const SAStringoperator+= (SAChar ch)
 Concatenates a single character.
 
const SAStringoperator+= (char ch)
 Concatenates an ANSI character after converting it to SAChar.
 
const SAStringoperator+= (const SAChar *lpsz)
 Concatenates from a SAChar string.
 

Detailed Description

A subsidiary class to bind a long or LOB parameter with SACommand << operator.