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

CKTIS / C++

Operador de encadeamento `|` de adaptadores de intervalos

O operador `|` aplica um fecho de adaptador a um intervalo ou combina dois fechos numa cadeia reutilizável. Esta sobrecarga é distinta do OU bit a bit.

Versão: ISO C++23; implementation support may vary

Sintaxe

r | c
c | d
r | c | d
r | (c | d)
r | std::views::filter(pred) | std::views::transform(fn)

Em <ranges>, r | c usa uma sobrecarga de operator| e equivale a c(r) se c for um fecho de adaptador que aceita o intervalo r. std::views::filter(pred) associa o predicado sem fornecer ainda o intervalo. std::views é um alias do espaço de nomes std::ranges::views.

c | d cria um fecho que guarda ambas as etapas sem receber ainda um intervalo. r | c | d agrupa-se como (r | c) | d, ao passo que r | (c | d) compõe primeiro as etapas. Se ambas as formas forem válidas, o intervalo passa por c e depois por d, como em d(c(r)). A composição exige, no entanto, que os fechos guardados sejam inicializados a partir dos operandos. Por exemplo, um fecho que se pode mover, mas não copiar, pode admitir uma aplicação direta como lvalue, embora compô-lo a partir desse lvalue exigisse uma cópia. Já 1 | 2 usa o OU bit a bit incorporado e dá 3. Uma função lambda comum à direita não basta: r | pred é inválido sem uma sobrecarga adequada.

filter deixa passar apenas os elementos que satisfazem o predicado, e transform calcula o resultado quando se lê um elemento. A cadeia produz uma vista, não um novo contentor de resultados. No exemplo, a vista utiliza values por referência; o array tem de continuar a existir enquanto se usa a vista. O mesmo se aplica aos objetos capturados por referência e usados pelas etapas.

Os adaptadores padrão filter e transform podem ser encadeados com | desde C++20. O C++23 acrescenta std::ranges::range_adaptor_closure para definir fechos próprios compatíveis com |. O suporte depende da biblioteca padrão e do modo de compilação selecionado.

Exemplos

#include <array>
#include <iostream>
#include <ranges>

int main() {
    const std::array values{1, 2, 3, 4, 5};
    auto pipeline = std::views::filter([](int n) { return n % 2 == 0; })
                  | std::views::transform([](int n) { return n * 10; });

    auto result = values | pipeline;
    for (int n : result) {
        std::cout << n << '\n';
    }
}

Resultado

20
40

O programa compõe primeiro as duas etapas e depois aplica-as a `values`. Escreve `20` e `40` em linhas separadas.

Lições relacionadas

  • C++ · Lição 26 · Avançado · Versão: 3
  • C++ · Lição 29 · Avançado · Versão: 3

Fontes