Namespaces
Variants

    wcsncpy, wcsncpy_s

    cppreference.net에서
     
    C
     
    문자열 라이브러리
     
    널 종료 와이드 문자열
     
    헤더 <wchar.h> 
    wchar_t* wcsncpy( wchar_t* dest, const wchar_t* src, size_t count );
    		에 정의됨 (1) (C95부터)
    (C99까지)    		 
    wchar_t* wcsncpy( wchar_t* restrict dest, const wchar_t* restrict src, size_t count );
    		(C99부터) 
    errno_t wcsncpy_s( wchar_t* restrict dest, rsize_t destsz,
                   const wchar_t* restrict src, rsize_t count);
    		(2) (C11부터)
    1) count로 지정된 와이드 문자열(종료 널 와이드 문자 포함)을 src가 가리키는 dest가 가리키는 와이드 문자 배열로 최대
    개의 와이드 문자를 복사합니다.countsrc의 전체 문자열이 복사되기 전에
    에 도달하면 결과 와이드 문자 배열은 널 종료되지 않습니다.src에서 종료 널 와이드 문자를 복사한 후 count에 도달하지 않으면 dest에 총 count개의 문자가 기록될 때까지 추가 널 와이드 문자가 기록됩니다.
    문자열이 겹치면 동작이 정의되지 않습니다.
    2) (1)과 동일하지만, 대상 배열에 count까지 채우기 위해 0을 계속 쓰지 않고, 종료 널 문자를 쓴 후 중단합니다(소스에 널이 없는 경우 dest[count]에 하나를 쓴 후 중단). 또한 다음 오류가 런타임에 감지되어 현재 설치된 제약 조건 처리기 함수를 호출합니다.
    • src 또는 dest이 널 포인터인 경우
    • destsz 또는 count이 0이거나 RSIZE_MAX / sizeof(wchar_t)
    • count보다 큰 경우destsz보다 크거나 같지만 destsz이 wcsnlen_s(src, count)보다 작거나 같은 경우, 즉 잘림이 발생하는 경우
    • 소스와 대상 문자열 사이에 중복이 발생하는 경우
    모든 경계 검사 함수와 마찬가지로 wcsncpy_s는 구현에서 __STDC_LIB_EXT1__를 정의하고 사용자가 __STDC_WANT_LIB_EXT1__wchar.h1를 포함하기 전에 <를 정수 상수 >로 정의한 경우에만 사용할 수 있습니다.

    매개변수

    dest - 복사할 와이드 문자 배열을 가리키는 포인터
    src - 복사할 와이드 문자열을 가리키는 포인터
    count - 복사할 최대 와이드 문자 수
    destsz - 대상 버퍼의 크기

    반환값

    1) dest
    의 복사본을 반환합니다2)L'\0' 성공 시 0을 반환하고, 오류 시 0이 아닌 값을 반환합니다. 또한 오류 시 dest[0]에 dest을 기록하고(destsz이 널 포인터이거나 RSIZE_MAX / sizeof(wchar_t)이 0이거나 더 큰 경우는 제외) 대상 배열의 나머지 부분을 지정되지 않은 값으로 덮어쓸 수 있습니다.

    참고

    일반적인 사용에서 count은 대상 배열의 요소 수입니다.

    대상 버퍼에 맞게 잘라내는 것은 보안 위험이므로 wcsncpy_s의 런타임 제약 조건 위반이지만, count을 대상 배열 크기에서 1을 뺀 값으로 지정하면 잘림 동작을 얻을 수 있습니다. 그러면 첫 번째 count개의 와이드 문자를 복사하고 항상 그렇듯 널 와이드 종결자를 추가합니다. 

    size_t count = sizeof dst / sizeof *dst;
wcsncpy_s(dst, count, src, count - 1);

    예제

    이 코드 실행
    #include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    const wchar_t src[] = L"わゐ";
    wchar_t dest[6] = {L'あ', L'い', L'う', L'え', L'お'};
 
    wcsncpy(dest, src, 4); // this will copy わゐ and repeat L'\0' two times
 
    puts("The contents of dest are: ");
    setlocale(LC_ALL, "en_US.utf8");

    const long dest_size = sizeof dest / sizeof *dest;
    for(wchar_t* p = dest; p - dest != dest_size; ++p) {
        *p ? printf("%lc ", *p)
           : printf("\\0 ");
    }
}

    가능한 출력: 

    The contents of dest are:
わ ゐ \0 \0 お \0

    참조

    • C23 표준 (ISO/IEC 9899:2024):
    • 7.31.4.2.2 wcsncpy 함수 (p: 438)
    • K.3.9.3.1.2 wcsncpy_s 함수 (p: 663-664)
    • C17 표준 (ISO/IEC 9899:2018):
    • 7.29.4.2.2 wcsncpy 함수 (p: 314)
    • K.3.9.2.1.2 wcsncpy_s 함수 (p: 464)
    • C11 표준 (ISO/IEC 9899:2011):
    • 7.29.4.2.2 wcsncpy 함수 (p: 431)
    • K.3.9.2.1.2 wcsncpy_s 함수 (p: 640-641)
    • C99 표준 (ISO/IEC 9899:1999):
    • 7.24.4.2.2 wcsncpy 함수 (p: 377)

    같이 보기

    (C95)(C11)
    		 하나의 와이드 문자열을 다른 문자열에 복사합니다
    (함수)
    (C95)(C11)
    		 겹치지 않는 두 배열 사이에 일정량의 와이드 문자를 복사합니다
    (함수)
    (C11)
    		 하나의 문자열에서 다른 문자열로 일정량의 문자를 복사합니다
    (함수)
    C++ 문서 for wcsncpy