strncpy, strncpy_s

Параметры

Возвращаемое значение

Примечания

Как исправлено пост-C11 DR 468, strncpy_s , в отличие от strcpy_s , разрешено перезаписывать оставшуюся часть целевого массива только при возникновении ошибки.

В отличие от strncpy , strncpy_s не заполняет конечный массив нулями. Это распространённый источник ошибок при конвертации существующего кода в версию с проверкой границ.

Хотя усечение для соответствия целевому буферу представляет собой угрозу безопасности и, следовательно, нарушение ограничений времени выполнения для strncpy_s , можно получить поведение с усечением, указав count равным размеру целевого массива минус один: функция скопирует первые count байт и добавит нулевой терминатор как обычно: strncpy_s ( dst, sizeof dst, src, ( sizeof dst ) - 1 ) ;

Пример

#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
int main(void)
{
    char src[] = "hi";
    char dest[6] = "abcdef"; // нет нулевого терминатора
    strncpy(dest, src, 5); // записывает пять символов 'h', 'i', '\0', '\0', '\0' в dest
    printf("strncpy(dest, src, 5) для dest размером 6 байт дает: ");
    for (size_t n = 0; n < sizeof dest; ++n) {
        char c = dest[n];
        c ? printf("'%c' ", c) : printf("'\\0' ");
    }
    printf("\nstrncpy(dest2, src, 2) для dst размером 2 байта дает: ");
    char dest2[2];
    strncpy(dest2, src, 2); // усечение: записывает два символа 'h', 'i' в 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);  // записывает 0 в r1, 6 символов в dst1
    printf("dst1 = \"%s\", r1 = %d\n", dst1,r1); // 'h','e','l','l','o','\0' в dst1
    char dst2[5], src2[7] = {'g','o','o','d','b','y','e'};
    errno_t r2 = strncpy_s(dst2, 5, src2, 7);    // копирование переполняет массив назначения
    printf("dst2 = \"%s\", r2 = %d\n", dst2,r2); // записывает ненулевое значение в r2, '\0' в dst2[0]
    char dst3[5];
    errno_t r3 = strncpy_s(dst3, 5, src2, 4);    // записывает 0 в r3, 5 символов в dst3
    printf("dst3 = \"%s\", r3 = %d\n", dst3,r3); // 'g', 'o', 'o', 'd', '\0' в dst3
#endif
}

strncpy(dest, src, 5) для dst размером 6 байт дает: 'h' 'i' '\0' '\0' '\0' 'f'
strncpy(dest2, src, 2) для dst размером 2 байта дает: 'h' 'i'
dst1 = "hello", r1 = 0
dst2 = "", r2 = 22
dst3 = "good", r3 = 0

Ссылки

Смотрите также