CharEnumerator クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CharEnumerator クラス

String オブジェクトの反復処理と個別の文字の読み取りをサポートします。このクラスは継承できません。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 CharEnumerator
    Implements ICloneable, IEnumerator(Of Char),
 _
    IDisposable, IEnumerator

Visual Basic (使用法)

Dim instance As CharEnumerator

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public sealed class CharEnumerator : ICloneable,
 IEnumerator<char>, 
    IDisposable, IEnumerator

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class CharEnumerator sealed : ICloneable,
 IEnumerator<wchar_t>, 
    IDisposable, IEnumerator

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class CharEnumerator implements
 ICloneable, IEnumerator<char>, 
    IDisposable, IEnumerator

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public final class CharEnumerator implements
 ICloneable, IEnumerator<char>, 
    IDisposable, IEnumerator

解説

CharEnumerator は、参照先 String オブジェクトへの読み取り専用のアクセスを提供します。たとえば、Microsoft Visual Basic および C# プログラミング言語の foreach ステートメント (コレクションの要素を反復する) は、String オブジェクトから CharEnumerator を取得して、そのオブジェクトの文字を反復します。

CharEnumerator にはパブリックコンストラクタはありません。代わりに、String オブジェクトの GetEnumerator メソッドを呼び出して、その文字列を参照するように初期化された CharEnumerator を取得します。

CharEnumerator は、CharEnumerator が参照する文字列内の文字への内部インデックスを保持しています。インデックスが、文字列の先頭文字の前の位置または文字列の末尾の文字の後ろの位置を論理的に参照している場合は無効、文字列内の文字を参照している場合は有効です。インデックスは、先頭文字の前の位置で論理的に初期化され、反復が完了した時点で末尾の文字の後の位置に設定されます。インデックスが無効なときに文字にアクセスしようとすると、例外がスローされます。

MoveNext メソッドはインデックスを 1 インクリメントするため、先頭文字の次にその後続文字がアクセスされます。Reset メソッドは、インデックスを先頭文字の前の位置に論理的に設定します。Current プロパティは、インデックスが現在参照している文字を取得します。Clone メソッドは、CharEnumeratorのコピーを作成します。

メモ
1 つ以上のスレッドの CharEnumerator の複数のインスタンスから、String の 1 つのインスタンスにアクセスできます。このクラスは IEnumerator インターフェイスをサポートするために実装します。列挙子の使用方法の詳細については、IEnumerator のトピックを参照してください。