Diferencia entre revisiones de «sprintf()»
De ArduWiki
(→Advertencias) |
(→Retorno) |
||
Línea 16: | Línea 16: | ||
== Retorno == | == Retorno == | ||
+ | En caso de éxito, se devuelve la cantidad total de caracteres escritos. Este recuento no incluye el carácter nulo adicional adjuntado automáticamente al final de la cadena. | ||
+ | En caso de falla, se devuelve un número negativo. | ||
== Advertencias == | == Advertencias == |
Revisión del 22:19 13 jul 2018
Contenido
Descripción
Escribir datos formateados en una cadena Compone una cadena con el mismo texto que se imprimirá si se usó el formato en printf, pero en lugar de imprimirse, el contenido se almacena como una cadena C en el búfer señalado por str .
Sintaxis
sprintf(str, formato, argumentos);
Parámetros
- str
- Puntero a un buffer donde se almacena el C-string resultante.
El buffer debe ser lo suficientemente grande como para contener la cadena resultante.
- formato
- Cadena que contiene una cadena de formato que sigue las mismas especificaciones que el formato en printf.
- argumentos
- Dependiendo de la cadena de formato , la función puede esperar una secuencia de argumentos adicionales, cada uno con un valor que se utilizará para reemplazar un especificador de formato en la cadena de formato (o un puntero a una ubicación de almacenamiento, para n ).
Debe haber al menos tantos de estos argumentos como la cantidad de valores especificados en los especificadores de formato .
Retorno
En caso de éxito, se devuelve la cantidad total de caracteres escritos. Este recuento no incluye el carácter nulo adicional adjuntado automáticamente al final de la cadena. En caso de falla, se devuelve un número negativo.
Advertencias
- La función ignora argumentos adicionales.
- El tamaño del búfer debe ser lo suficientemente grande como para contener toda la cadena resultante (ver snprintf para una versión más segura).
- Un carácter nulo de terminación se agrega automáticamente después del contenido.
- Después del parámetro de formato, la función espera al menos tantos argumentos adicionales como sea necesario para el formato.
Ejemplo