strstr, wcsstr, _mbsstr, _mbsstr_l

  • 아티클

문자열에서 처음 나오는 검색 문자열에 대한 포인터를 반환합니다.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsstr 및 _mbsstr_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 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
사용할 로캘입니다.

반환 값

첫 번째 발생 strSearch 에 대한 포인터를 반환하거나 NULL 에 str나타나지 않는 경우 strSearch 를 반환합니다str. strSearch가 길이가 0인 문자열을 가리키면 함수는 str을 반환합니다.

설명

strstr 함수는 str에서 처음 나오는 strSearch에 대한 포인터를 반환합니다. 검색에는 종료 null 문자가 포함되지 않습니다. wcsstr은 strstr의 와이드 문자 버전이고 _mbsstr은 멀티바이트 버전입니다. 인수 및 반환 값 wcsstr 은 와이드 문자열입니다. 인수 및 반환 값 _mbsstr 은 멀티바이트 문자열입니다. _mbsstr는 매개 변수의 유효성을 검사합니다. NULLstrSearch 이 경우 str 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용한 경우 _mbsstr은 errno를 EINVAL로 설정하고 0을 반환합니다. strstr 매개 wcsstr 변수의 유효성을 검사하지 않습니다. 그렇지 않으면 이들 세 함수는 동일하게 작동합니다.

Important

이러한 함수에서는 버퍼 오버런 문제로 인한 위협이 발생할 수 있습니다. 버퍼 오버런은 시스템 공격에 이용될 수 있습니다. 버퍼 오버런 문제가 발생하면 임의 코드를 실행할 수 있게 되어 보증하지 않은 방식으로 권한이 상승할 수 있기 때문입니다. 자세한 내용은 버퍼 오버런 방지를 참조 하세요.

C에서 이러한 함수는 첫 번째 인수에 대한 const 포인터를 갖습니다. C++에서는 두 오버로드를 모두 사용할 수 있습니다. const에 대한 포인터를 사용하는 오버로드는 const에 대한 포인터를 반환합니다. 비const에 대한 포인터를 사용하는 버전은 비const에 대한 포인터를 반환합니다. 이러한 함수의 const 버전과 비const 버전을 모두 사용할 수 있는 경우 매크로 _CRT_CONST_CORRECT_OVERLOADS 가 정의됩니다. 두 C++ 오버로드 모두에 대해 비 동작const 이 필요한 경우 기호 _CONST_RETURN를 정의합니다.

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

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

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

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

lazy found at position 36

참고 항목

문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
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