AnsiStrPos - C++ Builder

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

---

获取一个字符串出现在另一个字符串中的位置

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

char *__fastcall AnsiStrPos(char *Str, char *SubStr);
System::WideChar *__fastcall AnsiStrPos(System::WideChar *Str, 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；
• 虽然这个函数名以 Ansi 开头，这个函数包含 ANSI 版本和 UNICODE 版本；
• UNICODE 版本的函数 AnsiStrPos 和 StrPos 是相同的，UNICODE 编码始终能够得到正确结果；
• ANSI 版本的函数，StrPos 不检查编码，只是按照每个 char 值是否相同，所以可能会找到半个汉字这样的错误，而 AnsiStrPos 就不会出现这样的错误；
• UNICODE 版本的函数为目前使用的函数，ANSI 版本的函数由于编码原因视为过时的函数。

---

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    wchar_t *pStr = L"你好玄坴！";
    wchar_t *pPos = Sysutils::AnsiStrPos(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::AnsiStrScan
• System::Sysutils::AnsiStrRScan
• 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 ➙ AnsiStrPos