Función cgets Borland® C

char *cgets(char *cadena);

Esta función leerá una cadena de caracteres desde la consola, guardando la cadena (y su longitud) en el lugar apuntado por *cadena. La función cgets leerá caracteres hasta que encuentre una combinación de retorno de línea y nueva línea (CR/LF), o hasta que el número máximo de caracteres permitidos hayan sido leídos. Si se lee una combinación CR/LF, entonces es sustituido por un carácter nulo '\0' antes de ser guardado la cadena.

Antes de que la función cgets es llamada, asigna a cadena[0] la longitud máxima de la cadena a ser leída. Al retornar, cadena[1] es asignado el número de caracteres leídos. Los caracteres leídos comienzan a partir de cadena[2] (incluido) y termina con el carácter nulo. Por esta razón, *cadena debe ser como mínimo cadena[0] más 2 bytes de longitud.

Valor de retorno:

La función cgets retorna la cadena de caracteres a partir de cadena[2], si tiene éxito.

Ejemplo:

#include <conio.h>

int main() {
   char cadena[23];
   char *cad;

   cadena[0] = 21;    /* 20 caracteres del usuario y el carácter nulo final */
   cprintf( "Escriba un mensaje: " );
   cad = cgets( cadena );

   cprintf( "\r\nEscribiste: \"%s\"\r\nEl mensaje tiene %d caracteres.\r\n\r\n", 
      cad, cadena[1] );

   return 0;
}