strstr, wcsstr, _mbsstr_mbsstr_l

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

구문

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 변수의 유효성을 검사하지 않습니다. 그렇지 않으면 이들 세 함수는 동일하게 작동합니다.

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 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

요구 사항

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// 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