CharEnumerator Classe

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Dá suporte à iteração em um objeto String e leitura de seus caracteres individuais. Essa classe não pode ser herdada.

public ref class CharEnumerator sealed : ICloneable, System::Collections::Generic::IEnumerator<char>

public ref class CharEnumerator sealed : ICloneable, System::Collections::IEnumerator

public sealed class CharEnumerator : ICloneable, System.Collections.Generic.IEnumerator<char>

[System.Serializable]
public sealed class CharEnumerator : ICloneable, System.Collections.IEnumerator

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class CharEnumerator : ICloneable, System.Collections.Generic.IEnumerator<char>

type CharEnumerator = class
    interface IEnumerator<char>
    interface IEnumerator
    interface IDisposable
    interface ICloneable

[<System.Serializable>]
type CharEnumerator = class
    interface IEnumerator
    interface ICloneable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CharEnumerator = class
    interface ICloneable
    interface IEnumerator<char>
    interface IDisposable
    interface IEnumerator

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CharEnumerator = class
    interface ICloneable
    interface IEnumerator<char>
    interface IEnumerator
    interface IDisposable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CharEnumerator = class
    interface IEnumerator
    interface ICloneable
    interface IEnumerator<char>
    interface IDisposable

Public NotInheritable Class CharEnumerator
Implements ICloneable, IEnumerator(Of Char)

Public NotInheritable Class CharEnumerator
Implements ICloneable, IEnumerator

Herança: Object
CharEnumerator

Atributos: SerializableAttribute ComVisibleAttribute

Implementações: IEnumerator<Char> IEnumerator ICloneable IDisposable

Exemplos

O exemplo a seguir usa a CharEnumerator classe para enumerar os caracteres individuais em uma cadeia de caracteres. Ele cria uma instância de um CharEnumerator objeto chamando o String.GetEnumerator método, passa de um caractere para o outro chamando o MoveNext método e exibe o caractere atual recuperando o valor da Current propriedade.

String ^ title = "A Tale of Two Cities";
CharEnumerator ^ chEnum = title->GetEnumerator();
int ctr = 1;
String ^ outputLine1 = nullptr;
String ^ outputLine2 = nullptr;
String ^ outputLine3 = nullptr; 

while (chEnum->MoveNext())
{
   outputLine1 += ctr < 10 || ctr % 10 != 0 ? "  " : (ctr / 10) + " ";
   outputLine2 += (ctr % 10) + " ";
   outputLine3 += chEnum->Current + " ";
   ctr++;
}

Console::WriteLine("The length of the string is {0} characters:", 
                  title->Length);
Console::WriteLine(outputLine1);
Console::WriteLine(outputLine2);    
Console::WriteLine(outputLine3);
// The example displays the following output to the console:      
//       The length of the string is 20 characters:
//                         1                   2
//       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
//       A   T a l e   o f   T w o   C i t i e s

string title = "A Tale of Two Cities";
CharEnumerator chEnum = title.GetEnumerator();
int ctr = 1;
string outputLine1 = null;
string outputLine2 = null;
string outputLine3 = null;

while (chEnum.MoveNext())
{
   outputLine1 += ctr < 10 || ctr % 10 != 0 ? "  " : (ctr / 10) + " ";
   outputLine2 += (ctr % 10) + " ";
   outputLine3 += chEnum.Current + " ";
   ctr++;
}

Console.WriteLine("The length of the string is {0} characters:",
                  title.Length);
Console.WriteLine(outputLine1);
Console.WriteLine(outputLine2);
Console.WriteLine(outputLine3);
// The example displays the following output to the console:
//       The length of the string is 20 characters:
//                         1                   2
//       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
//       A   T a l e   o f   T w o   C i t i e s

let title = "A Tale of Two Cities"
let chEnum = title.GetEnumerator()

printfn $"The length of the string is {title.Length} characters:"

let mutable outputLine1 = ""
let mutable outputLine2 = ""
let mutable outputLine3 = ""
let mutable i = 1

