strncpy, strncpy_s
cppreference.net에서 가져옴
| 헤더 <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_MAXcount보다 큽니다가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 함수
참고 항목
|
(C11)
|
문자열을 다른 문자열로 복사
(함수) |
|
(C11)
|
버퍼를 다른 버퍼로 복사
(함수) |
|
(dynamic memory TR)
|
지정된 크기까지 문자열 사본을 할당
(함수) |
|
C++ documentation
for
strncpy
|
|