strncpy, strncpy_s

Paramètres

Valeur de retour

Notes

Comme corrigé par le DR 468 post-C11, strncpy_s , contrairement à strcpy_s , n'est autorisé à écraser la fin du tableau de destination qu'en cas d'erreur.

Contrairement à strncpy , strncpy_s ne remplit pas le tableau de destination avec des zéros. Ceci est une source fréquente d'erreurs lors de la conversion de code existant vers la version avec vérification des limites.

Bien que la troncature pour ajuster le tampon de destination soit un risque de sécurité et donc une violation des contraintes d'exécution pour strncpy_s , il est possible d'obtenir le comportement de troncature en spécifiant count égal à la taille du tableau de destination moins un : cela copiera les premiers count octets et ajoutera le terminateur nul comme toujours : strncpy_s ( dst, sizeof dst, src, ( sizeof dst ) - 1 ) ;

Exemple

#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"; // pas de terminateur nul
    strncpy(dest, src, 5); // écrit cinq caractères 'h', 'i', '\0', '\0', '\0' dans dest
    printf("strncpy(dest, src, 5) vers une dest de 6 octets donne : ");
    for (size_t n = 0; n < sizeof dest; ++n) {
        char c = dest[n];
        c ? printf("'%c' ", c) : printf("'\\0' ");
    }
    printf("\nstrncpy(dest2, src, 2) vers une dst de 2 octets donne : ");
    char dest2[2];
    strncpy(dest2, src, 2); // troncation : écrit deux caractères 'h', 'i' dans 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);  // écrit 0 dans r1, 6 caractères dans dst1
    printf("dst1 = \"%s\", r1 = %d\n", dst1,r1); // 'h','e','l','l','o','\0' dans dst1
    char dst2[5], src2[7] = {'g','o','o','d','b','y','e'};
    errno_t r2 = strncpy_s(dst2, 5, src2, 7);    // la copie dépasse la capacité du tableau de destination
    printf("dst2 = \"%s\", r2 = %d\n", dst2,r2); // écrit une valeur non nulle dans r2, '\0' dans dst2[0]
    char dst3[5];
    errno_t r3 = strncpy_s(dst3, 5, src2, 4);    // écrit 0 dans r3, 5 caractères dans dst3
    printf("dst3 = \"%s\", r3 = %d\n", dst3,r3); // 'g', 'o', 'o', 'd', '\0' dans dst3
#endif
}

strncpy(dest, src, 5) vers une dst de 6 octets donne : 'h' 'i' '\0' '\0' '\0' 'f'
strncpy(dest2, src, 2) vers une dst de 2 octets donne : 'h' 'i'
dst1 = "hello", r1 = 0
dst2 = "", r2 = 22
dst3 = "good", r3 = 0

Références

Voir aussi