Фукция             Cчитывает строку с консоли.

 Синтаксис          #include
                    char *cgets(char *str);

 Файл, содержащий   conio.h
 прототип

 Описание           cgets считывает символьную строку с консоли и
                    сохраняет ее (и длину строки) в буфере, указывае-
                    мом параметром str.

                    cgets считывает символы до тех пор, пока не вст-
                    ретится комбинация CR/LF (возврат каретки/перевод
                    строки), или пока не будет считано указанное чис-
                    ло символов. Если cgets считала комбинацию CR/LF,
                    она заменяет их на \0 (нулевой ограницитель стро-
                    ки).

                    До вызова cgets аргумент str[0] должен быть уста-
                    новлен на максимальную длину считываемой строки.
                    При возврате str[1] содержит количество считанных
                    символов. Символы хранятся, начиная с str[2], и
                    заканчиваются нулевым символом. Итак, аргумент
                    str должен иметь размер, по крайней мере, str[0]
                    плюс 2 байта.

 Возвращаемое       При успешном завершении cgets возвращает указатель
 значение           на str[2].

 Переносимость      Эта функция поддерживается только на компьютерах
                    IBM PC или совместимых с ними.

 Смотрите также     cputs fgets getch getche gets

 Пример:

 #include 
 #include 

 main()
 {
     char buffer[83];
     char *p;
     /* место под 81 символ   */
     buffer[0] = 81;
     p = cgets(buffer);
     printf("\ncgets считала %d символов: \"%s\"\n",buffer[1], p);
     printf("Возвращается указатель %p, buffer[2] на %p\n",p,&buffer);
     /* место под 5 символов и завершающий 0 */
     buffer[0] = 6;
     printf("Введите несколько символов\n");
     p = cgets(buffer);
     printf("\ncgets считала %d символов: \"%s\"\n,buffer[1], p);
     printf("Возвращается указатель %p, buffer[2] на %p\n",p,&buffer);
     return 0;
 }