ElementToCharLen - C++ Builder

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


字符串里面前面 MaxLen 个编码单元包含多少个字符。

头文件:#include
命名空间:System::Sysutils
函数原型:

int __fastcall ElementToCharLen(const System::AnsiString S, int MaxLen);
int __fastcall ElementToCharLen(const System::UnicodeString S, int MaxLen);

参数:

  • S:字符串;
  • MaxLen:编码单元个数,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玄坴" 长度为 9,即包含 9 个编码单元,包含的字符个数是 7 个字符;
    • UnicodeString 字符串 L"Hello玄坴" 长度为 7,即包含 7 个编码单元,包含的字符个数是 7 个字符;
    • UnicodeString 字符串 L"土圭垚㙓" 长度为 8,即包含 8 个编码单元,包含的字符个数是 6 个字符。

例子:

  • 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);

    int n = s.Length();
    for(int i=1; i<=n; i++)
    {
        Memo1->Lines->Add(String().sprintf(L"%d:%d",i,Sysutils::ElementToCharLen(s,i)));
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    UnicodeString s = L"土圭垚㙓";
    Memo1->Lines->Add(s);

    int n = s.Length();
    for(int i=1; i<=n; i++)
    {
        Memo1->Lines->Add(String().sprintf(L"%d:%d",i,Sysutils::ElementToCharLen(s,i)));
    }
}

运行结果:

运行结果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
  • std::strlen, std::_fstrlen, std::_tcslen, std::wcslen

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

你可能感兴趣的:(ElementToCharLen - C++ Builder)