2.2.3.15.10 string::GetAtGetAt
Description
Return a single character specified by an index number.
Get a unicode character in the form of a string at specified position.
Syntax
char GetAt( int nIndex )
int GetAt( int nIndex, string & str )
Parameters
- nIndex
- [input] Zero-based index of the character in the string object. The nIndex parameter must be greater than or equal to 0 and less than the value returned by GetLength.
- nIndex
- [input] position in string, see Remark
- str
- [output] unicode character
Return
A char containing the character at the specified position in the string.
0 if index specified is invalid, 1 if character is ANSI, 2 if character is Unicode
Examples
EX1
void string_GetAt_ex1()
{
string str( "abcdef" );
char chRet = str.GetAt(2);
printf("%c\n", chRet);// print: c
}
EX2
void GetAt_ex2()
{
Worksheet wks;
wks.Create("origin");
vector<string> vs = {"qw", "er", "ty"};
wks.Columns(0).PutStringArray(vs);
for(int nRow = 0; nRow < 3; nRow++)
{
string str1 = wks.TCell(nRow, 0);
string str2;
str1.GetAt(1, str2);
wks.SetCell(nRow, 1, str2);
}
}
Remark
Index can be either byte offset, or character offset, dependent on the system variable @SCOC, which is typicalled controlled by the macro ENABLE_STR_LENGTH_USE_CHAR_COUNT
See Also
string::SetAt, string::GetLength
Header to Include
origin.h
|