Compartir a través de


para cada, en

Utilice la instrucción de for each para iterar en una matriz o colección.

Todos los runtimes

Sintaxis

for each (type identifier in expression) {
   statements
}

Parámetros

  • type
    Tipo de identifier.

  • identifier
    La variable de iteración que representa el elemento de la colección.Cuando identifier es una referencia de seguimiento, puede modificar el elemento.

  • expression
    Una expresión o una colección de matriz.El compilador debe poder convertir el elemento de la colección al tipo de identifier.

  • statements
    Instrucción o instrucciones que se van a ejecutar.

Comentarios

La instrucción de for each se utiliza para recorrer en iteración una colección.Es posible modificar elementos en una colección, pero no puede agregar o eliminar elementos.

instrucciones se ejecuta para cada elemento de la matriz o colección.Cuando ya se han recorrido todos los elementos de la colección, el control se transfiere a la siguiente instrucción fuera del bloque for each.

for each y in son palabras clave contextuales; vea Palabras clave contextuales (Extensiones de componentes de C++) para obtener más información.

En el entorno de desarrollo, puede obtener ayuda de F1 en resaltando la palabra clave, (for each) y presione F1.

Para obtener más información, vea

Windows en tiempo de ejecución

(No hay notas Tiempo de ejecución- específicas de Windows para esta característica de lenguaje).

ms177202.collapse_all(es-es,VS.110).gifRequisitos

Opción del compilador: /ZW

ms177202.collapse_all(es-es,VS.110).gifEjemplos

Ejemplo

En este ejemplo se muestra cómo recorrer una cadena con for each.

// for_each_string1.cpp
// compile with: /ZW
#include <stdio.h>
using namespace Platform;

ref struct MyClass {
   property String^ MyStringProperty;
};

int main() {
   String^ MyString = ref new String("abcd");

   for each ( char c in MyString )
      wprintf("%c", c);

   wprintf("/n");

   MyClass^ x = ref new MyClass();
   x->MyStringProperty = "Testing";

   for each( char c in x->MyStringProperty )
      wprintf("%c", c);
}

Output

  
  

Common Language Runtime

La tabla siguiente se enumeran las diferencias de la sintaxis mostrada en la sección de Todos los runtimes específicas de C++/CLI.

Parámetros

  • expresión
    Una expresión o una colección de una matriz administrada.El compilador debe poder convertir el elemento de la colección de Object al tipo de identificador.

    expresión se evalúa como un tipo que implementa IEnumerable, IEnumerable<T>, o un tipo que defina un método GetEnumerator.En este último caso, GetEnumerator si cualquier valor devuelto un tipo que implementa IEnumerator o declare todos los métodos definidos en IEnumerator.

ms177202.collapse_all(es-es,VS.110).gifRequisitos

Opción del compilador: /clr

ms177202.collapse_all(es-es,VS.110).gifEjemplos

Ejemplo

En este ejemplo se muestra cómo recorrer una cadena con for each.

// for_each_string2.cpp
// compile with: /clr
using namespace System;

ref struct MyClass {
   property String ^ MyStringProperty;
};

int main() {
   String ^ MyString = gcnew String("abcd");

   for each ( Char c in MyString )
      Console::Write(c);

   Console::WriteLine();

   MyClass ^ x = gcnew MyClass();
   x->MyStringProperty = "Testing";

   for each( Char c in x->MyStringProperty )
      Console::Write(c);
}

Output

  
  

Vea también

Conceptos

Extensiones de componentes para plataformas de tiempo de ejecución