JavaSystem.Getenv メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
Getenv() |
現在のシステム環境の変更できない文字列マップ ビューを返します。 |
Getenv(String) |
指定した環境変数の値を取得します。 |
Getenv()
現在のシステム環境の変更できない文字列マップ ビューを返します。
[Android.Runtime.Register("getenv", "()Ljava/util/Map;", "")]
public static System.Collections.Generic.IDictionary<string,string> Getenv ();
[<Android.Runtime.Register("getenv", "()Ljava/util/Map;", "")>]
static member Getenv : unit -> System.Collections.Generic.IDictionary<string, string>
戻り値
環境変数の値へのマップとしての環境
- 属性
注釈
現在のシステム環境の変更できない文字列マップ ビューを返します。 環境は、名前から値へのシステム依存のマッピングであり、親プロセスから子プロセスに渡されます。
システムが環境変数をサポートしていない場合は、空のマップが返されます。
返されるマップに null キーまたは値が含まれることはありません。 null キーまたは値の存在を照会しようとすると、 NullPointerException
がスローされます。 型 String
ではないキーまたは値の存在を照会しようとすると、 ClassCastException
がスローされます。
返されたマップとそのコレクション ビューは、 メソッドと Object#hashCode
メソッドの一般的なコントラクトにObject#equals
従わない可能性があります。
返されるマップは、通常、すべてのプラットフォームで大文字と小文字が区別されます。
セキュリティ マネージャーが存在する場合、その SecurityManager#checkPermission checkPermission
メソッドはアクセス許可を使用して {@link RuntimePermission}("getenv.*")
呼び出されます。 これにより、 が SecurityException
スローされる可能性があります。
Java サブプロセスに情報を渡す場合、一般に、システム プロパティは環境変数よりも優先されます。
1\.5 で追加されました。
の Java ドキュメント java.lang.System.getenv()
。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
Getenv(String)
指定した環境変数の値を取得します。
[Android.Runtime.Register("getenv", "(Ljava/lang/String;)Ljava/lang/String;", "")]
public static string? Getenv (string name);
[<Android.Runtime.Register("getenv", "(Ljava/lang/String;)Ljava/lang/String;", "")>]
static member Getenv : string -> string
パラメーター
- name
- String
環境変数の名前
戻り値
変数の文字列値、または null
変数がシステム環境で定義されていない場合
- 属性
注釈
指定した環境変数の値を取得します。 環境変数は、システム依存の外部の名前付き値です。
セキュリティ マネージャーが存在する場合、その SecurityManager#checkPermission checkPermission
メソッドはアクセス許可を使用して {@link RuntimePermission}("getenv."+name)
呼び出されます。 これにより、 が SecurityException
スローされる可能性があります。 例外がスローされない場合は、変数 name
の値が返されます。
"EnvironmentVSSystemProperties"><i>System properties</i> と <i>環境変数</i> は、どちらも名前と値の間の概念的なマッピングです。 どちらのメカニズムも、ユーザー定義情報を Java プロセスに渡すために使用できます。 環境変数は、即時の Java サブプロセスだけでなく、それらを定義するプロセスのすべての子孫に表示されるため、よりグローバルな効果があります。 異なるオペレーティング システムでは、大文字と小文字の区別など、微妙に異なるセマンティクスを持つことができます。 これらの理由から、環境変数は意図しない副作用を持つ可能性が高くなります。 可能な場合は、システム プロパティを使用することをお勧めします。 環境変数は、グローバル効果が必要な場合、または外部システム インターフェイスに環境変数 (など PATH
) が必要な場合に使用する必要があります。
UNIX システムでは、 のアルファベット順の name
大文字と小文字が一般的に重要ですが、Microsoft Windows システムでは通常は重要ではありません。 たとえば、Microsoft Windows では 式 System.getenv("FOO").equals(System.getenv("foo"))
が true になる可能性があります。
の Java ドキュメント java.lang.System.getenv(java.lang.String)
。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。