Syntaxe
|
int rename(const char *anciennom,const char *nouveaunom);
|
Paramètres
| Nom |
Description |
| anciennom |
Ce paramètre permet d'indiquer l'ancien nom du fichier |
| nouveaunom |
Ce paramètre permet d'indiquer le nouveau nom du fichier |
Retour
| Valeur |
Description |
| 0 |
Cette valeur permet d'indiquer que l'opération a été un succès. |
| -1 |
Cette valeur permet d'indiquer qu'une erreur s'est produite et qu'il n'a pas été possible de renommer le fichier. Dans ce cas, il sera possible d'obtenir des informations supplémentaires en consultant la variable errno. |
Description
Cette fonction permet de renommer un fichier.
Remarques
- Cette fonction autorise uniquement des changements d'un répertoire à un autre répertoire sur le même disque ou dans le même répertoire, il ne supporte pas le déplacement d'une unité à l'autre, lors du renommage d'un fichier.
- Le déplacement d'un répertoire avec son contenu n'est pas supporté pas cette fonction.
- Les caractères génériques («*» et «?») ne sont pas supporté par cette fonction.
- Les codes d'erreurs retournés par la variable «errno» correspondent généralement à ceci :
| Constante |
Description |
| EACCES |
Cette constante permet d'indiquer les permissions sont insuffisante lors de la recherche d'un ou plusieurs des composantes du chemin. |
| ENOENT |
Cette constante permet d'indiquer qu'une composante du chemin n'existe pas ou que le chemin est une chaine de caractères vide. |
| ENOTSAM |
Cette constante permet d'indiquer que l'unité de disque est différente. |
Dernière mise à jour : Samedi, le 4 juillet 2015
