STRNCPY |
Copie les N caractères d'une chaîne |
---|---|
Langage C++ | cstring (string.h) |
Syntaxe
char *strncpy(const char *str1,const char *str2,size_t n) |
Paramètres
Nom | Description |
---|---|
dest | Ce paramètre permet d'indiquer la chaîne de caractères ASCIZ recevant le contenu. |
source | Ce paramètre permet d'indiquer la chaîne de caractères ASCIZ à copier dans str1. |
n | Ce paramètre permet d'indiquer le nombre de caractères à copier. |
Description
Cette fonction permet de copier les «n» premiers caractères de la chaîne de caractères «str1» à la chaîne de caractères «str2».
Remarques
- La fonction strncpy() est utilisée pour copier jusqu'au compteur les caractères de la chaîne de caractères pointée par le paramètre str2 dans la chaîne de caractères pointée par le paramètre str1. Le paramètre de chaîne de caractères str2 doit être un pointeur vers une chaîne de caractères terminée par null.
- Si les paramètres de chaîne de caractères str1 et str2 se chevauchent, le comportement de strncpy() est imprévisible.
- Si la chaîne de caractères pointée par le paramètre str2 a moins de nombre de caractères, les valeurs nulles seront ajoutées à la fin de str1 jusqu'à ce que le nombre de caractères ait été copié.
- Alternativement, si la chaîne de caractères pointée par str2 est plus longue que le nombre de caractères, la chaîne de caractères résultante pointée par le paramètre str1 ne se terminera pas par null.
- La fonction strncpy() renvoie un pointeur sur le paramètre de chaîne de caractères str1.
Voir également
Langage de programmation - C++ - Référence de procédures et fonctions - strcpy
Langage de programmation - C - Référence de procédures et fonctions - strncpy
Références
Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 734.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 262.
Dernière mise à jour : Lundi, le 3 août 2015