gdドキュメント0.8.0

はじめてのgdスクリプト

English | 日本語

gdはターミナルからGDScriptを実行します。1つのファイルから始められ、シーンやプロジェクトファイルは必要ありません。

インストールと確認

導入ガイドで現在のリリースをインストールして確認します。

gd --version

次の内容をhello.gdに保存します。

func main():
    print("Hello, world!")
    return 0
gd hello.gd

mainが実行の入口です。0を返すとシェルには成功が伝わり、0以外の終了コードは失敗を表します。

引数を読む

mainはコマンドライン引数を受け取れます。入力の確認はスクリプトの入口で行います。

func main(args):
    var name := "world" if args.is_empty() else str(args[0])
    print("Hello, ", name, "!")
    return 0
gd hello.gd Ada

名前付きのオプションはGD.cliとGDCLIFlagsを使います。

引数と戻り値の読み方

APIリファレンスでは、関数名・引数・戻り値を次のように表します。

read_text(path: String) -> String, Err

エラー情報がnullなら成功で、文字列には読み取った内容が入ります。エラーがある場合は、その内容を確認してから処理を続けるか判断します。実際の受け取り方は、次の「ファイルとエラー処理」で説明します。

時間のかかる関数については、そのまま呼ぶだけで結果を待てるか、awaitを書いて完了を待つ必要があるかも説明しています。

ファイルとエラー処理でエラーの扱いを学び、Webサービスでは同じ考え方をリクエスト処理に使います。

次に読む