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
