メッセージウィンドウで、put mMessageList( xtra "fileIO" ) を実行してみますと、以下のようにメッセージが表示されます。

new object me -- create a new child instance
-- FILEIO --
・fileName object me -- return fileName string of the open file
・status object me -- return the error code of the last method called
・error object me, int error -- return the error string of the error
・setFilterMask object me, string mask -- set the filter mask for dialogs
・openFile object me, string fileName, int mode -- opens named file. valid modes: 0=r/w 1=r 2=w
・closeFile object me -- close the file
・displayOpen object me -- displays an open dialog and returns the selected fileName to lingo
・displaySave object me, string title, string defaultFileName -- displays save dialog and returns selected fileName to lingo
・createFile object me, string fileName -- creates a new file called fileName
・setPosition object me, int position -- set the file position
・getPosition object me -- get the file position
・getLength object me -- get the length of the open file
・writeChar object me, string theChar -- write a single character (by ASCII code) to the file
・writeString object me, string theString -- write a null-terminated string to the file
・readChar object me -- read the next character of the file and return it as an ASCII code value
・readLine object me -- read the next line of the file (including the next RETURN) and return as a string
・readFile object me -- read from current position to EOF and return as a string
・readWord object me -- read the next word of the file and return it as a string
・readToken object me, string skip, string break -- read the next token and return it as a string
・getFinderInfo object me -- get the finder info for the open file (Mac Only)
・setFinderInfo object me, string attributes -- set the finder info for the open file (Mac Only)
・delete object me -- deletes the open file
・+ version xtraRef -- display fileIO version and build information in the message window
・* getOSDirectory -- returns the full path to the Mac System Folder or Windows Directory

では、各コマンドに関して見てみます。

new object meは、fileioのインスタンスを作成します。

例えば、set Docs = new( xtra "fileio" ) というようにします。この場合、ローカル変数 Docs が fileio のインスタンスとなります。

fileName object me は、オープンダイアログを表示し、セレクトされたファイルのフルパスを返してきます。

**********

status object me は、最後に行われたメソッドが正常に動作したかを数字で返してきます。

メッセージウィンドウで put status( Docs ) を実行しますと、
-- 0 （正常に動作した場合）
-- -37 （何らかの問題があったとき。「-37」とは限らない）
などの数字が表示されます。

error object me, int error は、数字で返されたエラーコードをワード形式に変換する関数。

メッセージウィンドウで put error( Docs, 0 ) を実行しますと、
-- "OK"
また、メッセージウィンドウで put error( Docs, -37 ) を実行しますと、
-- "File not open"
が表示されます。

setFilterMask object me, string mask は、オープンダイアログを表示し、セレクトされたファイルのフルパスを返してきます。

**********

openFile object me, string fileName, int mode は、引数で指定されたファイルを読み込みます。 mode の引数は、0 = r/w、1=w、2=r です。

メッセージウィンドウで openFile( Docs, the moviePath & "read.txt", 0 ) を実行しますと、
Director movieと同じ階層にある「read.txt」ファイルを読み込みます。

closeFile object me は、現在オブジェクトが読み込んでいるファイルをメモリ上から消します。

メッセージウィンドウで closeFile( Docs ) を実行しますと、
FileIOのインスタンスは存在しますが、読み込んでいたファイルは、void になります。

displayOpen object me は、オープンダイアログを表示し、セレクトされたファイルのフルパスを返してきます。

メッセージウィンドウで、put displayOpen( Docs ) を実行しますと、
オープンダイアログが表示され、ファイルを選択すると、そのファイルのフルパスを返してきます。

displaySave object me, string title, string defaultFileName は、セーブダイアログを表示し、保存ボタンをクリックするとファイルのフルパスを返してきます。

