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
Etats et Requêtes
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 :

    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