Instrução for com base em intervalo (C++)

Executa statement repetidamente e em sequência para cada elemento em expression.

Sintaxe

for (for-range-declaration:expression)
  instrução

Comentários

Use a instrução baseada em intervalo for para construir loops que devem ser executados por meio de um intervalo, que é definido como qualquer coisa que você possa iterar — por exemplo, std::vector, ou qualquer outra sequência da Biblioteca Padrão C++ cujo intervalo seja definido por um begin() e end(). O nome que é declarado na parte for-range-declaration é local para a instrução for e não pode ser declarado novamente em expression ou em statement. Observe que a palavra-chaveauto é preferida na partefor-range-declaration da instrução.

Novo no Visual Studio 2017: loops baseados em intervalofor não exigem mais que begin() e end() retornem objetos do mesmo tipo. Isso permite que end() retorne um objeto sentinela, como usado por intervalos, conforme definido na proposta Ranges-V3. Para obter mais informações, consulte Generalização com base no intervalo ForLoop e a bibliotecarange-v3 no GitHub.

Este código mostra como usar loops for com intervalo para iterar por uma matriz e um vetor:

// range-based-for.cpp
// compile by using: cl /EHsc /nologo /W4
#include <iostream>
#include <vector>
using namespace std;

int main()
{
    // Basic 10-element integer array.
    int x[10] = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };

    // Range-based for loop to iterate through the array.
    for( int y : x ) { // Access by value using a copy declared as a specific type.
                       // Not preferred.
        cout << y << " ";
    }
    cout << endl;

    // The auto keyword causes type inference to be used. Preferred.

    for( auto y : x ) { // Copy of 'x', almost always undesirable
        cout << y << " ";
    }
    cout << endl;

    for( auto &y : x ) { // Type inference by reference.
        // Observes and/or modifies in-place. Preferred when modify is needed.
        cout << y << " ";
    }
    cout << endl;

    for( const auto &y : x ) { // Type inference by const reference.
        // Observes in-place. Preferred when no modify is needed.
        cout << y << " ";
    }
    cout << endl;
    cout << "end of integer array test" << endl;
    cout << endl;

    // Create a vector object that contains 10 elements.
    vector<double> v;
    for (int i = 0; i < 10; ++i) {
        v.push_back(i + 0.14159);
    }

    // Range-based for loop to iterate through the vector, observing in-place.
    for( const auto &j : v ) {
        cout << j << " ";
    }
    cout << endl;
    cout << "end of vector test" << endl;
}

Aqui está a saída:

1 2 3 4 5 6 7 8 9 10
1 2 3 4 5 6 7 8 9 10
1 2 3 4 5 6 7 8 9 10
1 2 3 4 5 6 7 8 9 10
end of integer array test

0.14159 1.14159 2.14159 3.14159 4.14159 5.14159 6.14159 7.14159 8.14159 9.14159
end of vector test

Um loopfor baseado em intervalo termina quando um desses em statement é executado: a break, return, ou goto para uma instrução rotulada fora do loopfor baseado em intervalo. Uma instrução continue em um loop baseado em intervalofor encerra apenas a iteração atual.

Lembre-se destes fatos sobre base em intervalofor:

• Reconhece matrizes automaticamente.

• Reconhece os contêineres que têm .begin() e .end().

• Usa a pesquisa dependente de argumentos begin() e end() para qualquer outra coisa.

Confira também

auto
Instruções de Iteração
Palavras-chave
while Instrução (C++)
do-while Instrução (C++)
for Instrução (C++)