C funciones de biblioteca -snprintf()

C 标准库 - <stdio.h>C biblioteca estándar - <stdio.h>

Descripción

snprintf() es una función de la biblioteca estándar de C, utilizada para formatear una cadena de salida y escribir el resultado en el búfer especificado. A diferencia de sprintf(), snprintf() limita el número de caracteres de salida para evitar el desbordamiento del búfer.

ysprintf()A diferencia de sprintf(), la función snprintf() proporciona un parámetro size, que puede prevenir el desbordamiento del búfer. Si la longitud de la cadena formateada supera size-1, snprintf() solo escribirá size-1 caracteres y agregará un carácter nulo (\0) al final de la cadena para indicar su terminación.

Declaración

A continuación se muestra la declaración de la función snprintf().

int snprintf ( char * str, size_t size, const char * format, ... );

int snprintf(char *str, size_t size, const char *format, ...)Suponiendo que los argumentos variables(...)segúnformatse formatean en una cadena, y la cadena se copia astren,sizees el número máximo de caracteres a escribir; si se excedesizese truncará, escribiendo como máximo size-1 caracteres.

Parámetros

  • str-- Cadena de destino: puntero a la matriz de caracteres para almacenar la cadena formateada.
  • size-- Tamaño de la matriz de caracteres.
  • format-- Cadena de formato.
  • ...-- Argumentos variables: la cantidad variable de argumentos se formatea de acuerdo con las directivas de formato en format.

Valor de retorno

El valor de retorno es un entero:

  • Si tiene éxito, devuelve el número de caracteres que se habrían escrito (sin incluir el carácter nulo final), incluso si este valor es mayor que size.

  • Si ocurre un error de codificación, devuelve un valor negativo.

Ejemplo

El siguiente ejemplo demuestra el uso de la función snprintf().

Ejemplo

#include <stdio.h>
 
int main()
{
    char buffer[50];
    char* s = "ejemplocom";
 
    // Lee la cadena y la almacena en el búfer
    int j = snprintf(buffer, 6, "%s\n", s);
 
    // Imprime el búfer y el número de caracteres
    printf("string:\n%s\ncharacter count = %d\n", buffer, j);
 
    return 0;
}

El resultado de salida es:

string:
runoo
character count = 10

A continuación se muestra un ejemplo que demuestra cómo usar%fel especificador de formato en snprintf() para imprimir un número de coma flotante de precisión simple:

Ejemplo

#include <stdio.h>

int main() {
  char buffer[50];
  float x = 3.1415926;
  int len = snprintf(buffer, 50, "x = %f", x);
  printf("%s\n", buffer);
  printf("Written characters: %d\n", len);
  return 0;
}

El resultado de salida es:

x = 3.141593
Written characters: 12

En el ejemplo anterior, snprintf() escribe la cadena "x = 3.141593" en el búfer buffer y devuelve la longitud de la cadena, 12. Dado que el tamaño de buffer es 50, la cadena tendrá un carácter nulo al final. Finalmente, el programa imprime la cadena en buffer y el número de caracteres devuelto por snprintf().

Notas:

  • Tamaño del búfer:snprintf()La función limita el número de caracteres de salida, pero es necesario asegurarse de que el tamaño del búfer pasado sea suficiente para contener la cadena formateada. De lo contrario, la cadena podría truncarse y provocar pérdida de información.

  • Carácter de terminación de cadena:snprintf()La función agrega un carácter nulo al final del búfer como terminador de cadena, pero este carácter no se cuenta en el valor de retorno. Por lo tanto, al usarsnprintf()al imprimir la cadena, es necesario asegurarse de que el tamaño del búfer sea suficiente para contener todos los caracteres de la cadena y el carácter nulo final.

  • Cadena de formato: al usarsnprintf()al formatear la cadena, es necesario asegurarse de que los especificadores de formato en la cadena de formato coincidan con los tipos de los argumentos variables. De lo contrario, el resultado de salida puede contener errores.

  • Valor de retorno:snprintf()El valor de retorno de la función es el número de caracteres escritos en el búfer, sin incluir el carácter nulo final. Si el valor de retorno es igual al tamaño del búfer, indica que el resultado de salida fue truncado.

  • Argumentos variables:snprintf()Los argumentos variables de la función se pasan a través de...lo que significa que es necesario pasar los argumentos variables con tipos que coincidan con los especificadores de formato. Al usar argumentos variables, se debe evitar el uso de variables no inicializadas; de lo contrario, se producirán resultados impredecibles.

En resumen, al usar la función snprintf(), se deben tener en cuenta aspectos como el tamaño del búfer, el carácter de terminación de cadena, la cadena de formato, el valor de retorno y los argumentos variables, para garantizar que el resultado de salida sea correcto.

C 标准库 - <stdio.h>C biblioteca estándar - <stdio.h>

Otras extensiones