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

• Recorrer la colección mediante de Compilaciones STL para cada

• Cómo: Recorrer las matrices de Compilaciones con para cada

• Cómo: Recorra Compilaciones una colección genérica con para cada

• Cómo: Recorra Compilaciones una colección definido por el usuario y para cada

Windows en tiempo de ejecución

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

Requisitos

Opción del compilador: /ZW

Ejemplos

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.

Requisitos

Opción del compilador: /clr

Ejemplos

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