std:env リファレンス

import env := "std:env" で取得する環境変数モジュール。環境変数の読み取り (get / get_or) とプログラム起動引数 (args) を提供する。

args

args()
args: { Effect(List(String), Proc) }

プログラム起動引数 (スクリプト名より後ろ) の List を返す。

効果ハンドラーの操作である。handle の操作スロットに args と書いて横取りできる（language-spec.md §17.9）。

>>> env.args()
[]

get(name)
get: { String | Effect(Option(String), Proc) }

環境変数 name を読む。未設定なら None。

効果ハンドラーの操作である。handle の操作スロットに get と書いて横取りできる（language-spec.md §17.9）。

>>> env.get("HIKARI_DOC_EXAMPLE_UNSET_VAR")
None

get_or(name, default)
get_or: { String, String | Effect(String, Proc) }

環境変数 name を読む。未設定なら default を返す。

効果ハンドラーの操作である。handle の操作スロットに get_or と書いて横取りできる（language-spec.md §17.9）。

>>> env.get_or("HIKARI_DOC_EXAMPLE_UNSET_VAR", "fallback")
"fallback"