_strninc, _wcsninc, _mbsninc, _mbsninc_l

문자열 포인터 를 n 자로 진행합니다.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsninc 및 _mbsninc_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

char *_strninc(
   const char *str,
   size_t count
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);

매개 변수

str
소스 문자열입니다.

count
문자열 포인터를 증분하는 문자 수입니다.

locale
사용할 로캘입니다.

반환 값

이러한 각 루틴은 str이 count자 증가하고 나면 str에 대한 포인터를 반환하며, 제공된 포인터가 NULL이면 NULL을 반환합니다. count가 str에 있는 문자 수보다 크거나 같으면 결과는 정의되지 않습니다.

설명

_mbsninc 함수는 str을 count개의 멀티바이트 문자만큼 증가시킵니다. _mbsninc는 현재 사용 중인 멀티바이트 코드 페이지에 따라 멀티바이트 문자 시퀀스를 인식합니다.

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

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc_wcsninc 은 싱글 바이트 문자열 및 와이드 문자열 버전입니다_mbsninc. _wcsninc_strninc 이 매핑에 대해서만 제공되며, 그렇지 않으면 사용하면 안 됩니다. 자세한 내용은 제네릭 텍스트 매핑 및 제네릭 텍스트 매핑 사용을 참조하세요.

_mbsninc_l은 전달된 로캘 매개 변수를 대신 사용한다는 점을 제외하면 동일합니다. 자세한 내용은 Locale을 참조하세요.

요구 사항

루틴에서 반환된 값	필수 헤더
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

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

참고 항목

문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l