C++ Builder 参考手册 ➙ System::Sysutils ➙ ElementToCharIndex

字符串里面某个编码单元是字符串里面第几个字符的构成部分。

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

int __fastcall ElementToCharIndex(const System::AnsiString S, int Index);
int __fastcall ElementToCharIndex(const System::UnicodeString S, int Index);

参数：

• S：字符串；
• Index：编码单元索引，从 1 开始为第 1 个编码单元，UnicodeString 的编码单元为 char16_t (或 wchar_t)，AnsiString 的编码单元为 char，由于一个字符可能由1个或多个 char16_t 或 char 组成的，所以第 n 个 char16_t 或 char 不一定是第 n 个字符；

返回值：

• 第 Index 个编码单元 (char16_t 或 char) 是在字符串里面的第几个字符的构成部分，从 1 开始为第 1 个字符；
• 在 AnsiString 里面通常每个英文字符是一个 char，汉字是两个 char；在 UnicodeString 里面通常每个英文字符和常用汉字和符号是一个 char16_t，一些不常用的汉字和符号两个 char16_t。

例子：

• AnsiString 字符串 "Hello玄坴" 当中的第 6 和第 7 个 char 组成第 6 个字符 "玄"；
• AnsiString 字符串 "Hello玄坴" 当中的第 8 和第 9 个 char 组成第 7 个字符 "坴"；
• UnicodeString 字符串 L"土𪢴圭垚𡋣㙓" 当中第 2 和第 3 个 char16_t 组成第 2 个字符 "𪢴"；
• UnicodeString 字符串 L"土𪢴圭垚𡋣㙓" 当中第 6 和第 7 个 char16_t 组成第 5 个字符 "𡋣"；

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    AnsiString s = "Hello玄坴";
    Memo1->Lines->Add(s);
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,1));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,2));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,3));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,4));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,5));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,6));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,7));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,8));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,9));
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    UnicodeString s = L"土𪢴圭垚𡋣㙓";
    Memo1->Lines->Add(s);
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,1));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,2));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,3));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,4));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,5));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,6));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,7));
    Memo1->Lines->Add(Sysutils::ElementToCharIndex(s,8));
}

运行结果：

运行结果1

运行结果2

相关：

• System::Sysutils::CharToElementIndex
• System::Sysutils::CharToElementLen
• System::Sysutils::ElementToCharIndex
• System::Sysutils::ElementToCharLen
• System::Sysutils::BytesOf
• System::Sysutils::WideBytesOf
• System::Sysutils::PlatformBytesOf
• System::Sysutils::StringOf
• System::Sysutils::WideStringOf
• System::Sysutils::PlatformStringOf
• System::Sysutils::ByteLength
• System::Sysutils::CharLength
• System::Sysutils::StrCharLength
• System::Sysutils::AnsiLastChar
• System::Sysutils::AnsiStrLastChar
• System::Sysutils::AnsiPos
• System::Sysutils::AnsiStrPos
• System::Sysutils::AnsiStrScan
• System::Sysutils::AnsiStrRScan
• System::Sysutils
• std::mblen
• std::_mbstrlen
• <cstdlib>
• std::strlen, std::_fstrlen, std::_tcslen, std::wcslen
• <cstring>

C++ Builder 参考手册 ➙ System::Sysutils ➙ ElementToCharIndex