DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives
  • Conditions d'utilisation
  • Codes d'erreur
  • Indice des fichiers dans l'archive
  • Chemin mémorisé
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Supprime un ensemble de fichiers contenu dans une archive. Cette fonction est plus rapide que la fonction <Variable zipArchive>.SupprimeFichier exécutée pour chaque fichier.
Exemple
WEBDEV - Code ServeurAjax
MonArchive est un zipArchive
// Création de l'archive
ResOuverture = MonArchive.Ouvre("C:\Temp\Archive.zip")
 
SI ResOuverture = 0 ALORS
...
// Suppression de "Fichier.doc" et de "MonDoc.pdf"
ResSuppression = MonArchive.SupprimeListeFichier("Fichier.doc" + RC + "MonDoc.PDF")
...
FIN
Syntaxe
<Résultat> = <Archive>.SupprimeListeFichier(<Chemin des fichiers à supprimer> [, <Gestion de la jauge>])
<Résultat> : Entier
  • 0 si les fichiers ont été supprimés,
  • Un code d'erreur (valeur supérieure à 0) dans le cas contraire. Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.
<Archive> : Variable de type zipArchive
Nom d'une variable de type zipArchive correspondant à l'archive à manipuler.
<Chemin des fichiers à supprimer> : Chaîne de caractères
Chemin mémorisé du fichier à supprimer de l'archive. Chaque chemin est séparé par un RC (Retour Chariot).
<Gestion de la jauge> : Chaîne de caractères optionnelle
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    <Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement> correspond au pourcentage d'avancement de la suppression de la liste de fichiers dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Remarques

Conditions d'utilisation

La suppression de fichiers dans une archive ne peut être réalisée que si :
  • L'archive existe (la création d'une archive s'effectue avec la fonction <Variable zipArchive>.Crée).
  • L'archive est accessible en lecture et en écriture.
  • L'archive est mono-partie.
Attention :
  • Archives au format RAR : Cette fonction n'est pas disponible.
  • Archives au format CAB : Cette fonction n'est pas disponible.
  • Archives au format TAR et TGZ (TAR.GZ) : Cette fonction n'est pas disponible.
  • Archives au format 7z : L'archive est entièrement compressée à chaque appel de la fonction <Variable zipArchive>.SupprimeListeFichier.
Linux Seules les archives au format ZIP sont disponibles.

Codes d'erreur

Les codes d'erreur retournés sont les suivants :
  • 2 : Accès interdit : l'utilisateur n'a pas les droits nécessaires.
  • 3 : L'archive est corrompue.
  • 4 : Le chemin n'existe pas dans l'archive.
  • 5 : Impossible d'écrire dans l'archive.

Indice des fichiers dans l'archive

Après une suppression de fichiers, les fichiers présents dans une archive sont ré-indicés. Les indices des fichiers suivant le fichier supprimé sont automatiquement décrémentés de 1.

Chemin mémorisé

Le tableau ci-dessous présente les chemins mémorisés dans l'archive en fonction :
  • du chemin d'accès du fichier,
  • de la portion du chemin à mémoriser.
Le répertoire en cours est : "C:\Temp".
Fonction zipAjouteFichierLocalisation du fichierzipAucunzipRépertoirezipDisque
zipAjouteFichier("Archi",
"Fichier.txt")
C:\Temp\Fichier.txtFichier.txtFichier.txtFichier.txt
zipAjouteFichier("Archi",
"Donnée\Fichier.txt")
C:\Temp\Donnée\Fichier.txtFichier.txtDonnée\Fichier.txtDonnée\Fichier.txt
zipAjouteFichier("Archi",
"D:\Donnée\Fichier.txt")
D:\Donnée\Fichier.txtFichier.txtDonnée\Fichier.txtD:\Donnée\Fichier.txt

Remarque : Si la constante zipDisque est utilisée, le format WDZ mémorise le chemin complet du fichier (lettre du lecteur comprise) alors que le format ZIP ne mémorise pas la lettre du lecteur.
Composante : wd290zip.dll
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

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