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

CKTIS / C++

std::setprecision — precisión del formato numérico

std::setprecision, de <iomanip>, establece la precisión de un flujo. Con std::defaultfloat, una precisión positiva fija el número máximo de cifras significativas. Con std::fixed y std::scientific, una precisión no negativa fija el número de cifras después del separador decimal; si es negativa, se muestran seis por defecto. El ajuste permanece activo para las operaciones siguientes.

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

Sintaxis

#include <iomanip>
// std::setprecision(int n) returns an object of unspecified type.
out << std::setprecision(n);
in >> std::setprecision(n);

std::setprecision(n), de <iomanip>, crea un manipulador cuyo tipo de retorno no está especificado por el estándar. La expresión out << std::setprecision(n) actúa como out.precision(n) y permite seguir encadenando con <<. Cambia el estado de formato del flujo, no el valor numérico almacenado.

El significado de n depende del modo. Con std::defaultfloat, para valores positivos es el número máximo de cifras significativas; la salida puede usar notación ordinaria o exponencial, y normalmente se omiten los ceros finales. Para n >= 0, std::fixed escribe n cifras después del separador decimal, y std::scientific escribe ese mismo número de cifras después del separador en la mantisa de la notación exponencial. El manipulador también acepta valores negativos de n y los guarda en el flujo. En ambos modos, el formato trata una precisión negativa como si no se hubiera indicado y usa por defecto seis cifras después del separador decimal. Con std::hexfloat, se ignora la precisión.

El formato redondea la representación textual, en lugar de limitarse a truncar cifras. Aumentar la precisión no mejora la exactitud del valor almacenado. El manipulador no establece el ancho del campo ni cambia el formato de salida de los enteros. El separador decimal depende de la configuración regional del flujo.

El ajuste permanece activo hasta que se modifica. std::defaultfloat cambia el modo, pero no restaura una precisión anterior. En código auxiliar, guarda y restaura precision() y, si se cambia el modo, también flags(). La sintaxis in >> std::setprecision(n) es válida y establece el estado de precisión del flujo de entrada; no limita el número de cifras consumidas al leer normalmente un número de coma flotante.

Ejemplos

#include <iomanip>
#include <iostream>
#include <locale>

int main() {
    std::cout.imbue(std::locale::classic());
    const double value = 12.375;
    const auto oldPrecision = std::cout.precision();
    const auto oldFlags = std::cout.flags();

    std::cout << std::defaultfloat << std::setprecision(4)
              << value << '\n';
    std::cout << std::fixed << std::setprecision(2)
              << value << '\n';
    std::cout << 1.5 << '\n';
    std::cout << std::scientific << value << '\n';

    std::cout.precision(oldPrecision);
    std::cout.flags(oldFlags);
}

Resultado

12.38
12.38
1.50
1.24e+01

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