strstr, wcsstr, _mbsstr, _mbsstr_l

  • 發行項

傳回字串中第一次出現的搜尋字串指標。

重要

在 Windows 執行階段中執行的應用程式中無法使用 _mbsstr 和 _mbsstr_l。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。

語法

char *strstr(
   const char *str,
   const char *strSearch
); // C only
char *strstr(
   char *str,
   const char *strSearch
); // C++ only
const char *strstr(
   const char *str,
   const char *strSearch
); // C++ only
wchar_t *wcsstr(
   const wchar_t *str,
   const wchar_t *strSearch
); // C only
wchar_t *wcsstr(
   wchar_t *str,
   const wchar_t *strSearch
); // C++ only
const wchar_t *wcsstr(
   const wchar_t *str,
   const wchar_t *strSearch
); // C++ only
unsigned char *_mbsstr(
   const unsigned char *str,
   const unsigned char *strSearch
); // C only
unsigned char *_mbsstr(
   unsigned char *str,
   const unsigned char *strSearch
); // C++ only
const unsigned char *_mbsstr(
   const unsigned char *str,
   const unsigned char *strSearch
); // C++ only
unsigned char *_mbsstr_l(
   const unsigned char *str,
   const unsigned char *strSearch,
   _locale_t locale
); // C only
unsigned char *_mbsstr_l(
   unsigned char *str,
   const unsigned char *strSearch,
   _locale_t locale
); // C++ only
const unsigned char *_mbsstr_l(
   const unsigned char *str,
   const unsigned char *strSearch,
   _locale_t locale
); // C++ only

參數

str
以 Null 終止的待搜尋字串。

strSearch
以 Null 終止的待搜尋字串。

locale
要使用的地區設定。

傳回值

傳回 中 str 第一次出現的 strSearch 指標，如果 中未出現 str ，則 NULLstrSearch 傳回 。 如果 strSearch 指向長度為零的字串，函式會傳回 str。

備註

strstr 函式傳回 str 中第一個出現的 strSearch 指標。 搜尋不包含終止 Null 字元。 wcsstr 為 strstr 的寬字元版本，而 _mbsstr 則為多位元組字元版本。 的引數和傳回值 wcsstr 是寬字元字串。 的引數和傳回值 _mbsstr 是多位元組字元字串。 _mbsstr 會驗證其參數。 如果 str 或 strSearch 為 NULL ，則會叫用不正確參數處理常式，如參數驗證 中所述 。 若允許繼續執行，_mbsstr 會將 errno 設為 EINVAL 並傳回 0。 strstr 和 wcsstr 不會驗證其參數。 除此之外，這三個函式的行為相同。

重要

這些函式可能帶來因緩衝區滿溢問題引發的威脅。 緩衝區滿溢問題可用來攻擊系統，因為它們允許執行任意程式碼，這會造成非預期的提高權限。 如需詳細資訊，請參閱 避免緩衝區滿溢 。

在 C 中，這些函式接受第一個引數的 const 指標。 在 C++ 中，可使用兩個多載。 接受 const 指標的多載會傳回 const 的指標，接受非 const 指標的版本會傳回非 const 的指標。 如果這些函式的 const 和 非 const 版本都可用，則會定義宏 _CRT_CONST_CORRECT_OVERLOADS 。 如果您需要這兩個 C++ 多載的非 const 行為，請定義 符號 _CONST_RETURN 。

輸出值會受到 的地區設定 LC_CTYPE 影響;如需詳細資訊，請參閱 。 _wsetlocalesetlocale 沒有 _l 尾碼的這些函式版本會針對此地區設定相依行為使用目前的地區設定;具有 _l 尾碼的版本完全相同，不同之處在于它們改用傳入的地區設定參數。 如需詳細資訊，請參閱 Locale。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

泛型文字常式對應

TCHAR.H 常規 _UNICODE 和 _MBCS 未定義 _MBCS 定義 _UNICODE 定義
_tcsstr strstr _mbsstr wcsstr
不適用 不適用 _mbsstr_l 不適用

需求

常式 必要的標頭
strstr <string.h>
wcsstr <string.h> 或 <wchar.h>
_mbsstr, _mbsstr_l <mbstring.h>

如需相容性的詳細資訊，請參閱 相容性。

範例

// crt_strstr.c

#include <string.h>
#include <stdio.h>

char str[] =    "lazy";
char string[] = "The quick brown dog jumps over the lazy fox";
char fmt1[] =   "         1         2         3         4         5";
char fmt2[] =   "12345678901234567890123456789012345678901234567890";

int main( void )
{
   char *pdest;
   int  result;
   printf( "String to be searched:\n   %s\n", string );
   printf( "   %s\n   %s\n\n", fmt1, fmt2 );
   pdest = strstr( string, str );
   result = (int)(pdest - string + 1);
   if ( pdest != NULL )
      printf( "%s found at position %d\n", str, result );
   else
      printf( "%s not found\n", str );
}

String to be searched:
   The quick brown dog jumps over the lazy fox
            1         2         3         4         5
   12345678901234567890123456789012345678901234567890

lazy found at position 36

另請參閱

字串操作
地區設定
多位元組字元序列的解譯
strcspn, wcscspn, _mbscspn, _mbscspn_l
strcmp, wcscmp, _mbscmp
strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
strspn, wcsspn, _mbsspn, _mbsspn_l
basic_string::find