STRCAT

Syntaxe

Paramètres

Retour

Description

Cette fonction permet la concaténation de chaînes de caractères.

Remarques

• La fonction strcat() ajoute la chaîne de caractères src à la chaîne de caractères dest, écrasant l'octet nul de fin ('\0') à la fin de dest, puis ajoute un octet nul de fin. Les chaînes ne peuvent pas se chevaucher et la chaîne de caractères dest doit avoir suffisamment d'espace pour le résultat. Si dest n'est pas assez grand, le comportement du programme est imprévisible; les dépassements de tampon sont un moyen préféré pour attaquer les programmes sécurisés.
• La fonction strncat() est similaire, sauf qu'elle utilisera au plus n octets de src; et src n'a pas besoin d'être terminé par null s'il contient n octets ou plus.
• Comme avec strcat(), la chaîne de caractères résultante dans dest est toujours terminée par un null.
• Si src contient n octets ou plus, strncat() écrit n+1 octets dans dest (n de src plus l'octet null de fin). Par conséquent, la taille de dest doit être au moins strlen(dest)+n+1.
• Une mise en oeuvre simple de la fonction strncat() pourrait être faite de la façon suivante :
1. char* strncat(char *dest, const char *src, size_t n) {
2.    size_t dest_len = strlen(dest), i;
3.    for(i = 0; i < n && src[i] != '\0'; i++) dest[dest_len+i] = src[i];
4.    dest[dest_len+i] = '\0';
5.    return dest;
6. }


• Certains systèmes d'exploitations (comme les BSD, Solaris et autres) offrent la fonction alternative suivante :

  size_t strlcat(char *dest, const char *src, size_t size);

  Cette fonction ajoute la chaîne de caractères src terminée par un null à la chaîne de caractères dest, copiant au plus size-strlen(dest)-1 à partir de src, et ajoute un terminateur null au résultat, sauf si la taille est inférieure à strlen(dest). Cette fonction corrige le problème de dépassement de tampon de strcat(), mais l'appelant doit toujours gérer la possibilité de perte de données si la taille est trop petite. La fonction renvoie la longueur de la chaîne de caractères que strlcat() a tenté de créer; si la valeur de retour est supérieure ou égale à size, une perte de données s'est produite. Si la perte de données est importante, l'appelant doit soit vérifier les paramètres avant l'appel, soit tester la valeur de retour de la fonction. La fonction strlcat() n'est pas présent dans la glibc et n'est pas normalisé par POSIX, mais est disponible sous Linux via la bibliothèque libbsd.

Exemple

Voici quelques exemples typiques de l'utilisation de cette fonction :

on obtiendra le résultat suivant :

Voir également

Langage de programmation - C - Référence procédures et fonctions - strcat