C++ Builder 参考手册 ➙ System::Sysutils ➙ TextPos
获取一个字符串出现在另一个字符串中的位置,不区分大小写
头文件:#include <System.SysUtils.hpp>
命名空间:System::Sysutils
函数原型:
char *__fastcall TextPos(char *Str, char *SubStr);
System::WideChar *__fastcall TextPos(System::WideChar *Str, System::WideChar *SubStr);
参数:
- Str:要获取 Substr 这个字符串出现在 Str 中的位置;
- Substr:要获取 Substr 这个字符串出现在 Str 中的位置;
返回值:
- 如果字符串 Str 里面包含了字符串 Substr,返回的指针直接指向 Str 里面 Substr 所在的位置,英文字母不区分大小写,如果要得到是第几个 WideChar,需要把返回值减去 Str 得到整数序号值,例如 L"玄坴" 在 L"你好玄坴!" 的第 2 个 WideChar 位置 (0:你,1:好,2:玄,3:坴,4:!);
- 如果字符串 S 里面不包含字符串 Substr,返回值为 nullptr;
- 参数 Str 和 Substr 可以是空字符串 L"",但不可以是空指针 nullptr;
- 函数内部实现是通过 StrLower 把 Str 和 SubStr 转为小写,再用 StrPos 查找的位置;
- UNICODE 版本的 TextPos 始终能够得到正确结果;
- ANSI 版本的 TextPos 不检查编码,只是按照每个 char 值是否相同,所以可能会找到半个汉字这样的错误;
- UNICODE 版本的函数为目前使用的函数,ANSI 版本的函数由于编码原因视为过时的函数。
相关:
- System::Sysutils::AnsiPos
- System::Sysutils::AnsiStrPos
- System::Sysutils::StrPos
- System::Sysutils::TextPos
- System::Sysutils::StrScan
- System::Sysutils::StrRScan
- System::Sysutils::AnsiLastChar
- System::Sysutils::AnsiStrLastChar
- System::Sysutils::NextCharIndex
- System::Sysutils
- std::strstr, std::_fstrstr, std::_tcsstr, std::wcsstr
- std::strchr, std::_fstrchr, std::_tcschr, std::wcschr
- std::strrchr, std::_fstrrchr, std::_tcsrchr, std::wcsrchr
- std::_strspnp, std::_tcsspnp, std::_wcsspnp
- std::strcspn, std::_fstrcspn, std::_tcscspn, std::wcscspn
- std::strtok, std::_fstrtok, std::_tcstok, std::wcstok
- <cstring>
C++ Builder 参考手册 ➙ System::Sysutils ➙ TextPos