Java Vector clear() メソッド

Java Vector Java Vector

clear()メソッドはVectorクラスが提供する一般的なメソッドで、コレクション内のすべての要素を削除するために使用されます。

public void clear()

メソッドの機能

clear()メソッドの主な機能は、Vector内のすべての要素をクリアして、空のコレクションにすることです。このメソッドを呼び出すと、Vectorのsize()は 0 を返しますが、capacity()は変わりません。

主な特徴

  • 削除するVector内のすべての要素
  • 将 Vectorのサイズ(size)を 0 にリセットする
  • 変更しないVectorの容量(capacity)
  • この操作の時間計算量は O(n) で、n はVectorのサイズです

メソッドの実装原理

Java のVectorクラスでは、clear()メソッドの実装は実際にはremoveAllElements()メソッドを呼び出すことで完了します:

例

public void clear() {
    removeAllElements();
}

removeAllElements()メソッドの内部実装はVector内のすべての要素を走査し、各位置をnullに設定し、同時に要素カウンタを 0 にリセットします。

ソースコード分析

例

public synchronized void removeAllElements() {
    modCount++;
    // すべての要素を null に設定
    for (int i = 0; i < elementCount; i++)
        elementData[i] = null;
    elementCount = 0;  // 要素カウンタをリセット
}

使用例

基本的な使い方

例

import java.util.Vector;

public class VectorClearExample {
    public static void main(String[] args) {
        // Vector を作成して要素を追加
        Vector<String> fruits = new Vector<>();
        fruits.add("Apple");
        fruits.add("Banana");
        fruits.add("Orange");
       
        System.out.println("クリア前の Vector: " + fruits);
        System.out.println("クリア前のサイズ: " + fruits.size());
       
        // clear() メソッドを使用して Vector をクリア
        fruits.clear();
       
        System.out.println("クリア後の Vector: " + fruits);
        System.out.println("クリア後のサイズ: " + fruits.size());
    }
}

出力結果

清空前的 Vector: [Apple, Banana, Orange]
清空前的大小: 3
清空后的 Vector: []
清空后的大小: 0

removeAllElements() との関係

例

Vector<Integer> numbers = new Vector<>();
numbers.add(1);
numbers.add(2);
numbers.add(3);

// clear() と removeAllElements() の効果は同じ
numbers.clear();  // Vector をクリア
// 次と同等
// numbers.removeAllElements();

注意事項

容量は変わらない

clear()メソッドはVector内の要素をクリアするだけで、その容量は変更されません。容量も同時に減らす必要がある場合は、trimToSize()メソッドを呼び出すことができます:

例

Vector<String> items = new Vector<>(20);  // 初期容量は 20
items.add("A");
items.add("B");
items.add("C");

items.clear();  // 要素をクリアしても、容量は 20 のまま
items.trimToSize();  // 容量を現在のサイズ(0)に調整

スレッドセーフ

Vectorはスレッドセーフであり、clear()メソッドも同期(synchronized)されており、マルチスレッド環境で安全に使用できます。

ArrayList との違い

一方、ArrayListにもclear()メソッドがありますが、Vectorのclear()は同期されていますが、ArrayListのメソッドは同期されていません:

例

// Vector の clear() は同期されている
public synchronized void clear() {
    removeAllElements();
}

// ArrayList の clear() は同期されていない
public void clear() {
    modCount++;
    for (int i = 0; i < size; i++)
        elementData[i] = null;
    size = 0;
}

よくある質問

Q1: clear() メソッドはメモリを解放しますか?

clear()メソッドはすべての要素参照をnullに設定するため、これらのオブジェクトはガベージコレクタによって回収可能になります(他の参照がそれらを指していない場合)。ただし、Vector内部の配列自体は解放されず、その中の要素がクリアされるだけです。

Q2: clear() と new Vector() の違いは何ですか?

  • clear()既存のVectorオブジェクトを再利用し、その中の要素をクリアするだけです
  • new Vector()新しいVectorオブジェクトを作成します。古いVectorは他の参照がなければガベージコレクションされます

Q3: Vector が空かどうかを判断するには?

使用できるのはisEmpty()メソッドです:

例

Vector<String> v = new Vector<>();
v.clear();
if (v.isEmpty()) {
    System.out.println("Vector は空です");
}

まとめ

Vectorのclear()メソッドは、コレクション内のすべての要素をすばやくクリアするためのシンプルかつ実用的なツールです。その動作原理と特徴を理解することは、より効率的な Java コードを書くのに役立ちます。容量やスレッドセーフティに関連する特性と、特定のシナリオでのベストプラクティスを覚えておきましょう。

Java Vector Java Vector

その他の拡張