CharEnumerator Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Admite la iteración en un objeto String y la lectura de sus caracteres individuales. Esta clase no puede heredarse.
public ref class CharEnumerator sealed : ICloneable, System::Collections::Generic::IEnumerator<char>public ref class CharEnumerator sealed : ICloneable, System::Collections::IEnumeratorpublic 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 IDisposablePublic NotInheritable Class CharEnumerator
Implements ICloneable, IEnumerator(Of Char)Public NotInheritable Class CharEnumerator
Implements ICloneable, IEnumerator- Herencia
-
CharEnumerator
- Atributos
- Implementaciones
Ejemplos
En el ejemplo siguiente se usa la CharEnumerator clase para enumerar los caracteres individuales de una cadena. Crea una instancia de un CharEnumerator objeto llamando al String.GetEnumerator método , se mueve de un carácter a otro llamando al MoveNext método y muestra el carácter actual recuperando el valor de la Current propiedad .
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
Sin embargo, tenga en cuenta que la misma operación se puede realizar de forma más intuitiva mediante foreach (en C#) o For Each (en Visual Basic), como se muestra en el ejemplo siguiente.
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
Comentarios
Proporciona CharEnumerator acceso de solo lectura a los caracteres de un objeto al que se hace String referencia. Por ejemplo, la foreach instrucción de los lenguajes de programación Microsoft Visual Basic y C#, que recorre en iteración los elementos de una colección, recupera un CharEnumerator objeto de un String objeto para recorrer en iteración los caracteres de ese objeto.
Importante
La CharEnumerator clase enumera instancias individuales de 16 bits Char . No tiene en cuenta los grafemas (es decir, un carácter seguido de uno o varios caracteres de bidificación) o pares suplentes (es decir, caracteres fuera del plano multilingüe básico unicode) como caracteres únicos. Para un enumerador que controla estos tipos de caracteres como una sola unidad, use la StringInfo clase .
No hay ningún constructor público para CharEnumerator. En su lugar, llame al método de GetEnumerator un String objeto para obtener un CharEnumerator que se inicializa para hacer referencia a la cadena.
mantiene CharEnumerator un índice interno a los caracteres de la cadena a las CharEnumerator referencias. El estado del índice no es válido cuando hace referencia a una posición de carácter lógicamente antes del primer carácter o después del último carácter de la cadena, y es válido cuando hace referencia a un carácter dentro de la cadena. El índice se inicializa en una posición lógicamente antes del primer carácter y se establece en una posición después del último carácter cuando se completa la iteración. Se produce una excepción si intenta tener acceso a un carácter mientras el índice no es válido.
El MoveNext método incrementa el índice en uno, por lo que se accede a los caracteres primero y posteriores a su vez. El Reset método establece el índice en una posición lógicamente antes del primer carácter. La Current propiedad recupera el carácter al que hace referencia actualmente el índice. El Clone método crea una copia de .CharEnumerator
Nota:
Varias instancias independientes de CharEnumerator en uno o varios subprocesos pueden tener acceso a una sola instancia de String. Esta clase se implementa para admitir la IEnumerator interfaz . Para obtener más información sobre el uso de un enumerador, consulte el IEnumerator tema .
Propiedades
| Current |
Obtiene el carácter al que se hace referencia actualmente en la cadena enumerada por este objeto CharEnumerator. |
Métodos
| Clone() |
Crea una copia del objeto CharEnumerator actual. |
| Dispose() |
Libera todos los recursos usados por la instancia actual de la clase CharEnumerator. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| MoveNext() |
Incrementa el índice interno del objeto CharEnumerator actual hasta el siguiente carácter de la cadena enumerada. |
| Reset() |
Inicializa el índice en una posición situada lógicamente delante del primer carácter de la cadena enumerada. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Implementaciones de interfaz explícitas
| IDisposable.Dispose() |
Libera todos los recursos que utiliza la clase CharEnumerator. |
| IEnumerator.Current |
Obtiene el carácter al que se hace referencia actualmente en la cadena enumerada por este objeto CharEnumerator. Para obtener una descripción de este miembro, vea Current. |