_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

아티클
06/09/2015

다른 문자열에는 없는 제공된 문자열에서 첫 번째 문자로 포인터를 반환합니다.

중요

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

char *_strspnp(
   const char *str,
   const char *charset
);
wchar_t *_wcsspnp(
   const unsigned wchar_t *str,
   const unsigned wchar_t *charset
);
unsigned char *_mbsspnp(
   const unsigned char *str,
   const unsigned char *charset
);
unsigned char *_mbsspnp_l(
   const unsigned char *str,
   const unsigned char *charset,
   _locale_t locale
);

매개 변수

str
검색할 Null 종료 문자열입니다.
charset
Null 종료 문자 집합입니다.
locale
사용할 로캘입니다.

반환 값

_strspnp, _wcsspnp, 및 _mbsspnp 의 첫 번째 문자에 대한 포인터를 반환합니다. 이는 str 은 문자 집합 charset*.이 속하지 않습니다. 이러한 각 함수는 NULL 을 반환합니다. str 은 charset.*에서 문자 구성을 포함할 경우입니다. 이러한 각각의 루틴에 대한 반환 값은 오류를 나타내기 위해 예약 되어 있지 않습니다.

설명

_mbsspnp 함수에서 첫 번째 문자는 멀티 바이트 문자에 대 한 포인터를 반환합니다. str 은 charset 문자집합에 속하지 않습니다. _mbsspnp 멀티 바이트 문자 시퀀스에 따라 인식된 멀티 바이트 코드 페이지 에서 현재 사용 중입니다. 검색은 종료되는 null 문자를 포함 하지 않습니다.

str 또는 charset 은 null 포인터입니다. 이 함수는 설명된 매개 변수 유효성 검사 로서 잘못된 매개변수 핸들러를 적용합니다. 계속해서 실행하도록 허용된 경우, 함수는 NULL 를 반환하고 errno 을 EINVAL으로 설정합니다.

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp 와 _wcsspnp 는 와이드 문자 및 _mbsspnp의 멀티 바이트 문자 버전입니다. _strspnp 및 _wcsspnp 은 _mbsspnp 에서 동일하게 작동됩니다. 반면에 ;이 매핑에 대해서만 제공하며 다른 이유로 사용할 수 없습니다. 자세한 내용은 제네릭 텍스트 매핑 사용 및 제네릭 텍스트 매핑 을 참조하십시오.

_mbsspnp_l는 전달된 로캘을 사용한다는 점을 제외하고 동일합니다. 자세한 내용은 로캘을 참조하십시오.

요구 사항

루틴	필수 헤더
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

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

예제

// crt_mbsspnp.c
#include <mbstring.h>
#include <stdio.h>

int main( void ) {
   const unsigned char string1[] = "cabbage";
   const unsigned char string2[] = "c";
   unsigned char *ptr = 0;
   ptr = _mbsspnp( string1, string2 );
   printf( "%s\n", ptr);
}