resource - Manipule les resources Macintosh

SYNTAXE

 resource option ?arg arg ...?

DESCRIPTION

La commande resource fournit des opérations génériques pour la gestion des resources Macintosh Cette commande est supportée seulement sur la plateforme Macintosh. Chaque fichier Macintosh consiste en deux forks: une fork data et une fork resource. Vous utilisez les commandes normales open, puts, close, etc. pour manipuler les fork data. Vous devez utiliser cette commande, néanmoins, pour interagir avec le fork resource Option indique quelle commande ressource effectuer. N'importe quel abréviation unique pour option est acceptable Les options valides sont:

resource close rsrcRef Ferme la référence ressource donnée (obtenue par resourceopen) Les ressources de ce fichier ressource ne seront plus disponibles.

resource delete ?options? resourceType Cette commande effacera la ressource spécifiée par options et le type resourceType (voir TYPES DE RESSOURCES ci-dessous) Les options vous donnent plusieurs façons de spécifier l'effacement de la ressource.

-id resourceId Si l'option -id est donnée l'id resourceId (voir IDS DE RESSOURCE ci-dessous) est utilisé pour spécifier la ressource à effacer L'id doit être un nombre - pour spécifier un nom utiliser l'option -name.

-name resourceName Si -name est spécifié, la ressource nommée resourceName sera effacée. Si -id est aussi fournie, alors il doit exister une resource avec A LA FOIS ce nom et cet id. Si aucun nom n'est fourni, alors l'id sera utilisé indépendemment du nom de la resource.

-file resourceRef Si l'option -file est spécifiée alors la ressource sera effacée du fichier pointé par resourceRef Autrement la première ressource avec le resourceName donné et ou resourceId qui est trouvé dans le chemin du fichier ressource sera effacé. Pour inspecter le chemin du fichier, utiliser la commande resource files.

resource files ?resourceRef? Si resourceRef n'est pas fournie, cette commande retourne une liste Tcl des références de ressource pour tous les fichiers ressources couramment ouverts. La liste est dans l'ordre de recherche normal Macintosh pour les ressources. Si resourceRef est spécifié, la commande renverra le chemin vers le fichier dont le fork ressource est représenté par ce jeton.

resource list resourceType?resourceRef? Liste tous les ids ressources de type resourceType (voir TYPES DE RESSOURCE ci-dessous) Si resourceRef est spécifié alors la commande limitera la recherche à ce fichier ressource particulier. Autrement, tout fichier ressource couramment ouvert par l'application sera recherché. Une liste Tcl de soit le nom soit l'id de ressource des resources trouvées sera renvoyée. Voir la section IDS DE RESSOURCE ci-dessous pour plus de détails au sujet de ce qu'est un id de ressource.

resource open fileName ?access? Ouvre la ressource pour le fichier fileName. Les permissions d'accès fichier standard peuvent aussi être spécifiées (voyez la page de manuel de open pour les détails). Une référence de ressource (resourceRef) est renvoyée qui peut être utilisée par les autres commandes ressource. Une erreur peut se produire si le fichier n'existe pas ou si le fichier n'a pas de fork ressource. Néanmoins, si vous ouvrez le fichier avec des permissions d'écriture le fichier et/ou le fork ressource sera créé au lieu de générer une erreur.

resource read resourceType resourceId ?resourceRef? Lit la totalité de la resource de type resourceType (voir TYPES DE RESOURCE ci-dessous) et le nom ou l'id of resourceId (voir IDS DE RESSOURCE ci-dessous) en mémoire et retourne le résultat. Si resourceRef est spécifié, la recherche sera limitée au fichier ressource, autrement on recherchera tous les forks ressource ouverts dans l'application. Il est important de noter que la plupart des ressource Macintosh utilisent un format binaire et les données renvoyé par cette commande peuvent contenir des NULLs ou d'autres données non-ASCII.

resource types ?resourceRef? Cette commande retourne une liste Tcl de tous les types de ressource (voir TYPES DE RESSOURCE ci-dessous) trouvés dans le fichier ressource pointé par resourceRef. Si resourceRef n'est pas spécifié elle renverra tout les types de ressource trouvés dans tous les fichiers ressource couramment ouverts par l'application.

resource write ?options? resourceType data Cette commande écrit les data transmises en tant qu'une nouvelle resource de type resourceType (voir TYPES DE RESSOURCE ci-dessous). Plusieurs options sont disponibles qui décrivent où et comment la ressource est stockée.

-id resourceId Si l'option -id est donnée, l'id resourceId (voir IDS DE RESSOURCE ci-dessous) est utilisé pour la nouvelle ressource, autrement un id unique sera généré qui n'entrera pas en conflit avec une ressource existante. Néanmoins, l'id doit être un nombre - pour spécifier un nom utiliser l'option -name.

-name resourceName Si -name est spécifié le ressource sera nommée resourceName, autrement elle aura pour nom la chaîne vide.

-file resourceRef Si l'option -file est spécifiée alors la ressource sera écrite dans le fichier pointé par resourceRef, autrement la ressource la plus récemment ouverte sera utilisée.

-force Si la ressource cible existe déjà, alors par défaut Tcl ne l'écrasera pas, mais lèvera une erreur. Utilisez le flag -force pour forcer l'écrasement de la ressource existante

TYPES DE RESOURCE

Les types de ressource sont définis comme une chaîne de quatre caractère qui est alors mappée à un id sous-jacent Par exemple, TEXT se réfère au type de ressource Macintosh pour le texte. Le type STR# est une liste de chaînes indexée. Toutes les ressources Macintosh doivent avoir un type. Voir la documentation Macintosh pour une liste plus complète des types de ressource qui sont communément utilisés.

IDS DE RESOURCE

Pour cette commande la notion d'un id de ressource se réfère à deux idées sur les ressources Macintosh. Partout où vous pouvez utiliser un Id de ressource, vous pouvez utiliser soit le nom de ressource ou un numéro de resource. Les noms sont toujours recherchés ou renvoyés de préférence aux numéros. Par exemple, la commande resource list renverra les noms s'ils existent ou les numéros si le nom est NULL.

PROBLÈMES DE PORTABILITÉ

La commande resource est seulement disponible sur Macintosh.

VOIR ÉGALEMENT

open

---

Traduit par Michel Salvagniac 2002-2003