AE環境変数の接頭辞

AE 環境接頭辞は環境キー名の前に付加され、AE ランタイムシステムに指示を与える。接頭辞は処理されて取り除かれ、実際のキー名だけが残る。複数の接頭辞を使用することもできるが、優先順位によって決定される明確な順序で出現しなければならない。

優先レベル0

これらの接頭辞がある場合、環境変数はホストかS-Blade（SPU）のどちらかに制限される。

NZAE_HOST_ONLY_
NZAE_SPU_ONLY_

優先順位レベル1

この接頭辞が存在すると、 AE ランタイムは変数名（%{{ } または共有ライブラリ名の置換（%[ ]）を行わないよう指示します。

NZAE_NO_SUBSTITUTE_ :

優先順位レベル2

これらの接頭辞は、値が既存の環境値に追加または前置されることを示す。キーが定義されていない場合は、この値で作成される。 AEランタイムは、まずAE環境キーを検索し、次にLinuxOS環境キーを検索して既存の値を見つける。

NZAE_APPEND_
NZAE_PREPEND_

AE 環境変数インクルードファイル」の項で説明するように、 AE 環境変数を含むファイルをインクルードするには以下の接頭辞を使用する。 NZAE_INCLUDE_BEFOREとNZAE_INCLUDE_AFTER_はインクルードファイルで使用できますが、処理順序には影響しません。接頭辞は優先順位の低いものから高いものへと並べなければならない。 1つのキーで使用できるのは、各優先度レベルからの1つのエントリのみである。詳細は、変数の解析順序を参照のこと。

NZAE_INCLUDE_;
NZAE_INCLUDE_BEFORE_;
NZAE_INCLUDE_AFTER_;

以下の例では、Sブレードでのみ使用される既存のキー「MY_RANDOM_ASCII_CHARS」を示している。変数や共有ライブラリの置換は望ましくないが、"%["や"%{"シーケンスが可能なので、起こるかもしれない。このキーに対応する環境値がすでに存在する場合、その値はそのキーの後に追加されなければならない：

NZAE_SPU_ONLY_NZAE_NO_SUBSTITUTE_NZAE_APPEND_MY_RANDOM_ASCII_CHARS="a789%[ [[%%%
{}}}89 90"

この例は、プレフィックスの使い方を最も一般的な形で示したものである。