CKTIS / C
strncat — concaténer avec une limite en octets source
strncat ajoute au plus n octets de la source à une chaîne et ajoute '\0'. Le paramètre n ne représente pas la capacité du tampon de destination.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat, de <string.h>, ajoute au plus n octets de s2 à s1, en s’arrêtant plus tôt à '\0'. La fonction remplace le terminateur existant et en ajoute un nouveau. Elle renvoie s1, et non une longueur ni une indication de troncature.
s1 doit pointer vers une chaîne modifiable terminée par un caractère nul. La source doit fournir n octets lisibles ou un terminateur rencontré plus tôt. Un espace insuffisant ou des zones qui se chevauchent pendant la copie entraînent un comportement indéfini.
n limite les données source, et non la taille du résultat. Ne vérifiez pas la capacité en calculant strlen(s1) + n + 1 sans contrôler les débordements : en arithmétique non signée, un débordement peut donner une valeur trop petite. Si capacity est la capacité du tampon de destination en octets et que strlen(s1) < capacity, alors n <= capacity - strlen(s1) - 1 garantit assez de place pour ajouter jusqu’à n octets et le nouveau terminateur. Pour un tableau dst correctement terminé, calculez l’espace restant ainsi : sizeof dst - strlen(dst) - 1 ; n’utilisez pas cette formule avec sizeof appliqué à un pointeur. Avec n == 0, la chaîne reste inchangée, mais les pointeurs doivent toujours être valides.
Exemples
#include <stdio.h>
#include <string.h>
int main(void)
{
char dst[10] = "Hi ";
const char src[] = "there!";
size_t room = sizeof dst - strlen(dst) - 1;
strncat(dst, src, room);
puts(dst);
return 0;
}
Résultat
Hi there!
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.