java.lang
クラス System

java.lang.Object
  java.lang.System

public final class System
extends Object

Java 仮想マシンおよびホスト・システムに関連するアクセスおよびユーティリティを提供します。 このクラスの全てのメソッドはクラス・メソッドとして宣言されており、インスタンスを生成する必要はありません。 またインスタンスを生成することはできません。

導入されたバージョン:

CLDC 1.0

out

public static final PrintStream out

標準出力へ接続された PrintStream オブジェクトです。 このストリームはシステムによって開かれており、オープンすることなくデータを即出力することができます。

標準出力は OS の標準出力あるいはそれに類するものへ接続されています。

関連項目:

PrintStream

err

public static final PrintStream err

標準エラー出力へ接続された PrintStream オブジェクトです。 このストリームはシステムによって開かれており、オープンすることなくデータを即出力することができます。

標準エラー出力は OS の標準エラー出力あるいはそれに類するものへ接続されています。

関連項目:

PrintStream

currentTimeMillis

public static long currentTimeMillis()

現在時刻と協定世界時の UTC 1970 年 1 月 1 日午前 0 時からの差をミリ秒単位で返します。 この時間はローカライズされていません。

Java 仮想マシンの時間軸と実行しているデバイスの時間軸が別に存在し、必ずしも同期しない実装もあります。 これは Java 仮想マシンの実装の仕方の問題であり、Java の仕様の範囲外のためです。

戻り値:

ミリ秒単位の現在の時間を返します。

arraycopy

public static void arraycopy(Object src,
                             int srcIndex,
                             Object dst,
                             int dstIndex,
                             int count)

コピー元の配列オブジェクトの指定位置からをコピー先の配列オブジェクトの指定位置へ指定要素数分コピーします。 コピー元のオブジェクト配列 src 内の srcIndex が示す位置からコピー先のオブジェクト配列 dst 内の dstIndex が示す位置へ、count で指定された要素数をコピーします。 つまり、src 内の srcIndex が示す位置から srcIndex + count - 1 の位置までの要素を dst 内の dstIndex が示す位置から dstIndex + count - 1 の位置までにコピーします。

コピーを開始する前に、以下の順番でパラメータのチェックが行われます。 いずれかの例外が throw される場合にはコピーは行われません（コピー先の内容は変更されていません）。

1. src あるいは dst が null の場合、NullPointerException が throw されます。
2. 以下の条件のいずれかが true となる場合は ArrayStoreException が throw されます。
   • src あるいは dst が配列ではない場合。
   • src あるいは dst の片方のみがプリミティブ型の配列の場合。
   • src および dst が異なるプリミティブ型の配列の場合。
3. 以下の条件のいずれかが true となる場合は IndexOutOfBoundsException が throw されます。
   • srcIndex あるいは dstIndex、count が負数の場合。
   • srcIndex + count が src.length よりも大きい場合。
   • dstIndex + count が dst.length よりも大きい場合。

以上で問題がない場合、コピーを開始します。 コピー中にコピー元からコピー先へ代入変換が不可能なケースが発生した場合は ArrayStoreException が throw されます。 この際、例外が throw される原因となった位置の手前までコピーが完了しています。

パラメータ:

src - コピー元のオブジェクト配列を渡します。

srcIndex - 要素の取得を開始するコピー元配列内の位置を渡します。

dst - コピー先のオブジェクト配列を渡します。

dstIndex - 要素の格納を開始するコピー先配列内の位置を渡します。

count - コピーする要素数を渡します。

例外:

IndexOutOfBoundsException - コピー元あるいはコピー先の配列境界を越えるような組み合わせのパラメータで呼び出された場合に throw します。

ArrayStoreException - コピー元配列とコピー先配列の型が一致しない場合に throw します。

NullPointerException - src あるいは dst が null の場合に throw します。

identityHashCode

public static int identityHashCode(Object obj)

渡されたオブジェクトの Object クラスによる hashCode() メソッドによるハッシュコードを返します。 オブジェクトが hashCode() メソッドをオーバーライドしている場合でも Object クラスの hashCode() メソッドによるハッシュコードを返します。

なお、null が渡された場合、ハッシュコードとして 0 を返します。

パラメータ:

obj - ハッシュコードを取得する対象のオブジェクトを渡します。

戻り値:

ハッシュコードを返します。

getProperty

public static String getProperty(String name)

指定した名前のシステム・プロパティ値を返します。

Java Platform, Micro Edition では以下のプロパティが規定されています。

1. microedition.platform
   J2ME が稼動しているプラットフォームが設定されています。
2. microedition.encoding
   デフォルトで使用される文字エンコーディングが設定されています。
3. microedition.profiles
   使用可能なプロファイルが設定されています。
4. microedition.configuration
   現在稼動中のコンフィギュレーションが設定されています。

その他に以下のプロパティが設定されていることがあります。 これは実装に依存する部分であり、CLDC 規定の一部ではありません。

• microedition.protocolpath
  Generic Connection フレームワークでオープンする接続先クラスを格納したパッケージが設定されています。

パラメータ:

name - 読み出すプロパティ名を渡します。

戻り値:

対応する値を返します。対応する値が無い場合は null を返します。

exit

public static void exit(int status)

実行中のアプリケーションを終了します。パラメータで渡された値はステータス・コードとして使用され、通常 OS へ渡されます。

このメソッドは Runtime クラスの exit(int) メソッドを呼び出します。 このメソッドは呼び出し元へ処理が戻されることはありません。

なお、実装によってはアプリケーションを直接終了することを制限していることがあります。 この場合、実装によっては SecurityException 等が throw されることがあります。

パラメータ:

status - ステータス・コードを渡します。

関連項目:

Runtime.exit(int)

gc

public static void gc()

ガーベジ・コレクタを呼び出します。 このメソッドの呼び出しは Runtime クラスの gc() メソッドを呼び出すのと等価です。

呼び出されたガーベジ・コレクタは参照の外れたオブジェクトを破棄し、空きメモリを増やすように処理を行います。 メソッドの呼び出しが終了した時点で Java 仮想マシンが最適化したメモリ状態にあることになります。 なお、ガーベジ・コレクタが採用するアルゴリズムと回収できるメモリの量は実装に依存します。

CLDC ではガーベジ・コレクタがメモリ・コンパクションを行わない実装もあります。 この場合、小さなオブジェクトがメモリを分断し、全体のメモリ容量が足りていても大きなオブジェクトの生成を妨害することがあります。

明示的にガーベジ・コレクタを呼び出した場合の他に Java 仮想マシンは必要に応じてメイン・スレッドとは別のスレッドにおいてガーベジ・コレクタを実行します。

gc メソッドは garbage collector の頭文字から命名されています。