while chEnum.MoveNext() do
    outputLine1 <- outputLine1 + if i < 10 || i % 10 <> 0 then "  " else $"{i / 10} "
    outputLine2 <- outputLine2 + $"{i % 10} ";
    outputLine3 <- outputLine3 + $"{chEnum.Current} "
    i <- i + 1

printfn "%s" outputLine1
printfn "%s" outputLine2
printfn "%s" outputLine3

// The example displays the following output to the console:
//       The length of the string is 20 characters:
//                         1                   2
//       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
//       A   T a l e   o f   T w o   C i t i e s

Dim title As String = "A Tale of Two Cities"
Dim chEnum As CharEnumerator = title.GetEnumerator()
Dim ctr As Integer = 1
Dim outputLine1, outputLine2, outputLine3 As String 

Do While chEnum.MoveNext()
   outputLine1 += CStr(iif(ctr < 10 Or ctr Mod 10 <> 0, "  ", CStr(ctr \ 10) + " ")) 
   outputLine2 += (ctr Mod 10)& " "
   outputLine3 += chEnum.Current & " "
   ctr += 1
Loop

Console.WriteLine("The length of the string is {0} characters:", _
                  title.Length)
Console.WriteLine(outputLine1)
Console.WriteLine(outputLine2)    
Console.WriteLine(outputLine3)
' The example displays the following output to the console:      
'       The length of the string is 20 characters:
'                         1                   2
'       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
'       A   T a l e   o f   T w o   C i t i e s

