SUPPRIMER DOSSIER

4D v16.3

SUPPRIMER DOSSIER


SUPPRIMER DOSSIER ( dossier {; optionSuppression} )

Paramètre	Type	Description
dossier	Chaîne	Nom ou chemin d’accès complet du dossier à supprimer
optionSuppression	Entier long	Option de suppression du dossier

Description

La commande SUPPRIMER DOSSIER supprime le dossier dont vous avez passé le nom ou le chemin d’accès complet dans dossier.

Par défaut pour des raisons de sécurité, si vous omettez le paramètre optionSuppression, SUPPRIMER DOSSIER permet uniquement la suppression de dossiers vides. Si vous souhaitez que cette commande puisse supprimer des dossiers non vides, vous devez utiliser le paramètre optionSuppression. Vous pouvez passer dans ce paramètre l'une des constantes suivantes, placées dans le thème "Documents système" :

Constante	Type	Valeur	Comment
Supprimer avec contenu	Entier long	1	Supprime le dossier ainsi que son éventuel contenu
Supprimer si vide	Entier long	0	Supprime le dossier uniquement s'il est vide

Si vous passez Supprimer si vide ou omettez le paramètre optionSuppression :
- Le dossier désigné par le paramètre dossier n'est supprimé que s'il est vide ; sinon, la commande ne fait rien et une erreur -47 (Fichier déjà ouvert, ou dossier non vide) est générée.
- Si le dossier désigné n'existe pas, l'erreur -120 (Tentative d'accès à un fichier avec un chemin d'accès spécifiant un répertoire inexistant) est générée.

Si vous passez Supprimer avec contenu :
- Le dossier ainsi que tout son contenu sont supprimés.
  Attention : Si le dossier est verrouillé ou en lecture seule, il sera néanmoins supprimé si l'utilisateur courant dispose des droits d’accès nécessaires.
- Si le dossier désigné ou un des fichiers qu'il contient ne peut pas être supprimé, la procédure de suppression est abandonnée dès que le premier élément inaccessible est atteint, et une erreur(*) est retournée. Dans ce cas, le dossier ne sera que partiellement supprimé. Il est cependant possible d'utiliser la commande LIRE PILE DERNIERE ERREUR pour obtenir le nom et le chemin d’accès du fichier à l'origine de l'erreur.
- Si le dossier désigné n'existe pas, la commande ne fait rien et aucune erreur n'est générée.
  (*) sous Windows : -54 (Tentative d'écriture dans un fichier verrouillé)
  sous OS X : -45 (Fichier verrouillé ou chemin d'accès invalide)

Vous pouvez intercepter ces erreurs à l’aide d’une méthode installée par la commande APPELER SUR ERREUR .

Voir aussi

SUPPRIMER DOCUMENT