Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::views::take_while — um prefixo que satisfaz uma condição

std::views::take_while cria uma vista preguiçosa dos elementos iniciais do intervalo que satisfazem um predicado. Termina antes do primeiro elemento que não satisfaz a condição e não retoma a procura de correspondências posteriores.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

std::views::take_while(range, pred)
range | std::views::take_while(pred)

std::views::take_while é um adaptador de intervalos que cria uma std::ranges::take_while_view. Use std::views::take_while(range, pred) ou range | std::views::take_while(pred). A vista inclui os elementos consecutivos desde o início até ao primeiro resultado false, excluindo o elemento que o causou. Se o primeiro elemento não satisfizer a condição, o resultado é vazio; se todos os elementos a satisfizerem, a vista abrange todo o intervalo.

A vista é preguiçosa: a sua criação não constrói um contentor de resultados separado. A condição é verificada durante a iteração, ao comparar o iterador com o sentinela de fim. Não pressuponha que o predicado é chamado exatamente uma vez por elemento, nem faça depender o resultado de um contador de chamadas. O predicado tem de satisfazer indirect_unary_predicate<const Pred, iterator_t<V>> e a vista subjacente V tem de satisfazer input_range.

No exemplo, x < 5 aceita 2 e 4; 7 termina a vista. Os valores seguintes, 1 e 3, não são incluídos: é selecionado um prefixo, não todos os elementos correspondentes. O array values tem de continuar válido enquanto a vista que lhe faz referência estiver a ser usada.

Numa entrada de passagem única, como um fluxo, identificar o elemento que termina a vista pode já lê-lo da origem. Por isso, não pressuponha que continua disponível para a extração seguinte do fluxo.

Exemplos

#include <iostream>
#include <ranges>

int main() {
    int values[] = {2, 4, 7, 1, 3};
    auto prefix = values | std::views::take_while([](int x) {
        return x < 5;
    });

    bool first = true;
    for (int x : prefix) {
        if (!first) std::cout << ' ';
        std::cout << x;
        first = false;
    }
    std::cout << '\n';
}

Resultado

2 4

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes