Manipule les noms et les attributs de fichier
file option name ?arg arg ...?
Cette commande fournit plusieurs opérations sur un nom ou des attributs de fichier. Name est le nom d'un fichier; s'il commence avec un tilde, alors la substitution tilde est faite avant l'exécution de la commande (voyez la page de manuel de Noms de fichiers pour les détails). Option indique que faire avec le nom de fichier. N'importe quelle abréviation unique pour option est acceptable. Les options valides sont:
file atime name ?time?
Renvoie une chaîne décimale donnant la date du dernier accès au fichier name. Si time est spécifié, c'est pour fixer la date d'accès au fichier. Le temps est mesuré de la façon POSIX standard comme nombre de secondes depuis une date fixe (souvent January 1, 1970). Si le fichier n'existe pas ou que sa date d'accès ne peut être trouvée ou fixée alors une erreur est générée. Sous Windows, le système de fichiers FAT ne supporte pas la date d'accès (POSIX).
file attributes name file attributes name ?[2clock]? file attributes name ?option value option value...?
Cette sous commande retourne ou fixe les valeurs spécifiques à la plate-forme associées à un fichier. La première forme retourne une liste de flags spécifiques à la plate-forme et leurs valeurs.
La seconde forme retourne la valeur de l'option spécifique.
La troisième forme fixe une ou plusieurs des valeurs. La valeurs sont les suivantes:
file channels ?pattern?
Si pattern n'est pas spécifié, retourne une liste de noms de tous les canaux déclarés ouverts dans cet interpréteur. Si pattern est spécifié, seulement les noms correspondants à pattern sont renvoyés. La correspondance est déterminée en utilisant les mêmes règles que pour string match.
file copy ?-force? ?--? source target file copy?-force? ?--? source ?source ...? targetDir
La première forme fait une copie du fichier ou répertoire source sous le nom de chemin target. Si target est un répertoire existant, alors la seconde forme est utilisée. La seconde forme fait une copie dans targetDir de chaque fichier source listé. Si un répertoire est spécifié comme source, alors le contenu du répertoire sera récursivement copié dans targetDir. Les fichiers existants ne seront pas écrasés à moins que l'option -force soit spécifiée. Essayer d'écraser un répertoire non-vide, écraser un répertoire avec un fichier, ou un fichier avec un répertoire donnera des erreurs même si -force a été spécifié. Les arguments sont traités dans l'ordre spécifié, s’arrêtant à la première erreur, si elle existe. Un – marque la fin des commutateurs; l'argument suivant le – sera traité comme un source même s'il commence avec un -.
file delete ?-force? ?--? pathname ?pathname ... ?
Efface le fichier ou répertoire spécifié par chaque argument pathname. Les répertoires non-vide seront enlevés seulement si l'option -force est spécifiée. Essayer d'effacer un fichier non-existant n'est pas considéré comme une erreur. Essayer d'effacer un fichier lecture-seule provoquera l'effacement du fichier, même si le -force flags n'est pas spécifié. Les arguments sont traité dans l'ordre spécifié, s’arrêtant à la première erreur, si elle existe. Un – marque la fin des commutateurs; l'argument suivant le – sera traité comme un pathname même s'il commence avec un -.
file dirname name
Renvoie un nom comportant tout les composants de chemin de name excluant le dernier élément. Si name est un nom de fichier relatif et contient seulement un élément de chemin, alors retourne “.” (ou “:” sur le Macintosh). Si name se réfère à un répertoire racine, alors le répertoire racine est renvoyé. Par exemple, file dirname c:/ retourne c:/. Notez que la substitution tilde sera effectuée seulement si c'est nécessaire pour que la commande aboutisse. Par exemple, file dirname ~/src/foo.c retourne ~/src, alors que file dirname ~ retourne /home (ou quelque chose de similaire).
file executable name
Renvoie 1 si le fichier name est exécutable par l'utilisateur courant, 0 autrement.
file exists name
Renvoie 1 si fichier name existe et que l'utilisateur courant a les privilèges de recherche pour les répertoires y menant, 0 autrement.
file extension name
Renvoie tous caractères de name après et incluant le dernier point dans le dernier élément de name. S'il n'y a pas point dans le dernier élément de name alors retourne la chaîne vide.
file isdirectory name
Renvoie 1 si le fichier name est un répertoire, 0 autrement.
file isfile name
Renvoie 1 si le fichier name est un fichier ordinaire, 0 autrement.
file join name ?name ...?
Prend un ou plusieurs noms de fichiers et les combine, en utilisant le séparateur de chemin correct pour la plate-forme courante. Si un name particulier est relatif, alors il sera joint au précédent argument nom de fichier. Autrement, tout argument précédent sera écarté, et la jointure commencera à l'argument courant. Par exemple, file join a b /foo bar retourne /foo/bar. Notez que n'importe quel des noms peut contenir des séparateurs, et que le résultat est toujours canonique pour la plate-forme courante : / pour Unix et Windows, et : pour Macintosh.
file lstat name varName
Identique à l'option stat (voir ci-dessous) excepté qu'elle utilise l' appel kernel lstat au lieu de stat. Ceci signifie que si name se réfère à un lien symbolique l'information renvoyée dans varName concerne le lien plutôt que le fichier auquel il se réfère. Sur les systèmes qui ne supportent pas les lien symboliques cette option se comporte exactement comme l'option stat.
file mkdir dir ?dir ...? file mtime name ?time?
Renvoie une chaîne décimale donnant le temps auquel fichier name a été modifié pour la dernière fois. Si time est spécifié, c'est une pour fixer le temps pour le fichier (équivalent à touch sous Unix). Le temps est mesuré de la façon standard POSIX en tant que secondes depuis une date fixe (souvent 1 Janvier 1970). Si le fichier n'existe pas ou la date de modification ne peut être trouvée ou réglée, une erreur est générée.
file nativename name
Renvoie le nom du fichier spécifique à la plate-forme. Ceci est utile si le nom de fichier est nécessaire à transmettre à un appel spécifique à la plate-forme, tel que exec sous Windows ou AppleScript sur Macintosh.
file owned name
Renvoie 1 si fichier name appartient à l'utilisateur courant, 0 autrement.
file pathtype name
Renvoie un de absolute, relative, ou volumerelative. Si name se réfère à un fichier spécifique sur un volume spécifique , le chemin type sera absolute. Si name se réfère à un fichier relatif au répertoire de travail courant, alors le type du chemin sera relative. Si name se réfère à un fichier relatif au répertoire de travail courant sur un volume spécifié, ou à un fichier spécifique sur le volume de travail courant, alors le type fichier est volumerelative.
file readable name
Renvoie 1 si le fichier name est lisible par l'utilisateur courant, 0 autrement.
file readlink name
Renvoie la valeur du lien symbolique désigné par name (ex. le nom du fichier vers lequel il pointe). Si name n'est pas un lien symbolique ou que sa valeur ne peut pas être lue, alors une erreur est générée. Sur les systèmes qui ne supportent pas les liens symboliques cette option est indéfinie.
file rename?-force? ?--? source target file rename?-force? ?--? source ?source ...? targetDir
La première forme prend le fichier ou le répertoire spécifié par le nom de chemin source et le renomme en target, en déplaçant le fichier si le nom de chemin target spécifie un nom dans un répertoire différent. Si target est un répertoire existant, alors la seconde forme est utilisée. La seconde forme déplace chaque fichier ou répertoire source dans le répertoire targetDir. Les fichiers existants ne seront pas écrasés à moins que l'option -force soit spécifiée. Essayer d'écraser un répertoire non-vide, écraser un répertoire avec un fichier, ou un fichier avec un répertoire générera des erreurs. Les arguments sont traités dans l'ordre spécifié, s'arrêtant à la première erreur, si elle existe. Un – marque la fin des commutateurs; l'argument suivant le – sera traité comme une source même s'il commence avec un -.
file rootname name
Renvoie tous les caractères dans name jusqu’à mais non inclus le dernier caractère “.” dans le dernier composant du nom. Si le dernier composant de name ne contient pas de point, alors retourne name.
file size name
Renvoie une chaîne décimale donnant la taille du fichier name en octets. Si le fichier n'existe pas ou si sa taille ne peut pas être obtenue alors une erreur est générée.
file split name
Renvoie une liste dont les éléments sont les composants de chemin in name. Le premier élément de la liste aura le même type chemin que name. Tous les autres éléments seront relatifs. Les séparateurs de chemin seront écartés à moins que ils soit nécessaires pour s'assurer qu'un élément est relatif sans ambiguïté. Par exemple, sous Unix file split /foo/~bar/baz retourne / foo ./~bar baz pour s'assurer que les commandes suivantes qui utiliseront le troisième composant ne tentent pas d'effectuer une substitution de tilde.
file stat name varName
Déclenche l'appel kernel stat sur name, et utilise la variable désignée par varName pour recevoir information renvoyée par l'appel kernel. VarName est traité comme une variable tableau, et les éléments suivants de cette variable sont fixes: atime, ctime, dev, gid, ino, mode, mtime, nlink, size, type, uid. Chaque élément excepté type est une chaîne décimale avec la valeur du champ correspondant de la stat structure de retour; voyez la page de manuel de stat pour des détails sur le sens des valeurs. L'élément type donne le type du fichier sous la même forme que celle renvoyée par la commande file type. Cette commande retourne une chaîne vide.
file tail name
Renvoie tous les caractères dans name après le dernier séparateur de répertoire. Si name ne contient pas de séparateurs alors retourne name.
file type name
Renvoie une chaîne donnant le type de fichier name, qui sera l'un de file, directory, characterSpecial, blockSpecial, fifo, link, ou socket.
file volume
Renvoie le chemin absolu des volumes montés sur le système, comme liste Tcl correcte. Sur Macintosh, ce sera une liste des lecteurs montés, locaux ou réseaux. N.B. si deux lecteurs ont le même nom, ils apparaîtront tous deux sur la liste de volumes, mais il n'y a pas de façon, avec Tcl, d’accéder à un autre que le premier de ces lecteurs. Sous UNIX, la commande retournera toujours “/”, car tous les systèmes de fichier sont montés localement. Sous Windows, elle renverra une liste des lecteurs locaux disponibles (ex. {a:/ c:/}).
file writable name
Renvoie 1 si le fichier name est inscriptible par l'utilisateur courant, 0 autrement.