TextPos - C++ Builder

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