2.2.3.15 string


Name

string

Remark

An Origin C string is a null terminated array of characters similar to objects created using the MFC CString class. The Origin C string class includes many useful methods for manipulating strings (text data).

StringArray is type defined as a vector of strings in string.h
See the vector class for a StringArray example

Hierarchy

  • string

Examples

EX1

void string_ex1()
{
	string str = "  abcdefg   ";
	str.TrimRight();//Trim leading whitespace characters from the string
	
	str.TrimLeft();//Trim trailing whitespace characters from the string
	
	int nRet;
	nRet = str.Compare("abcdefg");//Compare the trimmed string with "abcdefg"
	out_int("", nRet); //Return 0 since they are identical
	
	str = str.Left(5); //Extract the leftmost 5 characters 
	
	str = str.Mid(1, 4); //Extract a substring of 4 characters from the 2nd character
	
	nRet = str.Compare("bcde");//Compare the extracted string with "abcdefg"
	out_int("", nRet); //Return 0 since they are identical
	
	nRet = str.Find('d');//Find the index of 'd' in the string 
	out_int("", nRet); //the index is 2(zero based)

}

Header to Include

origin.h

Reference

Members

Name Brief Example
Compare Perform a case-sensitive comparison of this string object with another string. Examples
CompareNoCase Perform a case-insensitive comparison of this string object with another string. Examples
Count Count number of occurances of specified character in string. Support wide characters Examples
Delete Delete a character or characters from a string starting with the character at nIndex. If nCount is longer than the string, the remainder of the string will be removed. Examples
Empty Make this string object an empty string (0 length) and free memory as appropriate. Examples
Find Search this string for the first match of a single character. Examples
FindOneOf Search this string for the first character that matches any character contained in lpszCharSet. Examples
FindToken Find a token in this string Examples
Format Format and store a series of characters and values in the string Examples
GetAt Return a single character specified by an index number. Examples
GetBuffer Retrieve a pointer to the internal character buffer for the string. Examples
GetBufferSetLength Retrieve a pointer to the internal character buffer for the string. Truncating or growing its length, if necessary, to exactly match the length specified in nNewLength. Examples
GetBytes Copy the charactors of this string into a byte vector Examples
GetLength Return the number of bytes (or number of characters) in this string object. The count does not include a null terminator. Examples
GetNumTokens Return the number of tokens in this string where a token is separated by the delimiter specified by chDelimiter. Examples
GetToken Return the token at nToken index in a string where a token is separated by the delimiter specified by chDelimiter. Examples
GetTokens Create a StringArray from this string, this process depend on code page, default is system code page,it can be changed by function set_code_page_for_string_process Examples
Insert Insert a character or substring at the given index within the string. Examples
IsEmpty Test a string object for the empty condition,check whether the string object contains any characters or not. Examples
IsFile Test to see whether the string is a valid full path file name or not. Examples
IsPath Test to see whether a string object is a valid path or not.The path should be exist. Examples
Left Extract the leftmost nCount characters from this string object and return a copy of the extracted substring.If nCount exceeds the string length,then the entire string is extracted. Examples
MakeLower Convert this string object to a lowercase string. Examples
MakeUpper Convert this string object to an uppercase string. Examples
MakeValidCName Modify a string to be a valid C identifier name. A valid C Identifier name must begin with a letter and can contain only letters, numbers, and underscore characters. Examples
Match String pattern matching, any number of wildchars are supported, which can be * or ?. Examples
Mid Extract a substring of length nCount characters from this string object, starting at position nFirst (zero-based). Examples
ReleaseBuffer Use ReleaseBuffer to end use of a buffer allocated by GetBuffer. Examples
Remove Remove instances of the input char from the string. Comparisons for the character are case-sensitive. Examples
Replace Replace a character with another. (Comparison is case-sensitive in all cases.) Examples
ReverseFind Search this string object for the last match of a character. Examples
Right Extract the rightmost nCount characters from this string object and returns a copy of the extracted substring.If nCount exceeds the string length,then the entire string is extracted. Examples
SetAt Overwrite a single character specified by an index number.SetAt will not enlarge the string if the index exceeds the bounds of the existing string. Examples
SetBytes Set the content of this string from a vector of bytes Examples
SetTokens Copy a StringArray into this string and separate them with specified delimiter Examples
SpanExcluding Search the string for the first occurrence of any character in the specified set lpszCharSet. Examples
SpanIncluding Extract characters from the string,starting with the first character,that are in the set of characters identified by lpszCharSet. Examples
string Default constructor, creates a new empty string object Examples
TrimLeft Trim leading whitespace characters from the string. It removes newline, space, and tab characters. Examples
TrimRight Trim trailing whitespace characters from the string. It removes trailing newline, space, and tab characters. Examples
Write Output the string. Examples
WriteLine Output the string adding return and newline characters automatically. Examples