_strspnp
, _wcsspnp
, _mbsspnp
_mbsspnp_l
지정된 다른 문자열에 없는 지정된 문자열의 첫 번째 문자에 대한 포인터를 반환합니다.
Important
Windows 런타임에서 실행되는 애플리케이션에서는 _mbsspnp
및 _mbsspnp_l
을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 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
, 의 문자 집합에 str
속하지 않는 첫 번째 문자charset
에 대한 포인터를 반환 _mbsspnp
합니다. 이러한 각 함수는 전적으로 .의 문자charset
로 구성된 경우 str
반환 NULL
됩니다. 각 이러한 루틴에 대해 오류를 나타내기 위한 반환 값은 예약되지 않습니다.
설명
함수는 _mbsspnp
문자 집합에 속하지 않는 첫 번째 문자인 멀티바이트 문자 str
charset
에 대한 포인터를 반환합니다. _mbsspnp
는 현재 사용 중인 멀티바이트 코드 페이지에 따라 멀티바이트 문자 시퀀스를 인식합니다. 검색에는 종료 null 문자가 포함되지 않습니다.
null 포인터이거나 str
charset
Null 포인터인 경우 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우 함수가 NULL
를 반환하며 errno
를 EINVAL
로 설정합니다.
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
일반 텍스트 루틴 매핑
Tchar.h 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
---|---|---|---|
_tcsspnp |
_strspnp |
_mbsspnp |
_wcsspnp |
_strspnp
및 _wcsspnp
는 _mbsspnp
의 싱글바이트 문자 및 와이드 문자 버전입니다. _strspnp
그렇지 않은 경우와 동일하게 _mbsspnp
동작합니다_wcsspnp
. 이 매핑에 대해서만 제공되므로 다른 이유로 사용하면 안 됩니다. 자세한 내용은 제네릭 텍스트 매핑 및 제네릭 텍스트 매핑 사용을 참조하세요.
_mbsspnp_l
은 전달된 로캘 매개 변수를 대신 사용한다는 점을 제외하면 동일합니다. 자세한 내용은 Locale을 참조하세요.
요구 사항
루틴에서 반환된 값 | 필수 헤더 |
---|---|
_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);
}
출력
abbage
참고 항목
문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
strspn
, wcsspn
, _mbsspn
_mbsspn_l
strncat_s
, _strncat_s_l
, wcsncat_s
, _wcsncat_s_l
, _mbsncat_s
_mbsncat_s_l
strncmp
, wcsncmp
, _mbsncmp
_mbsncmp_l
strncpy_s
, _strncpy_s_l
, wcsncpy_s
, _wcsncpy_s_l
, _mbsncpy_s
_mbsncpy_s_l
_strnicmp
, _wcsnicmp
, _mbsnicmp
, _strnicmp_l
, _wcsnicmp_l
_mbsnicmp_l
strrchr
, wcsrchr
, _mbsrchr
_mbsrchr_l