C++ Builder 参考手册 ➙ System::Sysutils ➙ StrPos
获取一个字符串出现在另一个字符串中的位置
头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：
char *__fastcall StrPos(const char *Str, const char *SubStr);
System::WideChar *__fastcall StrPos(const System::WideChar *Str, const System::WideChar *SubStr);
参数：
- Substr：要获取 Substr 这个字符串出现在 Str 中的位置；
- Str：要获取 Substr 这个字符串出现在 Str 中的位置；
返回值：
- 如果字符串 Str 里面包含了字符串 Substr，返回的指针直接指向 Str 里面 Substr 所在的位置，如果要得到是第几个 WideChar，需要把返回值减去 Str 得到整数序号值，例如 L"玄坴" 在 L"你好玄坴！" 的第 2 个 WideChar 位置 (0:你，1:好，2:玄，3:坴，4:！)；
- 如果字符串 S 里面不包含字符串 Substr，返回值为 nullptr；
- 参数 Str 和 Substr 可以是空字符串 L""，但不可以是空指针 nullptr；
- UNICODE 版本的函数 AnsiStrPos 和 StrPos 是相同的，UNICODE 编码始终能够得到正确结果；
- ANSI 版本的函数，StrPos 不检查编码，只是按照每个 char 值是否相同，所以可能会找到半个汉字这样的错误，而 AnsiStrPos 就不会出现这样的错误；
- UNICODE 版本的函数为目前使用的函数，ANSI 版本的函数由于编码原因视为过时的函数。
例：
void __fastcall TForm1::Button1Click(TObject *Sender)
{
wchar_t *pStr = L"你好玄坴！";
wchar_t *pPos = Sysutils::StrPos(pStr,L"玄坴");
if(pPos)
{
Memo1->Lines->Add(pPos-pStr);
Memo1->Lines->Add(pPos);
}
else
{
Memo1->Lines->Add(L"没找到！");
}
}
执行结果：
- 第一行输出为 2，即 L"玄坴" 在 L"你好玄坴！" 的第 2 个 WideChar 位置 (0:你，1:好，2:玄，3:坴，4:！)；
- 第二行输出为 “玄坴！”，因为 AnsiStrPos 的返回值直接指向参数 pStr 内部找到的位置，所以输出时从找到位置到字符串结尾的内容都显示了出来 (遇到结束符时停止)，而不是只有第二个参数 (Substr) 的内容。
运行结果
相关：
- 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 ➙ StrPos
