PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
  • 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
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax
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 :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou la fonction zipCrée.
  • WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystAjax soit au nom d'une variable de type zipArchive.
<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 :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou la fonction zipCrée.
  • WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystAjax soit au nom d'une variable de type zipArchive.
<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 :
  • LinuxUniversal Windows 10 AppiPhone/iPadWidget IOSMac Catalyst Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) sont disponibles.
  • AndroidWidget AndroidJava 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

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.
AndroidWidget AndroidJava La constante zipDisque est équivalente à la constante zipRépertoire.
Universal Windows 10 App Le répertoire et le disque ne sont pas mémorisés dans le chemin de l'archive. Seuls le nom du fichier et son extension sont mémorisés.
Classification Métier / UI : Code métier
Composante : wd280zip.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire