共用方式為

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 不會驗證其參數。 除此之外，這三個函式的行為相同。

重要

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

在 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