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

CKTIS / C++

std::fill: atribuir um valor a um intervalo

std::fill atribui value a cada elemento do intervalo semiaberto [first, last) e em C++23 devolve void.

Versão: C++23

Sintaxe

template<class ForwardIterator, class T>
constexpr void std::fill(
    ForwardIterator first, ForwardIterator last, const T& value);

template<class ExecutionPolicy, class ForwardIterator, class T>
void std::fill(ExecutionPolicy&& exec,
    ForwardIterator first, ForwardIterator last, const T& value);

std::fill(first, last, value) de <algorithm> efetua exatamente N atribuições através dos iteradores, sendo N o número de elementos. value tem de poder ser escrito pelo iterador. A sobrecarga sem política é constexpr e exige iteradores forward.

O exemplo preenche apenas o meio de um array com 9 e imprime 1 9 9 4; o elemento em last fica fora. Um intervalo vazio faz zero atribuições. Se precisares do iterador final ou de passar um range inteiro, ranges::fill oferece outra interface.

first e last têm de formar um intervalo válido com elementos modificáveis; um range const não pode ser preenchido. Sem política, uma exceção de atribuição propaga-se e elementos anteriores podem já ter mudado. Com uma política padrão, uma exceção não capturada de uma operação sobre elementos chama std::terminate. Se faltar memória temporária necessária à paralelização, a sobrecarga com política lança antes std::bad_alloc.

Exemplos

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    std::array values{1, 2, 3, 4};
    std::fill(values.begin() + 1, values.end() - 1, 9);
    std::cout << values[0] << ' ' << values[1] << ' '
              << values[2] << ' ' << values[3] << '\n';
}

Resultado

1 9 9 4

std::fill → 1 9 9 4

Fontes