strchr, wcschr, _mbschr, _mbschr_l

아티클
06/09/2015

현재 로캘 또는 지정한 LC_CTYPE 변환 상태 범주를 사용 하 여 문자열의 문자를 찾습니다.

중요

_mbschr 와 _mbschr_l 는 Windows 런타임에서 실행되는 어플리케이션에서는 사용될 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.

char *strchr(
   const char *str,
   int c 
);  // C only
char *strchr(
   char * str,
   int c 
); // C++ only
const char *strchr(
   const char * str,
   int c 
); // C++ only
wchar_t *wcschr(
   const wchar_t *str,
   wchar_t c 
); // C only
wchar_t *wcschr(
   wchar_t *str,
   wchar_t c 
);  // C++ only
const wchar_t *wcschr(
   const wchar_t *str,
   wchar_t c 
);  // C++ only
unsigned char *_mbschr(
   const unsigned char *str,
   unsigned int c 
); // C only
unsigned char *_mbschr(
   unsigned char *str,
   unsigned int c 
); // C++ only
const unsigned char *_mbschr(
   const unsigned char *str,
   unsigned int c 
); // C++ only
unsigned char *_mbschr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C only 
unsigned char *_mbschr_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only
const unsigned char *_mbschr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only

매개 변수

str
Null 종료 소스 문자열입니다.
c
쓰여질 문자입니다.
locale
사용할 로캘입니다.

반환 값

첫 번째 항목에 대 한 포인터를 반환 각이 함수 c 에서 str, 또는 NULL 경우 c 찾을 수 없습니다.

설명

strchr 함수의 첫 번째 항목을 찾습니다. c 에서 str, 반환 또는 NULL 경우 c 찾을 수 없습니다. Null 종료 문자는 검색에 포함 됩니다.

wcschr , _mbschr 및 _mbschr_l 은 와이드 문자이고 strchr.의 멀티 바이트 문자 버전입니다. wcschr의 인수 및 반환 값은 와이드 문자열이며, _mbschr는 멀티바이트 문자열입니다. _mbschr 멀티 바이트 문자 시퀀스를 인식합니다. 이 _mbschr 이 null 포인터인 경우 매개 변수 유효성 검사에 설명된 대로 함수는 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, _mbschr 은 NULL 를 반환하고, errno 에 EINVAL를 설정합니다. strchr 와 wcschr 는 매개 변수를 확인하지 않습니다. 그렇지 않으면 이들 세 함수는 동일하게 작동합니다.

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

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

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tcschr	strchr	_mbschr	wcschr
N/A	해당 없음	_mbschr_l	해당 없음

요구 사항

루틴	필수 헤더
strchr	<string.h>
wcschr	<string.h> 또는 <wchar.h>
_mbschr, _mbschr_l	<mbstring.h>

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

예제

// crt_strchr.c
// 
// This program illustrates searching for a character
// with strchr (search forward) or strrchr (search backward).
//

#include <string.h>
#include <stdio.h>

int  ch = 'r';

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_s( "String to be searched:\n      %s\n", string );
   printf_s( "      %s\n      %s\n\n", fmt1, fmt2 );
   printf_s( "Search char:   %c\n", ch );

   // Search forward. 
   pdest = strchr( string, ch );
   result = (int)(pdest - string + 1);
   if ( pdest != NULL )
      printf_s( "Result:   first %c found at position %d\n", 
              ch, result );
   else
      printf_s( "Result:   %c not found\n", ch );

   // Search backward. 
   pdest = strrchr( string, ch );
   result = (int)(pdest - string + 1);
   if ( pdest != NULL )
      printf_s( "Result:   last %c found at position %d\n", ch, result );
   else
      printf_s( "Result:\t%c not found\n", ch );
}