strncpy, strncpy_s

Parameter

Rückgabewert

Hinweise

Wie durch den post-C11 DR 468 korrigiert, strncpy_s , im Gegensatz zu strcpy_s , darf nur den restlichen Teil des Zielarrays überschreiben, wenn ein Fehler auftritt.

Im Gegensatz zu strncpy füllt strncpy_s das Zielarray nicht mit Nullen auf. Dies ist eine häufige Fehlerquelle bei der Portierung bestehenden Codes auf die grenzprüfende Version.

Obwohl das Abschneiden zur Anpassung an den Zielpuffer ein Sicherheitsrisiko darstellt und daher einen Verstoß gegen die Laufzeitbeschränkungen für strncpy_s darstellt, ist es möglich, das abschneidende Verhalten zu erreichen, indem count gleich der Größe des Zielarrays minus eins angegeben wird: Es kopiert die ersten count Bytes und fügt wie immer den Nullterminator an: strncpy_s ( dst, sizeof dst, src, ( sizeof dst ) - 1 ) ;

Beispiel

#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"; // kein Null-Terminator
    strncpy(dest, src, 5); // schreibt fünf Zeichen 'h', 'i', '\0', '\0', '\0' nach dest
    printf("strncpy(dest, src, 5) zu einem 6-Byte-Ziel ergibt: ");
    for (size_t n = 0; n < sizeof dest; ++n) {
        char c = dest[n];
        c ? printf("'%c' ", c) : printf("'\\0' ");
    }
    printf("\nstrncpy(dest2, src, 2) zu einem 2-Byte-Ziel ergibt: ");
    char dest2[2];
    strncpy(dest2, src, 2); // Trunkierung: schreibt zwei Zeichen 'h', 'i' nach 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);  // schreibt 0 nach r1, 6 Zeichen nach dst1
    printf("dst1 = \"%s\", r1 = %d\n", dst1,r1); // 'h','e','l','l','o','\0' nach dst1
    char dst2[5], src2[7] = {'g','o','o','d','b','y','e'};
    errno_t r2 = strncpy_s(dst2, 5, src2, 7);    // Kopieren überläuft das Zielarray
    printf("dst2 = \"%s\", r2 = %d\n", dst2,r2); // schreibt ungleich null nach r2, '\0' nach dst2[0]
    char dst3[5];
    errno_t r3 = strncpy_s(dst3, 5, src2, 4);    // schreibt 0 nach r3, 5 Zeichen nach dst3
    printf("dst3 = \"%s\", r3 = %d\n", dst3,r3); // 'g', 'o', 'o', 'd', '\0' nach dst3
#endif
}

strncpy(dest, src, 5) zu einem 6-Byte-Ziel ergibt: 'h' 'i' '\0' '\0' '\0' 'f'
strncpy(dest2, src, 2) zu einem 2-Byte-Ziel ergibt: 'h' 'i'
dst1 = "hello", r1 = 0
dst2 = "", r2 = 22
dst3 = "good", r3 = 0

Referenzen

Siehe auch