strstr、 wcsstr、 _mbsstr、 _mbsstr_l

發行項
03/27/2013

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

重要事項
_mbsstr 和 _mbsstr_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

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 和 _mbsstr 是 strstr 的寬字元和多位元組字元版本。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 。這些函式沒有以 _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>

如需更多相容性的資訊，請參閱相容性 (Compatibility)。

範例

// 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 );
}