C++ Builder 参考手册 ➙ System::Sysutils ➙ AnsiStrLIComp
比较两个字符串前面 MaxLen 个 WideChar,使用当前的地区和语言,不区分大小写。
头文件:#include <System.SysUtils.hpp>
命名空间:System::Sysutils
函数原型:
int __fastcall AnsiStrLIComp(System::WideChar * S1, System::WideChar * S2, unsigned MaxLen);
参数:
- S1: 要比较的字符串1,System::WideChar 类型;
- S2: 要比较的字符串2,System::WideChar 类型;
- MaxLen:比较的 WideChar 个数,这个函数并不管 \0 结束符在哪里,\0 和普通字符一样对待,不作为结束比较的条件,如果字符串长度不够 MaxLen 个 WideChar,这个函数会穿过 \0 继续比较,一直到 MaxLen 个 System::WideChar 结束
返回值:
- 0: S1==S2
- >0: S1>S2
- <0: S1<S2
- 比较两个字符串,使用当前的地区和语言,不区分大小写,不限于英语,例如 "āωπ" 和 "ĀΩΠ" 是相等的;
- 汉字比较大小,也是和地区相关的,中国大陆默认排序按照汉语拼音对应的英语字母顺序排列的,而中国的港澳台地区默认按照汉字的笔画数顺序排列的,例如:
• 大陆:"玄" > "坴",因为按照汉语拼音 "xuan" > "lu" 这样比较的;
• 港澳台:"玄" < "坴",因为按照汉字笔画数 5 < 8 这样比较的;
如果读音或笔画数相等,不同的汉字也是不等的,具体怎样比较大小不在本文叙述范围之内; - 这个函数的执行规则和 AnsiCompareText 是相同的,区别是这个函数只比较前面 MaxLen 个 WideChar;
- 这个函数的参数都是 System::WideChar 类型的了,虽然函数名以 Ansi 开头,实际上是 UNICODE (UTF-16) 编码。参数为 char 或 AnsiString 类型的函数都移到 System.AnsiStrings.hpp 这个头文件里面了,参数为 char 或 AnsiString 类型的函数都看作过时的函数,不建议使用了;
- 问题1:使用这个函数 Borland 编译器会出现使用过时了的函数的警告 (属于误报),即使参数是 System::WideChar * (或 wchar_t *) 类型,而 clang 32 和 clang 64 编译器在使用 System::WideChar * (或 wchar_t *) 类型的参数不会有警告;
- 问题2:AnsiStrLIComp 会穿过 \0 结束符继续比较, 直到 MaxLen 个 WideChar 结束;函数 std::_wcsnicmp 和 std::_lwcsnicoll 遇到 \0 结束符会结束比较,但是需要用 std::_wsetlocale 指定地区和语言,不是使用当前的地区和语言。
相关:
- System::Sysutils::AnsiSameStr
- System::Sysutils::AnsiSameText
- System::Sysutils::AnsiCompareStr
- System::Sysutils::AnsiCompareFileName
- System::Sysutils::AnsiCompareText
- System::Sysutils::AnsiStrComp
- System::Sysutils::AnsiStrIComp
- System::Sysutils::AnsiStrLComp
- System::Sysutils::AnsiStrLIComp
- System::Sysutils::CompareMem
- System::Sysutils::CompareStr
- System::Sysutils::CompareText
- System::Sysutils::StrComp
- System::Sysutils::StrIComp
- System::Sysutils::StrLComp
- System::Sysutils::StrLIComp
- System::Sysutils::WideCompareStr
- System::Sysutils::WideCompareText
- System::Sysutils
- strcmp, _strcmp, _fstrcmp, _tcscmp, wcscmp
- strncmp, _fstrncmp, _tcsncmp, _tcsnccmp, wcsncmp
- stricmp, _stricmp, _fstricmp, strcmpi, _strcmpi, _tcsicmp, _tcscmpi, _wcsicmp, wcscmpi, _wcscmpi
- strnicmp, _strnicmp, _fstrnicmp, strncmpi, _tcsnicmp, _tcsncicmp, _tcsncmpi, _wcsnicmp, wcsncmpi, _wcsncmpi
- <cstring>
C++ Builder 参考手册 ➙ System::Sysutils ➙ AnsiStrLIComp