zipOuvre (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives

Codes d'erreur
Cas particulier de l'extension .GZ

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

zipOuvre (Fonction)

En anglais : zipOpen

Ouvre une archive existante.

Pour les archives au format "CAB" ou "RAR", si l'archive n'existe pas, elle est créée.

L'archive peut être :

au format standard Winzip ou PKZip (extension .ZIP).
au format WINDEV (extension .WDZ).
au format Cabinet file (extension .CAB).
au format RAR (extension .RAR).
au format 7z (extension .7z).
au format TAR (extension .TAR).
au format TGZ (extension .TGZ).
au format TAR.GZ (extension .TAR.GZ).
Nouveauté SaaS
au format gzip (extension ;gz).
un exécutable (.EXE) correspondant à un fichier .WDZ transformé en archive auto-extractible.

Nouveauté SaaS

Le format gzip (extension .gz) est désormais géré.

Exemple

Voir des exemples supplémentaires

MonArchive est une zipArchive
// Ouverture d'une archive
ResOuvreArchive = zipOuvre(MonArchive, "C:\MesArchives\Archive.zip")

// Affichage du message d'erreur si l'archive n'a pas été ouverte
SI ResOuvreArchive <> 0 ALORS
	Erreur(zipMsgErreur(ResOuvreArchive))
FIN

Syntaxe

<Résultat> = zipOuvre(<Archive> , <Chemin de l'archive> [, <Mode d'ouverture>])

<Résultat> : Entier

0 si l'archive a été ouverte,
Un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Chaîne de caractères ou variable de type zipArchive

Nom de l'archive à manipuler.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
soit au nom d'une variable de type zipArchive.
Si l'archive n'existe pas, elle est créée (sauf pour les formats "CAB" ou "RAR").

<Chemin de l'archive> : Chaîne de caractères

Chemin et nom de l'archive (260 caractères maximum). L'extension de l'archive peut être précisée. Si l'extension de l'archive n'est pas précisée, l'extension par défaut sera .WDZ.

<Mode d'ouverture> : Constante optionnelle ou combinaison de constantes

Mode d'ouverture de l'archive :
zipCréationSiInexistant Création de l'archive si l'archive est inexistante
(non disponible pour les fichiers .CAB et les fichiers .RAR)
zipEcriture Ouverture en lecture/écriture
(non disponible pour les fichiers .CAB et les fichiers .RAR)
zipEntête64 Permet de créer une archive de plus de 4 gigas sur laquelle la fonction zipChangeChemin pourra être utilisée.
Archive au format TAR ou TGZ (TAR.GZ) : Cette constante n'est pas disponible.
zipLecture Ouverture en lecture seule

Le mode d'ouverture par défaut est : zipCréationSiInexistant + zipEcriture.

Remarques

Codes d'erreur

Les codes d'erreur retournés sont les suivants :

1 : Le chemin passé en paramètre n'existe pas.
2 : Accès interdit : l'utilisateur n'a pas les droits nécessaires.
3 : L'archive est corrompue.
6 : Les fichiers des sous-archives ne sont pas dans l'ordre (cas de l'ouverture d'une archive multi-parties).

Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur. Rappel :

Seules les archives au format ZIP, gzip, TAR et TGZ (TAR.GZ) sont disponibles.

Cas particulier de l'extension .GZ

Ne pas confondre les fichiers '.tar.gz' générés par GitHub, et les fichiers '.gz' compressés au format gzip.
Un contenu compressé au format gzip pourra être décompressé avec la fonction Décompresse.

Classification Métier / UI : Code métier

Composante : wd300zip.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/09/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale