_set_output_format_set_output_format

Consente di personalizzare i formati di output usati dalle funzioni di I/O formattate.Customizes output formats used by formatted I/O functions.

Importante

Questa funzione è obsoleta.This function is obsolete. A partire da Visual Studio 2015 non è disponibile in CRT.Beginning in Visual Studio 2015, it is not available in the CRT.

SintassiSyntax

unsigned int _set_output_format(  
   unsigned int format  
);  

ParametriParameters

[in] format[in] format
Valore che rappresenta il formato da usare.An value representing the format to use.

Valore restituitoReturn value

Formato di output precedente.The previous output format.

OsservazioniRemarks

_set_output_format viene usato per configurare l'output delle funzioni di I/O formattate, come printf_s._set_output_format is used to configure the output of formatted I/O functions such as printf_s. Attualmente, l'unica convenzione di formattazione che può essere modificata da questa funzione è il numero di cifre visualizzate negli esponenti dell'output di numeri a virgola mobile.At present, the only formatting convention that can be changed by this function is the number of digits displayed in exponents in the output of floating point numbers.

Per impostazione predefinita, l'output di numeri a virgola restituito da funzioni quali printf_s, wprintf_se dalle funzioni correlate nella libreria C standard di Visual C++ stampa tre cifre per l'esponente, anche se non sono necessarie tre cifre per rappresentare il valore dell'esponente.By default, the output of floating point numbers by functions such as printf_s, wprintf_s, and related functions in the Visual C++ Standard C library prints three digits for the exponent, even if three digits are not required to represent the value of the exponent. Per arrivare a tre cifre, vengono aggiunti zeri.Zeroes are used to pad the value to three digits. _set_output_format consente di modificare questo comportamento in modo da stampare solo due cifre per l'esponente a meno che le dimensioni dell'esponente non ne richiedano una terza._set_output_format allows you to change this behavior so that only two digits are printed in the exponent unless a third digit is required by the size of the exponent.

Per abilitare gli esponenti a due cifre, chiamare questa funzione con il parametro _TWO_DIGIT_EXPONENT, come illustrato nell'esempio.To enable two-digit exponents, call this function with the parameter _TWO_DIGIT_EXPONENT, as shown in the example. Per abilitare gli esponenti a due cifre, chiamare questa funzione con l'argomento 0.To disable two digit exponents, call this function with an argument of 0.

RequisitiRequirements

RoutineRoutine Intestazione obbligatoriaRequired header
_set_output_format <stdio.h><stdio.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità) nell'introduzione.For more compatibility information, see Compatibility in the Introduction.

EsempioExample

// crt_set_output_format.c  
#include <stdio.h>  

void printvalues(double x, double y)  
{  
   printf_s("%11.4e %11.4e\n", x, y);  
   printf_s("%11.4E %11.4E\n", x, y);  
   printf_s("%11.4g %11.4g\n", x, y);  
   printf_s("%11.4G %11.4G\n", x, y);  
}  

int main()  
{  
   double x = 1.211E-5;  
   double y = 2.3056E-112;  
   unsigned int old_exponent_format;  

   // Use the default format  
   printvalues(x, y);  

   // Enable two-digit exponent format  
   old_exponent_format = _set_output_format(_TWO_DIGIT_EXPONENT);  

   printvalues(x, y);  

   // Disable two-digit exponent format  
   _set_output_format( old_exponent_format );  

   printvalues(x, y);  
}  
1.2110e-005 2.3056e-112  
1.2110E-005 2.3056E-112  
 1.211e-005  2.306e-112  
 1.211E-005  2.306E-112  
 1.2110e-05 2.3056e-112  
 1.2110E-05 2.3056E-112  
  1.211e-05  2.306e-112  
  1.211E-05  2.306E-112  
1.2110e-005 2.3056e-112  
1.2110E-005 2.3056E-112  
 1.211e-005  2.306e-112  
 1.211E-005  2.306E-112  

Vedere ancheSee Also

printf_s, _printf_s_l, wprintf_s, _wprintf_s_l printf_s, _printf_s_l, wprintf_s, _wprintf_s_l
_get_output_format_get_output_format