Namespaces
Variants

strncpy, strncpy_s

cppreference.net에서 가져옴
< c | string | byte
헤더 <string.h>
char* strncpy( char* dest, const char* src, size_t count );
에 정의됨 (1) (C99까지)
char* strncpy( char* restrict dest, const char* restrict src, size_t count );
(C99부터)
errno_t strncpy_s( char* restrict dest, rsize_t destsz,
                   const char* restrict src, rsize_t count );
(2) (C11부터)
1) count이 가리키는 문자 배열(종료 널 문자를 포함하되 널 문자 뒤에 오는 문자는 포함하지 않음)에서 최대 src 문자를 dest이 가리키는 문자 배열로 복사합니다.
전체 배열 count을 복사하기 전에 src에 도달하면 결과 문자 배열은 널 종료되지 않습니다.
src에서 종료 널 문자를 복사한 후에도 count에 도달하지 못하면, 총 dest 문자가 기록될 때까지 count에 추가 널 문자가 기록됩니다.
문자 배열이 겹치거나, dest 또는 src가 문자 배열에 대한 포인터가 아니거나(dest 또는 src가 널 포인터인 경우 포함), dest가 가리키는 배열의 크기가 count보다 작거나, src가 가리키는 배열의 크기가 count보다 작고 널 문자를 포함하지 않는 경우 동작은 정의되지 않습니다.
2) (1)과 동일하지만, 함수가 count까지 채우기 위해 대상 배열에 계속해서 0을 쓰지 않고 종료 널 문자를 기록한 후에 중단한다는 점이 다릅니다(소스에 널이 없으면 dest[count]에 널을 하나 기록하고 중단합니다). 또한 다음 오류는 런타임에 감지되어 현재 설치된 제약 조건 처리기 함수를 호출합니다:
  • src 또는 dest이 널 포인터입니다
  • destsz가 0이거나 RSIZE_MAX
  • count보다 큽니다가
  • countRSIZE_MAXdestsz보다 큽니다destsz이 strnlen_s(src, count)보다 크거나 같지만
  • 이
보다 작거나 같습니다. 즉, 잘림이 발생합니다dest < strnlen_s(src, destsz) <= destsz인 경우; 다시 말해, destsz의 잘못된 값이 임박한 버퍼 오버플로를 노출하지 않습니다. src < strnlen_s(src, count) < destsz이 가리키는 문자 배열의 크기가 count인 경우 동작은 정의되지 않습니다.
모든 경계 검사 함수와 마찬가지로, strncpy_s은 __STDC_LIB_EXT1__이 구현에 의해 정의되고 사용자가 __STDC_WANT_LIB_EXT1__string.h1을 포함하기 전에 <를 정수 상수 >로 정의하는 경우에만 보장됩니다.

매개변수

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

반환값

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

참고

C11 이후 DR 468에 의해 수정된 대로, strncpy_s는 오류가 발생한 경우에만 대상 배열의 나머지 부분을 덮어쓸 수 있다는 점에서 strcpy와 다릅니다.

strncpy과 달리 strncpy_s은 대상 배열을 0으로 채우지 않습니다. 이는 기존 코드를 경계 검사 버전으로 변환할 때 흔히 발생하는 오류의 원인입니다.

대상 버퍼에 맞추기 위한 잘림은 보안 위험이므로 strncpy_s의 런타임 제약 조건 위반이지만, count을 대상 배열 크기에서 1을 뺀 값으로 지정하면 잘림 동작을 얻을 수 있습니다. 이 경우 첫 번째 count바이트를 복사하고 항상 그렇듯이 널 종결자를 추가합니다: strncpy_s(dst, sizeof dst, src, (sizeof dst)-1);

예제

#define __STDC_WANT_LIB_EXT1__ 1
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(void)
{
    char src[] = "hi";
    char dest[6] = "abcdef"; // no null terminator
    strncpy(dest, src, 5); // writes five characters 'h', 'i', '\0', '\0', '\0' to dest
    printf("strncpy(dest, src, 5) to a 6-byte dest gives : ");
    for (size_t n = 0; n < sizeof dest; ++n) {
        char c = dest[n];
        c ? printf("'%c' ", c) : printf("'\\0' ");
    }

    printf("\nstrncpy(dest2, src, 2) to a 2-byte dst gives : ");
    char dest2[2];
    strncpy(dest2, src, 2); // truncation: writes two characters 'h', 'i', to dest2
    for (size_t n = 0; n < sizeof dest2; ++n) {
        char c = dest2[n];
        c ? printf("'%c' ", c) : printf("'\\0' ");
    }
    printf("\n");

#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s);
    char dst1[6], src1[100] = "hello";
    errno_t r1 = strncpy_s(dst1, 6, src1, 100);  // writes 0 to r1, 6 characters to dst1
    printf("dst1 = \"%s\", r1 = %d\n", dst1,r1); // 'h','e','l','l','o','\0' to dst1

    char dst2[5], src2[7] = {'g','o','o','d','b','y','e'};
    errno_t r2 = strncpy_s(dst2, 5, src2, 7);    // copy overflows the destination array
    printf("dst2 = \"%s\", r2 = %d\n", dst2,r2); // writes nonzero to r2,'\0' to dst2[0]

    char dst3[5];
    errno_t r3 = strncpy_s(dst3, 5, src2, 4);    // writes 0 to r3, 5 characters to dst3
    printf("dst3 = \"%s\", r3 = %d\n", dst3,r3); // 'g', 'o', 'o', 'd', '\0' to dst3
#endif
}

가능한 출력:

strncpy(dest, src, 5) to a 6-byte dst gives : 'h' 'i' '\0' '\0' '\0' 'f'
strncpy(dest2, src, 2) to a 2-byte dst gives : 'h' 'i'
dst1 = "hello", r1 = 0
dst2 = "", r2 = 22
dst3 = "good", r3 = 0

참조 자료

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.24.2.4 strncpy 함수 (p: TBD)
  • K.3.7.1.4 strncpy_s 함수 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.24.2.4 strncpy 함수 (p: 265)
  • K.3.7.1.4 strncpy_s 함수 (p: 447-448)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.24.2.4 strncpy 함수 (p: 363-364)
  • K.3.7.1.4 strncpy_s 함수 (p: 616-617)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.21.2.4 strncpy 함수 (p: 326-327)
  • C89/C90 표준 (ISO/IEC 9899:1990):
  • 4.11.2.4 strncpy 함수

참고 항목

문자열을 다른 문자열로 복사
(함수)
버퍼를 다른 버퍼로 복사
(함수)
(dynamic memory TR)
지정된 크기까지 문자열 사본을 할당
(함수)