Small Basic > File(ファイル)

Top > Small Basic > File(ファイル)

小学生・中学生からはじめられる

テキストベースの初心者向けプログラミング言語

File(ファイル)

ファイル オブジェクトは、ディスク上のファイルへのアクセスや読み書きの機能を提供。
このオブジェクトを使って、プログラム上の複数のセッションから設定を保存したり開いたりすることができます。

属性（Properties）
プロパティ	構文	内容
LastError	File.LastError	最後のファイル操作エラーのメッセージを設定または取得（何かの機能がいつ実行に失敗したかを調べるのに役立ちます）。

 

オペレーション（Operations）
メソッド	構文	内容
ReadContents	File.ReadContents(filePath)	ファイルを開き、ファイル全体の内容を読み込む。この機能は 1 MB 以下の小さなファイルに対しては高速に動、10 MB 以上のファイルに対しては速度が落ちる
	filePath　読み込むファイルの完全パス（例 c:\temp\settings.data のような形式）
	Returns　ファイル全体の内容
WriteContents	File.WriteContents(filePath, contents)	ファイルを開いて、指定された内容をそのファイルに書き込む（元の内容は新しい内容に置き換えられる）
	filePath　書き込み対象のファイルの完全パス（例 c:\temp\settings.data のような形式）
	contents　指定されたファイルに書き込まれる内容
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
ReadLine	File.ReadLine(filePath, lineNumber)	指定されたファイルを開いて、指定された行番号まで読み込む
	filePath　読み込むファイルの完全パス（例 c:\temp\settings.data のような形式）
	lineNumber　読み込むテキストの行番号
	Returns　指定されたファイルの指定された行のテキスト
WriteLine	File.WriteLine(filePath, lineNumber, contents)	指定されたファイルを開いて、指定された行番号で書き込みを行う（この操作は現在の内容を指定行まで上書きする）
	filePath　読み込むファイルの完全パス（例 c:\temp\settings.data のような形式）
	lineNumber　書き込むテキストの行番号
	contents　指定されたファイルの指定された行に書き込まれる内容
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
InsertLine	File.InsertLine(filePath, lineNumber, contents)	指定されたファイルを開いて指定された行番号のところにその内容を挿入する（この操作を行っても、指定行の現在の内容は上書きされない）
	filePath　読み込むファイルの完全パス（例 c:\temp\settings.data のような形式）
	lineNumber　挿入されるテキストの行番号
	contents　ファイルに挿入される内容
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
AppendContents	File.AppendContents(filePath, contents)	指定されたファイルを開いてそのファイルの末尾に内容を追加する
	filePath　読み込むファイルの完全パス（例 c:\temp\settings.data のような形式）
	contents　ファイルの末尾に追加される内容
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
CopyFile	File.CopyFile(sourceFilePath, destinationFilePath)	指定されたソース ファイルを転送先のファイル パスにコピーする。転送先のポイントが存在しない場合、自動的にそのポイントを作成することを試みる。 現在あるファイルは上書きする（ファイルが上書きされないようにするためには、転送先にファイルがあるかどうかを確認する）
	sourceFilePath　コピーする必要のあるファイルの完全パス（例 c:\temp\settings.data のような形式）
	destinationFilePath　ファイル パスもしくは移動先の場所
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
DeleteFile	File.DeleteFile(filePath)	指定されたファイルを削除
	filePath　転送先の場所もしくはファイルの完全パス（例 c:\temp\settings.data のような形式）
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
CreateDirectory	File.CreateDirectory(directoryPath)	指定されたディレクトリを作成
	directoryPath　作成されるディレクトリの完全パス
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
DeleteDirectory	File.DeleteDirectory(directoryPath)	指定されたディレクトリを削除
	directoryPath　削除されるディレクトリの完全パス
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
GetFiles	File.GetFiles(directoryPath)	指定されたディレクトリ内のすべてのファイルのパスを取得
	directoryPath　ファイルを探す対象のディレクトリ
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
GetDirectories	File.GetDirectories(directoryPath)	指定されたディレクトリ内のすべてのディレクトリのパスを取得
	directoryPath　サブディレクトリを探す対象ディレクトリ
	Returns　操作が成功した場合 "SUCCESS" を、それ以外は "FAILED" を返す
GetTemporaryFilePath	File.GetTemporaryFilePath()	新しい一時ファイルを一時ディレクトリ内に作成して そのファイルの完全パスを返す
	Returns　一時ファイルの完全パス
GetSettingsFilePath	File.GetSettingsFilePath()	このプログラムの設定ファイルの完全パスを取得。設定ファイルの名前はプログラムの名前に基づいており、プログラムと同じ場所に置かれる。
	Returns　このプログラムの設定ファイルの完全パス