メッセージウィンドウで、put displaySave( Docs, "保存します", "My Files" ) を実行しますと、
セーブダイアログが表示され、デフォルトでのファイル名は「My Files」となっています。また、ファイル名の上部に「保存します」と表示されます。保存ボタンをクリックしますと、そのファイルのフルパスを返してきます。

createFile object me, string fileName は、引数で指定されたパスに指定のファイル名のファイルを作ります。

メッセージウィンドウで、put createFile( Docs, "HDD03:My Docs" ) を実行しますと、
ボリューム「HDD03」に「My Docs」という書類を作成します。

setPosition object me, int position は、現在のオブジェクトの引数で指定された位置に移動します。

メッセージウィンドウで、put setPosition( Docs, 5 ) を実行しますと、
例えば、"ABCDEFGHIJKLMN"という文字列を読み込んでいた場合、
--"E"
を返してきます。

getPosition object me は、現在のオブジェクトの位置を返してきます。

メッセージウィンドウで、put getPosition( Docs ) を実行しますと、
--8
のように数値を返してきます。

getLength object me は、現在読み込んでいるファイルのバイト数を返してきます。

メッセージウィンドウで、put getLength( Docs ) を実行しますと、
--76
のように、読み込んでいるファイルのバイト数を返してきます。

writeChar object me, string theChar は、現在のオブジェクトに引数で指定されたキャラクターを加えます。

メッセージウィンドウで writeChar( Docs, "K" ) を実行しますと、
例えば、実行する前のオブジェクトが"AAAAAAAA"だった場合、実行後、オブジェクトは"AAAAAAAAK"となります。

writeString object me, string theString は、現在のオブジェクトに引数で指定された文字列を加えます。。

メッセージウィンドウで writeChar( Docs, "DDDDD" ) を実行しますと、
例えば、実行する前のオブジェクトが"AAAAAAAA"だった場合、実行後、オブジェクトは"AAAAAAAADDDDD"となります。

readChar object me は、オブジェクトの現在のポジションの次のキャラクタを返してきます。

メッセージウィンドウで、put readChar( Docs ) を実行しますと、
--"く"
の様にキャラクタを返してきます。

readLine object me は、オブジェクトの現在のポジション以降の1行を返してきます。

メッセージウィンドウで、put readLine( Docs ) を実行しますと、
--"かきくけこさしすせそ
" の様にストリングを返してきます。

readFile object me は、オブジェクトの現在のポジション以降の全てを返してきます。

メッセージウィンドウで、put readFile( Docs ) を実行しますと、
--"あいうえお
かきくけこ
さしすせそ
たちつてと
"
の様にストリングを返してきます。

readWord object me は、オブジェクトの現在のポジション以降の 1 wordを返してきます。

メッセージウィンドウで、put readWord( Docs ) を実行しますと、
--"けけけけ"
の様にワードを返してきます。

readToken object me, string skip, string break は、オープンダイアログを表示し、セレクトされたファイルのフルパスを返してきます。

**********

getFinderInfo object me は、現在のオブジェクトの type と creator を返してきます。

メッセージウィンドウで、put getFinderInfo( Docs ) を実行しますと、
-- "TEXT JEDT"
の様に type と creator を返してきます。

setFinderInfo object me は、現在のオブジェクトの type と creator を設定します。

メッセージウィンドウで、setFinderInfo( Docs, "TEXT JEDT" ) を実行しますと、 その書類の type と creator は、"TEXT JEDT"となります。

delete object me は、現在開いているファイルを削除します。

メッセージウィンドウで、delete( Docs ) を実行しますと、
FileIOのインスタンスは存在しますが、読み込んでいたファイルは、voidになります。
また、読み込んでいた元のファイルも削除されます。

getOSDirectory は、現在の使用しているシステムのディレクトリをフルパスで返してきます。この関数は、インスタンスを作成しなくても有効です。

メッセージウィンドウで、put getOSDirectory() を実行しますと、
-- "OS 8:システムフォルダ:"
というように、OS のディレクトリを返してきます。