ByteToCharLen - C++ Builder

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

字符串里面前面 MaxLen 个编码单元包含多少个字符，过时的函数，需要用 ElementToCharLen 代替

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

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

参数：

• S：字符串；
• MaxLen：编码单元个数，UnicodeString 的编码单元为 char16_t (或 wchar_t)，AnsiString 的编码单元为 char，由于一个字符可能由1个或多个 char16_t 或 char 组成的，所以 n 个 char16_t 或 char 可能少于 n 个字符；

返回值：

• 字符串前面 MaxLen 个编码单元包含的字符个数；
• 过时的函数，需要用 ElementToCharLen 代替；
• 函数内部只是简单的调用 ElementToCharLen，所以和 ElementToCharLen 是相同的。

• AnsiString 字符串 "Hello玄坴" 长度为 9，即包含 9 个编码单元，包含的字符个数是 7 个字符；
• UnicodeString 字符串 L"Hello玄坴" 长度为 7，即包含 7 个编码单元，包含的字符个数是 7 个字符；
• UnicodeString 字符串 L"土𪢴圭垚𡋣㙓" 长度为 8，即包含 8 个编码单元，包含的字符个数是 6 个字符。

相关：

• System::Sysutils::ByteToCharIndex
• 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::CharToElementIndex
• System::Sysutils::CharToElementLen
• System::Sysutils::ElementToCharIndex
• System::Sysutils::ElementToCharLen
• System::Sysutils
• std::mblen
• std::_mbstrlen
• <cstdlib>
• std::strlen, std::_fstrlen, std::_tcslen, std::wcslen
• <cstring>

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