strstr、wcsstr、_mbsstr、_mbsstr_l

發行項
06/09/2015

回傳指向字串中欲搜尋字串第一個出現位置之指標。

重要

_mbsstr 與_mbsstr_l不能用於Windows 執行階段中執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 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 中找到strSearch 則回傳 NULL 。如果 strSearch 指向長度為零的字串，函式會回傳 str 。

備註

strstr 函式傳回指向 str 裏第一個出現的 strSearch 的指標。搜尋不包含結束的 NULL 字元。 wcsstr 是 strstr 的寬字元版本，而 _mbsstr 則是多位元組字元版本 wcsstr 的引數和傳回值是寬字元字串，而 _mbsstr 的引數和傳回值則是多位元組字元字串。 _mbsstr 會驗證其參數。如果 str 或 strSearch 是 NULL，會調用無效參數的處理常式，如參數驗證中所述。如果允許繼續執行， _mbsstr 會設定 errno 為 EINVAL 並回傳 0 。 strstr 和 wcsstr 並不驗證它們的參數。這三個函式其餘部分的運作相同。

安全性提示
這些函式可能會造成緩衝區滿溢問題的威脅。緩衝區滿溢問題可用來攻擊系統，因為它們可以允許執行任意程式碼，這可能導致權限不必要的提升。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

在 C 裏，這些函式的第一個引數採用 const 的指標。在 C++ 裏，有兩個多載版本可供使用。一個接受 const 的指標的多載版本會回傳 const 的指標。另一個接受 const 的指標的版本則回傳非 const 的指標。如果 const 和非 const 的版本均可用，會定義巨集 _CONST_CORRECT_OVERLOADS 。如果您需要 C++ 兩個多載版本有非 const 的行為，請定義符號 _CONST_RETURN 。

輸出值會受到 LC_CTYPE 的區域類別設定影響。如需詳細資訊，請參閱 setlocale、_wsetlocale。這些沒有 _l 後綴的函式之版本會對區域相關的行為使用目前的地區設定；而以 _l 為後綴的版本則相同，但會使用傳入的區域參數設定。如需詳細資訊，請參閱地區設定。

一般文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcsstr	strstr	_mbsstr	wcsstr
N/A	N/A	_mbsstr_l	N/A

需求

常式	必要的標頭
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 );
}