SACLob

A subsidiary class to bind a SA_dtCLob parameter with SACommand << operator. More...

#include <SQLAPI.h>

Inherits SALongOrLob.

Additional Inherited Members

- Public Member Functions inherited from SAString
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...
 
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= (const char *lpsz)
 Copies string content from ANSI (multibyte) 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...
 
const SAStringoperator+= (const SAString &string)
 Concatenates from another SAString.
 
const SAStringoperator+= (SAChar ch)
 Concatenates a single character.
 
const SAStringoperator+= (const SAChar *lpsz)
 Concatenates from a SAChar string.
 
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...
 
void MakeUpper ()
 Converts the object to an uppercase.
 
void MakeLower ()
 Converts the object to an lowercases.
 
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 Delete (size_t nIndex, size_t nCount=1)
 Deletes a character or characters from a string. 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...
 
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 multibyte string, converts the data if needed. More...
 
size_t GetMultiByteCharsLength () const
 Returns the string length (in multibyte characters). More...
 
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.
 
 SAString ()
 
 SAString (const SAString &stringSrc)
 Copy constructor.
 
 SAString (SAChar ch, size_t nRepeat=1)
 Initializes SAString from a single character.
 
 SAString (const char *lpsz)
 Initializes SAString from an ANSI (multibyte) string.
 
 SAString (const wchar_t *lpsz)
 Initializes SAString from a UNICODE string (converts to SAChar)
 
 SAString (const char *lpch, size_t nLength)
 SA_UNICODE.
 
 SAString (const wchar_t *lpch, size_t nLength)
 Initializes SAString from subset of characters from a UNICODE string (converts to SAChar)
 
 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)
 
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...
 
size_t Insert (size_t nIndex, SAChar ch)
 Insert character at zero-based index; concatenates if index is past end of 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 Find (SAChar ch) const
 Find character starting at left, SIZE_MAX if not found. 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...
 

Detailed Description

A subsidiary class to bind a SA_dtCLob parameter with SACommand << operator.