ファイルの読み書きとエラー処理
English | 日本語
多くの関数は、処理結果とエラー情報(Err)を返します。失敗した場合でも、途中まで読み取ったデータなどが結果に残ることがあります。値を使う前に、エラー情報がnullかどうかを確認してください。
ファイル全体を読む
message.txtを用意し、次をread.gdに保存します。
func main():
var text, err = GD.file.read_text("message.txt")
if err != null:
printerr(err)
return 1
print(text)
return 0gd read.gdこの判定で空ファイルと読み込み失敗を区別できます。read_textはUTF-8としてデコードし、read_bytesはバイト値を保持します。
失敗を伝える
エラーが起きたらプログラムを終了する場合は!を使います。gd serveでは、エラーが起きたリクエストの処理だけが終了します。
func main():
GD.file.ensure_dir("output")!
GD.file.write_text("output/message.txt", "Hello!\n")!
return 0write_textはファイルの内容を置き換え、append_textは末尾に追加します。書き込んだバイト数は返しません。成功したかどうかは、エラー情報がnullかどうかで確認します。処理結果とErrを返す関数の中では、?を使ってエラーをそのまま呼び出し元へ返せます。
自分でエラーを返す
ファイルを読めても、内容が空なら失敗にしたい場合は、自分でErrを作って返します。Err("説明", 種類, 追加情報)の形で、説明文、Err.INVALID_DATAなどの種類、必要な情報を指定します。次をread_message.gdに保存してください。
# Read a message and reject empty contents.
func read_message(path: String) -> String, Err:
var text := GD.file.read_text(path)?
if text.strip_edges().is_empty():
return "", Err("Message is empty", Err.INVALID_DATA, {"path": path})
return text, null
# Print the message or report the failure to the caller.
func main() -> int:
var text, err := read_message("message.txt")
if err != null:
printerr(err)
return 1
print(text)
return 0printf 'Hello!\n' > message.txt
gd read_message.gd
printf '' > message.txt
gd read_message.gd最初の実行はHello!を表示し、空ファイルにした後の実行はMessage is emptyというエラーを表示して終了コード1を返します。
read_messageの-> String, Errは、文字列とエラーを返す宣言です。成功時はreturn text, null、失敗時はreturn "", Err(...)で二つの値を返します。呼び出し側はvar text, err := read_message(...)で受け取り、errを確認してからtextを使います。ファイルを読めなかったときは、?が読み込みのエラーをそのまま返します。
エラーの内容を確認する
Errには、エラーの種類、説明文、追加情報が入っています。原因の種類を調べるにはErr.findを使います。e.find({"source": "postgres", "code": "40001"})なら、同じ原因にある追加情報を照合できます。e.note("処理", {"code": "E_0008"})で情報を付けても、元の原因は残ります。説明文の文字列だけで種類を判断しないでください。
大きな入力を処理する
GD.file.openでストリームを取得すると、ファイル全体を確保せず分割して読めます。読み取り位置や量はバイト単位で指定します。文字数ではありません。途中で処理を止める場合も、自分が開いたストリームを閉じてください。
権限
はじめは通常の実行方法を使います。アクセス権限を細かく制限する--strictは上級者向けです。利用するファイルや接続先を指定して実行します。相対パスは実行ディレクトリを基準にし、絶対パスで指定しただけでは権限は付与されません。運用でstrictを使う前に権限の手引きを確認してください。