C++ Builder 参考手册 ➙ System::Sysutils ➙ StrScan
一个字符在字符串里面第一次出现的位置
头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：
char *__fastcall StrScan(const char *Str, char Chr);
System::WideChar *__fastcall StrScan(const System::WideChar *Str, System::WideChar Chr);
参数：
- Str：字符串，从这个字符串里面寻找一个字符；
- Chr：字符，从字符串里面寻找这个字符；
返回值：
- 如果字符串 Str 里面存在 Chr 字符，返回指向 Str 里面这个字符第一次出现的位置；
- 如果字符串 Str 里面不存在 Chr 字符，返回 nullptr；
- 如果字符串 Str 为空指针，函数无法正常运行；
- 如果字符串 Str 为空字符串 L""，只能找到字符串结束符 \0，其他字符找不到；
- 如果 Chr 为 0 就是字符串结束符，会找到 Str 字符串结束符的位置；
- UNICODE 版本的函数 AnsiStrScan 和 StrScan 是相同的，都能得到正确结果；
- ANSI 版本的函数 StrScan不检查编码，直接比较 Char 值，可能会找到半个汉字这样的错误，而 AnsiStrScan 就不会出现这样的错误；
- UNICODE 版本的函数为目前使用的函数，ANSI 版本的函数由于编码原因视为过时的函数。
例子：
把路径和文件名分解，输出每一级文件夹或文件名：
void __fastcall TForm1::Button1Click(TObject *Sender)
{
wchar_t S[] = L"C:\\Windows\\notepad.exe";
wchar_t *pStr = S;
while(pStr)
{
wchar_t *pPos = Sysutils::StrScan(pStr, L'\\');
if(pPos)
{
*pPos++ = 0; // 把找到的 '\\' 变成结束符，然后指向下一个字符
}
Memo1->Lines->Add(pStr);
pStr = pPos; // 从下一个字符开始查找 '\\'
}
}
执行结果：
由于这个例子利用把所有找到的 \ 改成 \0 即字符串结束符来输出每一段文字，所以执行之后，源字符串 S 被修改了。
运行结果
相关：
- System::Sysutils::AnsiPos
- System::Sysutils::AnsiStrPos
- System::Sysutils::StrPos
- System::Sysutils::TextPos
- System::Sysutils::StrScan
- System::Sysutils::StrRScan
- System::Sysutils::AnsiStrScan
- System::Sysutils::AnsiStrRScan
- System::Sysutils::AnsiLastChar
- System::Sysutils::AnsiStrLastChar
- System::Sysutils::NextCharIndex
- System::Sysutils::FindDelimiter
- System::Sysutils::IsDelimiter
- System::Sysutils::LastDelimiter
- 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 ➙ StrScan
