zip_file_extra_field_delete_by_id

Syntaxe

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 supprimer un champ supplémentaire spécifique d'un fichier ZIP en utilisant un identifiant.

Remarques

• La fonction zip_file_extra_field_delete() supprime le champ supplémentaire avec l'index extra_field_index pour le fichier à la position index dans l'archive zip.
• Si extra_field_index est ZIP_EXTRA_FIELD_ALL, alors tous les champs supplémentaires seront supprimés.

• Les indicateurs suivants sont pris en charge :

Constante	Description
ZIP_FL_CENTRAL	Supprime les champs supplémentaires du répertoire central de l'archive.
ZIP_FL_LOCAL	Supprime les champs supplémentaires des en-têtes de fichiers locaux.



• La fonction zip_file_extra_field_delete_by_id() supprime le champ supplémentaire avec l'ID (signature à deux octets) extra_field_id et l'index extra_field_index (en d'autres termes, le champ supplémentaire extra_field_index avec l'ID extra_field_id). Les autres arguments sont les mêmes que pour zip_file_extra_field_delete() (ZIP_EXTRA_FIELD_ALL supprimera tous les champs supplémentaires de l'ID spécifié).
• Veuillez noter qu'en raison de la conception de la bibliothèque, l'index d'un champ supplémentaire peut être différent entre les en-têtes du répertoire central et du fichier local. Pour cette raison, il n'est pas autorisé de spécifier à la fois ZIP_FL_CENTRAL et ZIP_FL_LOCAL dans les indicateurs, sauf lors de la suppression de tous les champs supplémentaires (c'est-à-dire, extra_field_index étant ZIP_EXTRA_FIELD_ALL).

Erreurs

zip_file_extra_field_delete() et zip_file_extra_field_delete_by_id() échouent si :

Historique

zip_file_extra_field_delete() et zip_file_extra_field_delete_by_id() ont été ajoutés dans libzip 0.11.

Voir également

libzip(), zip_file_extra_field_get(), zip_file_extra_field_set(), zip_file_extra_fields_count().