Range-based for — instrukcja (C++)

statement Wykonuje wielokrotnie i sekwencyjnie dla każdego elementu w pliku expression.

Składnia

for (wyrażenie deklaracji:zakresu)
Instrukcja

Uwagi

Użyj instrukcji opartej na for zakresie, aby skonstruować pętle, które muszą być wykonywane przez zakres, który jest zdefiniowany jako dowolny element, przez który można iterować — na przykład std::vector, lub dowolną inną sekwencję biblioteki standardowej języka C++, której zakres jest zdefiniowany przez element begin() i end(). Nazwa zadeklarowana w części jest lokalna dla for-range-declaration instrukcji i nie można jej ponownie zadeklarować w expression pliku lub statementfor . Zwróć uwagę, że auto słowo kluczowe jest preferowane w for-range-declaration części instrukcji .

Nowość w programie Visual Studio 2017: pętle oparte na for zakresie nie wymagają już tego begin() i end() zwracają obiekty tego samego typu. Umożliwia end() to zwrócenie obiektu sentinel, takiego jak używany przez zakresy zdefiniowane w propozycji Ranges-V3. Aby uzyskać więcej informacji, zobacz Uogólnienie pętli opartej na For zakresie i biblioteki range-v3 w usłudze GitHub.

W tym kodzie pokazano, jak używać pętli opartych na for zakresie do iterowania tablicy i wektora:

// 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;
}

Oto dane wyjściowe:

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

Pętla oparta na for zakresie kończy się, gdy jeden z tych elementów jest statement wykonywany: break, returnlub goto do instrukcji oznaczonej etykietą poza pętlą opartą na for zakresie. Instrukcja continue w pętli opartej na for zakresie kończy tylko bieżącą iterację.

Pamiętaj o tych faktach dotyczących zakresu:for

  • Automatycznie rozpoznaje tablice.

  • Rozpoznaje kontenery, które mają .begin() i .end().

  • Używa wyszukiwania zależnego od argumentów begin() i end() innych elementów.

Zobacz też

auto
Instrukcje iteracji
Słowa kluczowe
while Instrukcja (C++)
do-while Instrukcja (C++)
for Instrukcja (C++)