Provided by: manpages-zh_1.5.2-1_all bug

NAME

       resource - 操縱 Macintosh 資源

總覽 SYNOPSIS

       resource option ?arg arg ...?
_________________________________________________________________

描述 DESCRIPTION

       resource         命令為處理         Macintosh        資源提供了一些一般操作。只在Macintosh
       平台上支持這個命令。每個  Macintosh  檔案由兩個   fork組成:   一個數據   fork   和一個資源
       fork。你可以使用通常的open、puts、    close   等命令來操縱數據   fork。但是要與資源   fork
       交互你必須使用這個命令。Option            指示完成什麼資源命令。可以接受            option
       的一個唯一的縮寫。有效的選項有:

       resource close rsrcRef
              關閉給定的資源引用(獲取自 resource open)。來自這個資源檔案的資源將不再可獲得。

       resource delete ?options? resourceType
              這個命令將刪除用  options  和類型  resourceType (參見下面的RESOURCE TYPES 資源類型)
              指定的資源。下列選項給出指定要刪除資源的一些方式。

              -id resourceId
                     如果給出了  -id   選項,則使用   id   resourceId   (參見下面的RESOURCE   IDS
                     資源ID)指定要被刪除的資源。id   必須是一個數  -  要指定一個名字請使用  -name
                     選項。

              -name resourceName
                     如果指定了     -name,則刪除叫做      resourceName      的資源。如果還提供了
                     -id,則要刪除的資源必須有這個名字和這個  id  二者。如果未提供名字,則使用 id
                     而不管實際資源的名字。

              -file resourceRef
                     如果指定了             -file             選項,則從              resourceRef
                     所指向的檔案中刪除資源。否則刪除在資源檔案路徑上找到的有給定的  resourceName
                     和/或 resourceId 的第一個資源。要檢查檔案路徑,應使用 resource files 命令。

       resource files ?resourceRef?
              如果未提供   resourceRef,這個命令返回所有當前打開的資源檔案的資源引用的一個    Tcl
              列表。這個列表按           Macintosh           通常查找資源的次序來排序。如果指定了
              resourceRef,這個命令將返回到那個記號表示的資源 fork 所在的檔案的路徑。

       resource list resourceType ?resourceRef?
              列出所有的類型     resourceType      的      id(參見下面的      RESOURCE      TYPES
              資源類型)。如果指定了resourceRef
              ,則這個命令把查找限制為這個特定的資源檔案。否則,查找應用當前當前打開的所有資源檔案。返回找到的資源的要麼是資源名字要麼是資源id
              的一個 Tcl 列表。關於資源 id 的詳情請參見下面的 RESOURCE IDS  資源 ID。

       resource open fileName ?access?
              打開檔案      fileName      的中資源。還可以指定標準檔案訪問權限(詳情參見      open
              手冊條目)。它返回可被其他資源命令使用的一個資源引用(resourceRef)。如果檔案不存在或檔案沒有資源
              fork    則產生一個錯誤。但是,如果你打開檔案時加上了寫權限,則建立這個檔案和/或資源
              fork 而不生成一個錯誤。

       resource read resourceType resourceId ?resourceRef?
              把類型是  resourceType  (參見下面的   RESOURCE   TYPES資源類型)並且名字或   id   是
              resourceId          的全部資源(參見下面的         RESOURCE         IDS         資源
              ID)讀到記憶體中並返回這個結果。如果指定了                               resourceRef
              ,則這個命令把我們的查找限制為這個特定的資源檔案,否則我們查找在應用中所有打開的資源。要注意:多數
              Macintosh 資源使用二進制格式,並且從這個命令返回的數據可能包含嵌入的 NULL  或其他非
              ASCII 數據。

       resource types ?resourceRef?
              這個命令返回在 resourceRef 所指向的資源檔案中找到的所有資源類型(參見下面的 RESOURCE
              TYPES資源類型)的一個Tcl                列表。如果未指定                 resourceRef
              ,則它返回在應用當前打開的所有資源檔案中找到的所有資源類型。

       resource write ?options? resourceType data
              這個命令把在  data  中傳遞進來的數據寫為類型是  resourceType  (參見下面的  RESOURCE
              TYPES資源類型)的一個新資源。可獲得許多描述資源存儲在那裏和如何存儲的選項。

              -id resourceId
                     如果給出了  -id  選項,則為新資源使用  id  resourceId   (   參見下面的SOURCE
                     TYPES資源類型),否則生成一個與任何現存的資源不沖突的一個唯一的  id。但是,id
                     必須是一個數 - 要指定一個名字請使用 -name 選項。

              -name resourceName
                     如果指定了 -name,則這個資源將叫做 resourceName,否則它將以空串作為名字。

              -file resourceRef
                     如果指定了          -file          選項,則把資源被寫入          resourceRef
                     所指向的檔案中,否則使用最新近打開的資源。

              -force 如果目標資源已經存在,則 Tcl 預設的不是覆寫它,而是引發一個錯誤。使用 -force
                     標誌來強行覆寫現存的資源。

資源類型 RESOURCE TYPES

       資源類型被定義為一個四字符的字符串,它被映射成一個底層  id。例如,TEXT  參照的   Macintosh
       資源類型是文本。類型     STR#     是已計數的(counted)的字符串的一個列表。所有    Macintosh
       資源必須是某種類型的。要得到通常使用的資源類型的一個完整列表請參見 Macintosh 文件。

資源 RESOURCE IDS

       對於本命令,一個資源的           id           的概念(notion)實際上涉及           Macintosh
       資源中的兩個概念。在你可以使用資源                                                      Id
       的每個地方,你可以使用資源名字或者一個資源數。查找和返回總是偏好名字而不是數。例如,如果一個資源的名字存在則
       resource list 命令將返回這個名字,如果資源的名字是 NULL 則返回數。

移植要點 PORTABILITY ISSUES

       只在 Macintosh 上可獲得這個命令。

參見 SEE ALSO

       open(n)

關鍵字 KEYWORDS

       open, resource

[中文版維護人]

       寒蟬退士

[中文版最新更新]

       2001/10/29

《中國 Linux 論壇 man 手冊頁翻譯計劃》:

       http://cmpp.linuxforum.net