StrByteType - C++ Builder

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

字符串里面某个编码单元的类型

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

TMbcsByteType __fastcall StrByteType(char * Str, unsigned Index);
TMbcsByteType __fastcall StrByteType(System::WideChar * Str, unsigned Index);

参数：

Str：字符串；
Index：编码单元序号，通过测试发现与「帮助」里面的说明不同：
char * 版本的 Index 从 0 开始到 n-1 (假定字符串长度为 n)；
wchar_t * 版本的 Index 从 1 开始到 n (假定字符串长度为 n)；
测试程序为本文后面的例子；

返回值：

字符串 Str 里面第 Index 个 char 或 char16_t (或 wchar_t) 的类型：
• mbSingleByte 单个编码单元的字符；
• mbLeadByte 两个编码单元的字符当中前面一个编码单元；
• mbTrailByte 两个编码单元的字符当中后面一个编码单元；

AnsiString 字符串英文字母和符号 1 个字节，是单个编码单元的字符 mbSingleByte ，汉字 2 个字节，是两个编码单元的字符，前面一个字符是 mbLeadByte，后面一个字符是 mbTrailByte；
UnicodeString 字符串英文字符、常用的汉字等，是 1 个 char16_t (或 wchar_t)，是单个编码单元的字符 mbSingleByte，不常用的汉字、表情符号等，是 2 个 char16_t (或 wchar_t)，是两个编码单元的字符，前面一个 char16_t 是 mbLeadByte，后面一个 char16_t 是 mbTrailByte。

函数 StrByteType 和 ByteType 的功能相同，不同点为：
• 函数 StrByteType 的 Str 参数类型为字符指针，Index 从 0 (char * 版本) 或 1 (wchar_t * 版本) 开始；
• 函数 ByteType 的 S 参数类型为字符串类，Index 从 1 开始。

例子：通过这个例子测试发现与「帮助」里面的说明不同：
char * 版本的 Index 从 0 开始到 n-1 (假定字符串长度为 n)；
wchar_t * 版本的 Index 从 1 开始到 n (假定字符串长度为 n)；

template<class T>
UnicodeString EnumToString(T t)
{
    return Typinfo::GetEnumName(__delphirtti(T), (int)t);
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button1Click(TObject *Sender)
{
    char s[] = "Hello玄坴";
    Memo1->Lines->Add(s);

    int n = std::strlen(s);
    for(int i=0; i<n; i++) // char * 版本：从 0 到 n-1
    {
        Memo1->Lines->Add(IntToStr(i) + L": " + EnumToString(Sysutils::StrByteType(s,i)));
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    wchar_t s[] = L"土𪢴圭垚𡋣㙓";
    Memo1->Lines->Add(s);

    int n = std::wcslen(s);
    for(int i=1; i<=n; i++) // wchar_t * 版本：从 1 到 n
    {
        Memo1->Lines->Add(IntToStr(i) + L": " + EnumToString(Sysutils::StrByteType(s,i)));
    }
}

运行结果：

点击 Button1 的运行结果

点击 Button2 的运行结果

StrByteType - C++ Builder

推荐阅读更多精彩内容