La función snprintf () en C ++ se utiliza para escribir una cadena formateada en el búfer de cadena de caracteres.
A diferencia de sprintf (), el número máximo de caracteres que se pueden escribir en el búfer se especifica en snprintf().
prototipo snprintf ()
int snprintf (char * buffer, size_t buf_size, const char * formato,…);
La snprintf()función escribe la cadena apuntada por formato en el búfer. El número máximo de caracteres que se pueden escribir es (buf_size-1).
Una vez escritos los caracteres, se agrega un carácter nulo de terminación. Si buf_size es igual a cero, no se escribe nada y el búfer puede ser un puntero nulo.
Está definido en el archivo de encabezado.
Parámetros de snprintf ()
- buffer: puntero al búfer de cadena para escribir el resultado.
- buf_size: especifique el número máximo de caracteres que se escribirán en el búfer, que es buf_size-1.
- formato: puntero a una cadena terminada en nulo que se escribe en la secuencia del archivo. Consiste en caracteres junto con especificadores de formato opcionales que comienzan con%.
Los especificadores de formato se reemplazan por los valores de las variables respectivas que siguen a la cadena de formato.
El especificador de formato tiene las siguientes partes:
- Un signo de% inicial
- Banderas: una o más banderas opcionales que modifican el comportamiento de conversión.
- -: justifica a la izquierda el resultado dentro del campo. Por defecto, está justificado a la derecha.
- +: El signo del resultado se adjunta al comienzo del valor, incluso para resultados positivos.
- Espacio: si no hay ningún signo, se adjunta un espacio al comienzo del resultado.
- #: Se realiza una forma alternativa de conversión.
- 0: se utiliza para números enteros y de coma flotante. Los ceros iniciales se utilizan para rellenar los números en lugar de espacios.
- Ancho: un valor opcional * o entero utilizado para especificar el campo de ancho mínimo.
- Precisión: un campo opcional que consta de un. seguido de * o entero o nada para especificar la precisión.
- Longitud: un modificador de longitud opcional que especifica el tamaño del argumento.
- Especificador: un especificador de formato de conversión. Los especificadores de formato disponibles son los siguientes:
Especificador de formato Descripción % % De impresiones C Escribe un solo carácter s Escribe una cadena de caracteres do yo Convierte un entero con signo en representación decimal o Convierte un entero sin signo en una representación octal X o x Convierte un entero sin signo en una representación hexadecimal tu Convierte un entero sin signo en una representación decimal F o f Convierte un número de punto flotante a la representación decimal E o e Convierte un número de punto flotante a la notación de exponente decimal A o a Convierte un número de punto flotante al exponente hexadecimal G o g Convierte un número de punto flotante a una notación decimal o de exponente decimal norte Devuelve el número de caracteres escritos hasta ahora por esta llamada a la función. El resultado se escribe en el valor apuntado por el argumento pags Escribe una secuencia de caracteres definida por la implementación que define un puntero. Entonces, el formato general del especificador de formato es:
%(flags)(width)(.precision)(length)specifier
- …: Otros argumentos adicionales que especifican los datos a imprimir. Ocurren en una secuencia de acuerdo con el especificador de formato.
snprintf () Valor de retorno
Si tiene éxito, la snprintf()función devuelve el número de caracteres que se habrían escrito para un búfer suficientemente grande excluyendo el carácter nulo de terminación. Si falla, devuelve un valor negativo.
Se considera que la salida está completamente escrita si y solo si el valor devuelto no es negativo y es menor que buf_size.
Ejemplo: cómo funciona la función snprintf ()
#include #include using namespace std; int main() ( char buffer(100); int retVal, buf_size = 100; char name() = "Max"; int age = 23; retVal = snprintf(buffer, buf_size, "Hi, I am %s and I am %d years old", name, age); if (retVal> 0 && retVal < buf_size) ( cout << buffer << endl; cout << "Number of characters written = " << retVal << endl; ) else cout << "Error writing to buffer" << endl; return 0; )
Cuando ejecute el programa, la salida será:
Hola, soy Max y tengo 23 años Número de caracteres escritos = 34
