zip_file_set_dostime |
ZIP : Fixe l'heure DOS de fichier |
|---|---|
| libzip | |
Syntaxe
| int zip_file_set_dostime(zip_t *archive, zip_uint64_t index, zip_uint16_t dostime, zip_uint16_t dosdate, zip_flags_t flags); |
Retour
En cas de réussite, 0 est renvoyé. Sinon, -1 est renvoyé et les informations d'erreur dans l'archive sont définies pour indiquer l'erreur.
Description
Cette fonction permet de définir la date et l'heure de dernière modification d'un fichier dans l'archive ZIP en format DOS.
Remarques
- La fonction zip_file_set_mtime() définit l'heure de dernière modification (mtime) du fichier à la position index dans l'archive zip sur mtime. Actuellement, aucun support n'est implémenté pour les indicateurs.
- Dans l'archive zip, l'heure et la date sont enregistrées sous forme de deux entiers de 16 bits. Pour définir les valeurs directement, appelez la fonction zip_file_set_dostime(). Les valeurs des octets de temps sont définies comme suit :
- Conformément à la pratique historique, la fonction zip_file_set_mtime() traduit l'heure de l'archive zip dans le fuseau horaire local. Si vous souhaitez éviter cela, utilisez plutôt la fonction zip_file_set_dostime().
| Bits | Description |
|---|---|
| 0 à 4 | Secondes divisées par deux (1-2 = 1, 3-4 = 2, ...) |
| 5 à 10 | Minutes (0 à 59) |
| 11 à 15 | Heure (0 à 23) |
Les valeurs des octets de date sont définies comme suit :
| Bits | Description |
|---|---|
| 0 à 4 | Jour du mois (1 à31) |
| 5 à 8 | Mois (janvier = 1, février = 2, ...) |
| 9 à 15 | déplacement annuel par rapport à 1980 (1980 = 0, 1981 = 1, ...) |
Erreurs
zip_file_set_dostime() et zip_file_set_mtime() échouent si :
| Constante | Description |
|---|---|
| ZIP_ER_INVAL | index n'est pas un index de fichier valide dans l'archive. |
| ZIP_ER_MEMORY | La mémoire requise n'a pas pu être allouée. |
| ZIP_ER_OPNOTSUPP | Le cryptage PKWare traditionnel utilise le mtime du fichier, il ne peut donc pas être modifié sans recrypter les données. |
| ZIP_ER_RDONLY | L'archive a été ouverte en mode lecture seule. |
Historique
zip_file_set_mtime() a été ajouté dans libzip 1.0. zip_file_set_dostime() a été ajouté dans libzip 1.6.
Voir également
libzip(), zip_stat()
Dernière mise à jour : Mercredi, le 5 Février 2025