char * itoa( int valor, char * cadena_destino, int base )

Retorna:

 Una cadena de texto conteniendo el resultado.

Descripción:

Esta función se utiliza para convertir un valor numérico en una cadena de texto, es decir, que permite convertir un número entero en un texto. La cadena contendrá tantos carácteres como dígitos tenga el resultado.

El parámetro base especifica la base utilizada para convertir el valor, esta deberá ser entre 2 y 36, inclusive.

La función atoi() permite la operación contraria; convertir un literal o cadena de texto en un valor numérico.

Ejemplo 1:

int  valor = 12345;
char cadena[25];

MAIN_PROGRAM_CDIV

BEGIN_PROGRAM
  // Definimos el modo gráfico
  set_gfx(GFX_AUTODETECT_WINDOWED);

  // Definimos la resolución
  set_mode(m320x200);

  itoa(valor, cadena, 10);
  
  write(0,0,0,0,"Resultado:");
  write(0,0,10,0,cadena);

  LOOP
   FRAME;
END_PROGRAM

Ejemplo 2:

char mensaje[50], strtmp[50];

MAIN_PROGRAM_CDIV
BEGIN_PROGRAM 

  // Definimos el modo gráfico
  set_gfx(GFX_AUTODETECT_WINDOWED);

  // Definimos la resolución
  set_mode(m640x480);

  load_fpg("..\\..\\help\\help.fpg");
  mouse.graph=200;
  write(0,0,0,0,mensaje);
  do{

   // Compone un mensaje con texto y números utilizando itoa()

   strcpy(mensaje, "Cursor del ratón en (");
   strcat(mensaje, itoa(mouse.x, strtmp, 10) );
   strcat(mensaje, ",");
   strcat(mensaje, itoa(mouse.y, strtmp, 10));
   strcat(mensaje, ").");

   FRAME;
  }while(!key(_esc));

END_PROGRAM

Ejemplo 1: convierte un valor a una cadena de texto usando al función itoa(), utilizamos la base 10 que es la decimal.

Ejemplo 2: compone en una cadena de texto denominada mensaje (char *) con las funciones: ( strcpy() y strcat() ) de letras y valores numéricos (las coordenadas
del ratón, ver mouse), y lo representa en pantalla con la función write().

El programa carga el archivo help.fpg con load_fpg() y asigna el gráfico 200 como cursor del ratón. El programa continuará hasta que
se detecte la pulsación de la tecla ESC.

Nota: El nombre de la función itoa(), viene de la expresión "integer to ascii", del inglés. Y la función que realiza la operación contraria, "ascii to integer" es atoi().
 

Ver: atoi() - write()