strcpy, strcpy_s

char* strcpy( char* dest, const char* src );

char* strcpy( char* restrict dest, const char* restrict src );

errno_t strcpy_s( char* restrict dest, rsize_t destsz, const char* restrict src );

Paramètres

Valeur de retour

Notes

strcpy_s est autorisée à écraser le tableau de destination depuis le dernier caractère écrit jusqu'à destsz afin d'améliorer l'efficacité : elle peut copier par blocs multi-octets puis rechercher les octets nuls.

La fonction strcpy_s est similaire à la fonction BSD strlcpy, sauf que

• strlcpy tronque la chaîne source pour l'adapter à la destination (ce qui est un risque de sécurité)
• strlcpy n'effectue pas toutes les vérifications à l'exécution que strcpy_s effectue
• strlcpy ne rend pas les échecs évidents en définissant la destination sur une chaîne nulle ou en appelant un gestionnaire si l'appel échoue.

Bien que strcpy_s interdise la troncature en raison des risques potentiels de sécurité, il est possible de tronquer une chaîne en utilisant plutôt strncpy vérifié aux limites.

Exemple

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

int main(void)
{
    const char* src = "Take the test.";
//  src[0] = 'M' ; // this would be undefined behavior
    char dst[strlen(src) + 1]; // +1 to accommodate for the null terminator
    strcpy(dst, src);
    dst[0] = 'M'; // OK
    printf("src = %s\ndst = %s\n", src, dst);

#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s);
    int r = strcpy_s(dst, sizeof dst, src);
    printf("dst = \"%s\", r = %d\n", dst, r);
    r = strcpy_s(dst, sizeof dst, "Take even more tests.");
    printf("dst = \"%s\", r = %d\n", dst, r);
#endif
}

src = Take the test.
dst = Make the test.
dst = "Take the test.", r = 0
dst = "", r = 22

Références

Voir aussi