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.
Etats et Requêtes
MonArchive est un zipArchive
// Création de l'archive
ResOuverture = zipOuvre(MonArchive, "C:\Temp\Archive.zip")
SI ResOuverture = 0 ALORS
...
// Suppression de "Fichier.doc"
ResSuppression = zipSupprimeFichier(MonArchive, "Fichier.doc")
...
FIN
Syntaxe

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

<Résultat> = zipSupprimeFichier(<Archive> , <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> : Chaîne de caractères ou variable de type zipArchive
Nom de l'archive à manipuler.
Ce nom peut correspondre :
<Indice du fichier> : Entier
Indice du fichier à supprimer de l'archive. Cet indice peut être connu grâce à la fonction zipChercheFichier.

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

<Résultat> = zipSupprimeFichier(<Archive> , <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.
<Archive> : Chaîne de caractères ou variable de type zipArchive
Nom de l'archive à manipuler.
Ce nom peut correspondre :
<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 zipCré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 zipSupprimeFichier. 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 zipSupprimeListeFichier.
Rappel :

    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 zipChercheFichier).
    • 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.
    Classification Métier / UI : Code métier
    Composante : wd290zip.dll
    Version minimum requise
    • Version 9
    Documentation également disponible pour…
    Commentaires
    Cliquez sur [Ajouter] pour publier un commentaire

    Dernière modification : 05/05/2023

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