Click above to get retro games delivered to your door ever month!

 cgets()                 Get a Character String From the Console

 #include <conio.h>                      Required for declarations only

 char       *cgets(string);
 char       *string;                     Storage location for data

    cgets() reads a string from the console and stores it in 'string';
    'string' must be a pointer to a character array. Before calling,
    'string[0]' should be set to the length (in bytes) of the storage
    space available for the string. Upon return, 'string[1]' will contain
    the actual length of the string.  The string is stored starting at
    'string[2]'.

    Reading from the console continues either until a carriage-return-
    line-feed is read, or until the maximum number of characters
    (specified at string[0]) have been read. A CR-LF character is
    replaced with a null character ('\0') before it is stored.

    Returns:    A pointer to the start of the string at string[2]; no
                error return.

      Notes:    If string[0] is not set by the user to the maximum number
                of characters allowed, the routine reads 0 characters
                from the console and returns. The length of the string
                stored at string[0] should account for the terminating
                null byte, plus the two extra bytes at string[0] and
                string[1].

 Portability:   Applies to MS DOS only.

   -------------------------------- Example ---------------------------------

    The following statements prompt the user for input, then print out
    the string entered and its length.


           #include <conio.h>
           #include <stdio.h>        /* for printf */

           char buffer[100];         /* Can hold 97 chars plus a newline */
           char *name;
           int numread;

           main()
           {
               *buffer = 98;
               printf("Enter your name: ");
               name = cgets(buffer);
               printf("\nName entered: %s \n",name);
               printf("# of chars read: %d\n",buffer[1]);
                  /* Number read does not include carriage return,*/
                  /* which was replaced by a null byte. */
           }