StrCharLength - C++ Builder

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

---

返回一个字符是多少个字节

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

int __fastcall StrCharLength(const char *Str);
int __fastcall StrCharLength(const System::WideChar *Str);

参数：

• Str：指向字符串中的字符；

返回值：

• Str 指向字符的字节数；
  • ANSI 版本：返回值为 1 或 2，一个字符 1 个或 2 个字节；
  • UNICODE 版本 (UTF-16 编码)：返回值为 2 或 4，一个字符 2 个或 4 个字节；

• ANSI 字符串 "Hello玄坴" 包含 7 个字符，其中 '玄' 和 '坴' 是 2 个字节的字符，其余的字符是 1 个字节的字符；
• UNICODE (UTF-16) 字符串 L"土圭垚㙓" 包含 6 个字符，其中 "土"、"圭"、"垚" 和 "㙓" 都是单个编码单元的字符 (2个字节)，"" 和 "" 是两个编码单元的字符 (4个字节)。

---

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    char s[] = "Hello玄坴";

    Memo1->Lines->Add(s);
    int n = std::strlen(s);
    for(int i=0; iLines->Add(String().sprintf(L"%d:%d", i, iCharLen));
        i += iCharLen;
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    wchar_t s[] = L"土圭垚㙓";

    Memo1->Lines->Add(s);
    int n = std::wcslen(s);
    for(int i=0; iLines->Add(String().sprintf(L"%d:%d", i, iCharLen));
        i += iCharLen/sizeof(wchar_t); // 字节数转字符个数
    }
}

运行结果：

点击 Button1 的运行结果

点击 Button2 的运行结果

---

相关：

• 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::StrNextChar
• System::Sysutils::NextCharIndex
• 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
• std::strlen, std::_fstrlen, std::_tcslen, std::wcslen

---

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