Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::replace — reemplazar valores in situ

std::replace de <algorithm> reemplaza cada aparición de un valor especificado dentro de un rango de iteradores. Modifica los elementos existentes, conserva el tamaño del contenedor y devuelve void.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <algorithm>

template<class ForwardIt, class T>
constexpr void replace(ForwardIt first, ForwardIt last,
                       const T& old_value, const T& new_value);

std::replace(first, last, old_value, new_value);

std::replace(first, last, old_value, new_value) de <algorithm> asigna new_value a cada elemento para el que *i == old_value sea verdadero. El rango [first, last) incluye first, pero excluye last. El algoritmo modifica los valores in situ, sin quitar ni añadir elementos, y devuelve void, no el número de reemplazos.

La sobrecarga mostrada, sin política de ejecución, requiere un rango válido de iteradores de categoría forward como mínimo y que sea posible asignar new_value a través de un iterador. No basta con un iterador a elementos constantes. En C++23, ambos argumentos de valor participan en la deducción del mismo tipo T; usa tipos compatibles. El algoritmo realiza exactamente tantas comparaciones como elementos contiene el rango, por lo que su complejidad es O(N).

No pases old_value ni new_value como referencia a un elemento que el algoritmo pueda modificar: cambiar ese elemento puede afectar a comparaciones o asignaciones posteriores. Si es necesario, copia primero el valor en una variable independiente. Usa std::replace_if para seleccionar elementos mediante un predicado, o std::replace_copy para escribir el resultado en otro rango.

El ejemplo reemplaza cada 2 por 9. La declaración proporcionada corresponde a C++23; el borrador de norma en línea citado se actualiza con el tiempo y puede incluir extensiones posteriores.

Ejemplos

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

int main() {
    std::array<int, 5> values{2, 1, 2, 3, 2};
    std::replace(values.begin(), values.end(), 2, 9);

    for (std::size_t i = 0; i < values.size(); ++i) {
        if (i != 0) {
            std::cout << ' ';
        }
        std::cout << values[i];
    }
    std::cout << '\n';
}

Resultado

9 1 9 3 9

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes