StrScan - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ StrScan

---

一个字符在字符串里面第一次出现的位置

头文件：#include
命名空间：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

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ StrScan