【 utils.readdir 】                                                             

格式：

utils.readdir (s)

中文：

utils.readdir (路徑)

說明：

    讀取指定的硬碟目錄訊息並存入一個表中，你可以使用萬用字元讀取特定
的訊息。

    如果指定的目錄正確，函數會把這個目錄中的子目錄和檔案訊息讀取出來
並存入一個表中。表的索引值是目錄和檔案的名稱。如果指定的目錄不存在，
或者無效，函數會回傳 nil 和一個錯誤訊息。

    回傳的表中包含的檔案訊息如下：

     1.size       ：檔案大小。單位為字元。
     2.create_time：建立日期。檔案的創建時間（FAT 格式的硬碟會忽略這
                    個值）。
     3.access_time：存取日期。檔案最後一次存取的時間（FAT 格式的硬碟
                    會忽略這個值）。
     4.write_time ：修改日期。檔案最後一次修改的時間。
     5.archive    ：存檔屬性。如果存檔的話為 true。對檔案的任何改變
                    都會設定這個值，透過 BACKUP 命令備份後會清除這個
                    值。
     6.hidden     ：隱藏屬性。這個值設定為 true 時，無法透過普通的
                    DIR 命令查看這個檔案     。
     7.normal     ：普通屬性。可以任何修改這個檔案。
     8.readonly   ：唯讀屬性。設為唯讀檔案後，檔案無法被修改，也無法
                    被同名的檔案覆蓋。
     9.system     ：系統屬性。這個值設定為 true 時，無法透過普通的
                    DIR 命令查看這個檔案     。
    10.directory  ：子目錄。透過檢測 directory 屬性，你可以循環讀取
                    一個目錄中的所有檔案和子目錄中的檔案。

注意：一般路徑的寫法如：c:\mushclient\plugins\*.xml，尤於字元\是特殊
      字元，你必須多加一個 \，變成：

            c:\\mushclient\\plugins\\*.xml，

    　但MUSHclient允許使用反斜線/，因此也能寫為：

            c:/mushclient/plugins/*.xml

範例：

t, e = utils.readdir ("c:/mushclient/plugins/*.xml")
assert (t, e) -- 失敗時拋出一個錯誤。
--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--