Scroll to navigation

resource(3tcl) Tcl Built-In Commands resource(3tcl) 





NAME


resource - 操縱 Macintosh 資源






總覽 SYNOPSIS


resource option ?arg arg ...?










描述 DESCRIPTION


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



  

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

  

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







  

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

  

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

  

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







  

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

  

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

  

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

  

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

  

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

  

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







  

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

  

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

  

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

  

  
如果目標資源已經存在，則
      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






跋


本頁面中文版由中文
    man 手冊頁計劃提供。
  

  中文 man
    手冊頁計劃：https://github.com/man-pages-zh/manpages-zh







  

    8.0
    Tcl