version 1.37, 2001/07/10 06:43:27
|
version 1.39.2.6, 2001/08/22 08:11:08
|
|
|
*/ | */ |
Uint32 size() const { return _rep.size() - 1; } | Uint32 size() const { return _rep.size() - 1; } |
| |
/** Returns a pointer to the first character in the null-terminated string |
/** getData Returns a pointer to the first character in the |
string. |
null-terminated string string of the String object. |
@return Pointer to the first character of the String object | @return Pointer to the first character of the String object |
<pre> | <pre> |
String t1 = "abc"; | String t1 = "abc"; |
|
|
*/ | */ |
const Char16* getData() const { return _rep.getData(); } | const Char16* getData() const { return _rep.getData(); } |
| |
/** AallocateCString - llocates an 8 bit representation of this string. The |
/** AallocateCString - llocates an 8 bit representation of this String |
user is |
object. The user is responsible for freeing the result. If any |
responsible for freeing the result. If any characters are truncated, |
characters are truncated, a TruncatedCharacter exception is thrown. |
a TruncatedCharacter exception is thrown. This exception may |
This exception may be suppressed by passing true as the noThrow |
be suppressed by passing true as the noThrow argument. Extra |
argument. Extra characters may be allocated at the end of the |
characters may be allocated at the end of the new string by |
new string by passing a non-zero value to the extraBytes argument. |
passing a non-zero value to the extraBytes argument. |
|
@param extraBytes Defines the number of extra characters to be | @param extraBytes Defines the number of extra characters to be |
allocated at the end of the new string. Default is zero. | allocated at the end of the new string. Default is zero. |
|
|
@param noThrow If true, no exception will be thrown if characters | @param noThrow If true, no exception will be thrown if characters |
are truncated | are truncated |
|
|
@return pointer to the new representation of the string | @return pointer to the new representation of the string |
|
|
@exception Throws TruncatedCharacter exception if any characters are | @exception Throws TruncatedCharacter exception if any characters are |
truncated | truncated |
<pre> | <pre> |
|
|
*/ | */ |
char* allocateCString(Uint32 extraBytes = 0, Boolean noThrow = false) const; | char* allocateCString(Uint32 extraBytes = 0, Boolean noThrow = false) const; |
| |
/** appendToCString - Append the given string to a C-string. If the length |
/** appendToCString - Append the given String object to a C-string. If the |
is not PEG_NOT_FOUND, then the lesser of the the length argument and the |
length is not PEG_NOT_FOUND, then the lesser of the the length argument |
length of this string is truncated. Otherwise, the entire string is |
and he length of this string is truncated. Otherwise, the entire string |
trunctated. The TruncatedCharacter exception is thrown if any characters |
is trunctated. The TruncatedCharacter exception is thrown if any |
are truncated. |
characters are truncated. |
@param str Char pointer to the string to append | @param str Char pointer to the string to append |
@param length Length to append or PEG_NOT_FOUND (Uint32(-1) | @param length Length to append or PEG_NOT_FOUND (Uint32(-1) |
@param noThrow - If false, throw the "TruncatedCharacter" exception of | @param noThrow - If false, throw the "TruncatedCharacter" exception of |
|
|
*/ | */ |
Uint32 find(Char16 c) const; | Uint32 find(Char16 c) const; |
| |
|
/** Same as above but starts searching from the given position. */ |
|
Uint32 find(Uint32 pos, Char16 c) const; |
| |
/** Find the position of the first occurence of the string object. | /** Find the position of the first occurence of the string object. |
This function finds one string inside another | This function finds one string inside another |
|
|
*/ | */ |
void translate(Char16 fromChar, Char16 toChar); | void translate(Char16 fromChar, Char16 toChar); |
| |
|
/** Method for printing a string. |
|
*/ |
|
void print() const; |
|
|
/** Compare the first n characters of the two strings.. | /** Compare the first n characters of the two strings.. |
@param s1 First null-terminated string for the comparison. | @param s1 First null-terminated string for the comparison. |
@param s2 Second null-terminated string for the comparison. | @param s2 Second null-terminated string for the comparison. |
|
|
*/ | */ |
static int compareNoCase(const char* s1, const char* s2, Uint32 n); | static int compareNoCase(const char* s1, const char* s2, Uint32 n); |
| |
|
static int compareNoCase(const char* s1, const char* s2); |
|
|
/** Compare two null-terminated strings. | /** Compare two null-terminated strings. |
@param s1 First null-terminated string for the comparison. | @param s1 First null-terminated string for the comparison. |
@param s2 Second null-terminated string for the comparison. | @param s2 Second null-terminated string for the comparison. |
|
|
*/ | */ |
static const String EMPTY; | static const String EMPTY; |
| |
|
/** Return true if the str parameter matches the pattern. C-Shell style |
|
glob matching is used. |
|
*/ |
|
static Boolean match(const String& str, const String& pattern); |
|
|
|
/** Return true if the str parameter matches the pattern. C-Shell style |
|
glob matching is used. Ignore case in all comparisons. |
|
*/ |
|
static Boolean matchNoCase(const String& str, const String& pattern); |
|
|
private: | private: |
| |
static Uint32 _min(Uint32 x, Uint32 y) { return x < y ? x : y; } | static Uint32 _min(Uint32 x, Uint32 y) { return x < y ? x : y; } |
|
|
*/ | */ |
PEGASUS_COMMON_LINKAGE int CompareNoCase(const char* s1, const char* s2); | PEGASUS_COMMON_LINKAGE int CompareNoCase(const char* s1, const char* s2); |
| |
|
inline int EqualNoCase(const char* s1, const char* s2) |
|
{ |
|
return CompareNoCase(s1, s2) == 0; |
|
} |
|
|
/** Get the next line from the input file. | /** Get the next line from the input file. |
*/ | */ |
PEGASUS_COMMON_LINKAGE Boolean GetLine(PEGASUS_STD(istream)& is, String& line); | PEGASUS_COMMON_LINKAGE Boolean GetLine(PEGASUS_STD(istream)& is, String& line); |