C++ Builder 參考手冊 ? System::Sysutils ? AnsiStrPos

獲取一個字符串出現(xiàn)在另一個字符串中的位置

頭文件：#include <System.SysUtils.hpp>
命名空間：System::Sysutils
函數(shù)原型：

char *__fastcall AnsiStrPos(char *Str, char *SubStr);
System::WideChar *__fastcall AnsiStrPos(System::WideChar *Str, System::WideChar *SubStr);

參數(shù)：

• Substr：要獲取 Substr 這個字符串出現(xiàn)在 Str 中的位置；
• Str：要獲取 Substr 這個字符串出現(xiàn)在 Str 中的位置；

返回值：

• 如果字符串 Str 里面包含了字符串 Substr，返回的指針直接指向 Str 里面 Substr 所在的位置，如果要得到是第幾個 WideChar，需要把返回值減去 Str 得到整數(shù)序號值，例如 L"玄坴" 在 L"你好玄坴！" 的第 2 個 WideChar 位置 (0:你，1:好，2:玄，3:坴，4:！)；
• 如果字符串 S 里面不包含字符串 Substr，返回值為 nullptr；
• 參數(shù) Str 和 Substr 可以是空字符串 L""，但不可以是空指針 nullptr；
• 雖然這個函數(shù)名以 Ansi 開頭，這個函數(shù)包含 ANSI 版本和 UNICODE 版本；
• UNICODE 版本的函數(shù) AnsiStrPos 和 StrPos 是相同的，UNICODE 編碼始終能夠得到正確結(jié)果；
• ANSI 版本的函數(shù)，StrPos 不檢查編碼，只是按照每個 char 值是否相同，所以可能會找到半個漢字這樣的錯誤，而 AnsiStrPos 就不會出現(xiàn)這樣的錯誤；
• UNICODE 版本的函數(shù)為目前使用的函數(shù)，ANSI 版本的函數(shù)由于編碼原因視為過時的函數(shù)。

例子：

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"沒找到！");
    }
}

執(zhí)行結(jié)果：

• 第一行輸出為 2，即 L"玄坴" 在 L"你好玄坴！" 的第 2 個 WideChar 位置 (0:你，1:好，2:玄，3:坴，4:！)；
• 第二行輸出為 “玄坴！”，因為 AnsiStrPos 的返回值直接指向參數(shù) pStr 內(nèi)部找到的位置，所以輸出時從找到位置到字符串結(jié)尾的內(nèi)容都顯示了出來 (遇到結(jié)束符時停止)，而不是只有第二個參數(shù) (Substr) 的內(nèi)容。

執(zhí)行結(jié)果

相關(guān)：

• 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