C++ Builder 参考手册 ➙ System::Sysutils ➙ AnsiStrScan
一个字符在字符串里面第一次出现的位置
头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：
System::WideChar * __fastcall AnsiStrScan(System::WideChar * Str, System::WideChar Chr);
参数：
- Str：字符串，从这个字符串里面寻找一个字符；
- Chr：字符，从字符串里面寻找这个字符；
返回值：
- 如果字符串 Str 里面存在 Chr 字符，返回指向 Str 里面这个字符第一次出现的位置；
- 如果字符串 Str 里面不存在 Chr 字符，返回 nullptr；
- 如果字符串 Str 为空指针，函数无法正常运行；
- 如果字符串 Str 为空字符串 L""，只能找到字符串结束符 \0，其他字符找不到；
- 如果 Chr 为 0 就是字符串结束符，会找到 Str 字符串结束符的位置。
- 对于 UNICODE 版本的函数，AnsiStrScan 和 StrScan 是相同的。
例子：
把路径和文件名分解，输出每一级文件夹或文件名：
void __fastcall TForm1::Button1Click(TObject *Sender)
{
wchar_t S[] = L"C:\\Windows\\notepad.exe";
wchar_t *pStr = S;
while(pStr)
{
wchar_t *pPos = Sysutils::AnsiStrScan(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
- 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 ➙ AnsiStrScan
