zip_file_rename |
ZIP : Renomme un fichier |
---|---|
libzip |
Syntaxe
int zip_file_rename(zip_t *archive, zip_uint64_t index, const char *name, zip_flags_t flags); |
Retour
En cas de réussite, 0 est renvoyé. Sinon, -1 est renvoyé et le code d'erreur dans l'archive est défini pour indiquer l'erreur.
Description
Cette fonction permet de renommer un fichier dans une archive ZIP.
Remarque
- Le fichier à la position index dans l'archive zip est renommé en nom. Le paramètre flags peut être l'un des suivants :
Constante | Description |
---|---|
ZIP_FL_ENC_GUESS | Deviner le codage du nom (par défaut). (Seuls CP-437 et UTF-8 sont reconnus.) |
ZIP_FL_ENC_UTF_8 | Interpréter le nom comme UTF-8. |
ZIP_FL_ENC_CP437 | Interpréter le nom comme page de code 437 (CP-437). |
Erreurs
zip_file_rename() échoue si :
Constante | Description |
---|---|
ZIP_ER_DELETED | Le fichier à renommer a été supprimé de l'archive. |
ZIP_ER_EXISTS | Il existe déjà un fichier appelé nom dans l'archive. |
ZIP_ER_INVAL | index n'est pas un index de fichier valide dans l'archive, le nom est NULL, la chaîne vide ou n'est pas une chaîne codée UTF-8 valide. De plus, un fichier ne peut pas être renommé en répertoire ou vice versa. Les répertoires sont indiqués par une barre oblique finale. |
Historique
zip_file_rename() a été ajouté dans libzip 0.11.
Voir également
libzip, zip_unchange
Dernière mise à jour : Mercredi, le 5 Février 2025