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 fichier contenu dans une archive.
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"
ResSuppression = MonArchive.SupprimeFichier("Fichier.doc")
...
FIN
Syntaxe

Supprimer un fichier sélectionné selon son indice Masquer les détails

<Résultat> = <Archive>.SupprimeFichier(<Indice du fichier>)
<Résultat> : Entier
  • 0 si le fichier a été supprimé,
  • 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.
<Indice du fichier> : Entier
Indice du fichier à supprimer de l'archive. Cet indice peut être connu grâce à la fonction <Variable zipArchive>.ChercheFichier.

Supprimer un fichier sélectionné selon son chemin Masquer les détails

<Résultat> = <Nom de l'archive>.SupprimeFichier(<Chemin du fichier>)
<Résultat> : Entier
  • 0 si le fichier a été supprimé,
  • 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.
<Nom de l'archive> : Variable de type zipArchive
Nom d'une variable de type zipArchive correspondant à l'archive à manipuler.
<Chemin du fichier> : Chaîne de caractères
Chemin mémorisé du fichier à supprimer de l'archive.
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 ou 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>.SupprimeFichier. Cette fonction est conseillée lors de la suppression d'un seul fichier. Si plusieurs fichiers doivent être supprimés dans l'archive, utilisez la fonction <Variable zipArchive>.SupprimeListeFichier.
Rappel :
  • Linux Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) 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

Lors de l'ajout d'un fichier dans une archive, un indice est automatiquement attribué au fichier. Cet indice correspond à l'ordre d'intégration des fichiers dans l'archive.
Pour sélectionner un fichier de l'archive, il est possible d'utiliser :
  • Soit l'indice de l'élément (l'indice d'un élément peut être connu grâce à la fonction <Variable zipArchive>.ChercheFichier).
  • Soit le chemin mémorisé de l'élément.
Important : 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