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
사용할 로캘입니다.

반환 값

strSearch 이 str에 나타나지 않는다면 str 또는 NULL 에서 strSearch 에 첫 번째 항목에 대한 포인터를 반환합니다. 만약 strSearch 가 길이가 0 인 문자열을 반환한다면 함수는 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 버전을 모두 사용할 수 있는 경우 매크로 _CONST_CORRECT_OVERLOADS가 정의됩니다. 두 C++ 오버로드에 대한 비const 동작이 필요한 경우 기호 _CONST_RETURN을 정의합니다.

출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다; 자세한 내용은 setlocale, _wsetlocale을 참조하십시오. _l 접미사가 없는 이러한 함수 버전은 로캘 종속 동작에 현재 로캘을 사용하며, _l 접미사가 있는 버전은 전달된 로캘을 대신 사용하는 경우를 제외하고는 동일합니다. 자세한 내용은 로캘을 참조하십시오.

제네릭 텍스트 라우팅 매핑

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