Observe, no entanto, que a mesma operação pode ser executada de forma um pouco mais intuitiva usando foreach (em C#) ou For Each (em Visual Basic), como mostra o exemplo a seguir.

String ^ title = "A Tale of Two Cities";
int ctr = 1;
String ^ outputLine1 = nullptr;
String ^ outputLine2 = nullptr;
String ^ outputLine3 = nullptr; 

for each (wchar_t ch in title)
{
   outputLine1 += ctr < 10 || ctr % 10 != 0 ? "  " : (ctr / 10) + " ";
   outputLine2 += (ctr % 10) + " ";
   outputLine3 += ch + " ";
   ctr++;
}

Console::WriteLine("The length of the string is {0} characters:", 
                  title->Length);
Console::WriteLine(outputLine1);
Console::WriteLine(outputLine2);    
Console::WriteLine(outputLine3);
// The example displays the following output to the console:      
//       The length of the string is 20 characters:
//                         1                   2
//       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
//       A   T a l e   o f   T w o   C i t i e s

string title = "A Tale of Two Cities";
int ctr = 1;
string outputLine1 = null;
string outputLine2 = null;
string outputLine3 = null;

foreach (char ch in title)
{
   outputLine1 += ctr < 10 || ctr % 10 != 0 ? "  " : (ctr / 10) + " ";
   outputLine2 += (ctr % 10) + " ";
   outputLine3 += ch + " ";
   ctr++;
}

Console.WriteLine("The length of the string is {0} characters:",
                  title.Length);
Console.WriteLine(outputLine1);
Console.WriteLine(outputLine2);
Console.WriteLine(outputLine3);
// The example displays the following output to the console:
//       The length of the string is 20 characters:
//                         1                   2
//       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
//       A   T a l e   o f   T w o   C i t i e s

let title = "A Tale of Two Cities"
let chEnum = title.GetEnumerator()

printfn $"The length of the string is {title.Length} characters:"

let mutable outputLine1 = ""
let mutable outputLine2 = ""
let mutable outputLine3 = ""
let mutable i = 1

for ch in title do
    outputLine1 <- outputLine1 + if i < 10 || i % 10 <> 0 then "  " else $"{i / 10} "
    outputLine2 <- outputLine2 + $"{i % 10} ";
    outputLine3 <- outputLine3 + $"{ch} "
    i <- i + 1

printfn "%s" outputLine1
printfn "%s" outputLine2
printfn "%s" outputLine3

// The example displays the following output to the console:
//       The length of the string is 20 characters:
//                         1                   2
//       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
//       A   T a l e   o f   T w o   C i t i e s

Dim title As String = "A Tale of Two Cities"
Dim ctr As Integer = 1
Dim outputLine1, outputLine2, outputLine3 As String 

For Each ch As Char In title
   outputLine1 += CStr(iif(ctr < 10 Or ctr Mod 10 <> 0, "  ", CStr(ctr \ 10) + " ")) 
   outputLine2 += (ctr Mod 10)& " "
   outputLine3 += ch & " "
   ctr += 1
Next

Console.WriteLine("The length of the string is {0} characters:", _
                  title.Length)
Console.WriteLine(outputLine1)
Console.WriteLine(outputLine2)    
Console.WriteLine(outputLine3)
' The example displays the following output to the console:      
'       The length of the string is 20 characters:
'                         1                   2
'       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
'       A   T a l e   o f   T w o   C i t i e s

Comentários

Um CharEnumerator fornece acesso somente leitura aos caracteres em um objeto referenciado String . Por exemplo, a foreach instrução das linguagens de programação microsoft Visual Basic e C#, que itera por meio dos elementos de uma coleção, recupera um CharEnumerator de um String objeto para iterar por meio dos caracteres nesse objeto.

Importante

A CharEnumerator classe enumera instâncias individuais de 16 bits Char . Ele não considera grafemes (ou seja, um caractere seguido por um ou mais caracteres de combinação) ou pares substitutos (ou seja, caracteres fora do Plano Multilíngue Básico Unicode) como caracteres únicos. Para um enumerador que manipula esses tipos de caracteres como uma única unidade, use a StringInfo classe.

Não há construtor público para CharEnumerator. Em vez disso, chame o método de GetEnumerator um String objeto para obter um CharEnumerator inicializado para fazer referência à cadeia de caracteres.

A CharEnumerator mantém um índice interno para os caracteres na cadeia de caracteres que as CharEnumerator referências. O estado do índice é inválido quando faz referência a uma posição de caractere logicamente antes do primeiro caractere ou após o último caractere na cadeia de caracteres e válido quando ele faz referência a um caractere dentro da cadeia de caracteres. O índice é inicializado para uma posição logicamente antes do primeiro caractere e é definido como uma posição após o último caractere quando a iteração é concluída. Uma exceção será gerada se você tentar acessar um caractere enquanto o índice for inválido.

O MoveNext método incrementa o índice por um, de modo que os primeiros e os caracteres subsequentes sejam acessados por sua vez. O Reset método define o índice como uma posição logicamente antes do primeiro caractere. A Current propriedade recupera o caractere referenciado atualmente pelo índice. O Clone método cria uma cópia do CharEnumerator.

Observação

Várias instâncias independentes de CharEnumerator um ou mais threads podem ter acesso a uma única instância de String. Essa classe é implementada para dar suporte à IEnumerator interface. Para obter mais informações sobre o uso de um enumerador, consulte o IEnumerator tópico.

Propriedades

Current

Obtém o caractere atualmente referenciado na cadeia de caracteres enumerada por este objeto CharEnumerator.

Métodos

Clone()	Cria uma cópia do objeto CharEnumerator atual.
Dispose()	Libera todos os recursos usados pela instância atual da classe CharEnumerator.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MoveNext()	Incrementa o índice interno do objeto CharEnumerator atual para o próximo caractere da cadeia de caracteres enumerada.
Reset()	Inicializa o índice para uma posição logicamente antes do primeiro caractere da cadeia de caracteres enumerada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()	Libera todos os recursos usados pela classe CharEnumerator.
IEnumerator.Current	Obtém o caractere atualmente referenciado na cadeia de caracteres enumerada por este objeto CharEnumerator. Para obter uma descrição desse membro, confira Current.

Aplica-se a