cgets

               CGETS
            
            #include <conio.h>   требуется только  для  объявления
                                 функции
            
           
            char *cgets(str);
            char *str;           память для хранения данных
            
            Описание.
                
               Функция  cgets читает строку символов прямо с консоли и за-
         поминает строку и ее длину в местоположении, указанном  str.  Str
         должно быть указателем на массив символов. Первый элемент массива
         -  str[0] должен содержать максимальную длину (в символах) читае-
         мой строки. Массив должен быть достаточно большим,  чтобы  содер-
         жать  строку, символ окончания '\0' и  два дополнительных  байта.
         Функция  cgets продолжает считывать символы, пока не будет прочи-
         тана  комбинация  "ВК-ПС"  или определенное количество  символов.
         Строка  запоминается,  начиная с str[2]. Если  комбинация "ВК-ПС"
         прочитана, перед  запоминанием  она  заменяется  нулевым символом
         '\0'.
               Функция  cgets во втором элементе массива str[1] запоминает
         действительную длину строки.
            
               Возвращаемое значение.
            
               Функция cgets возвращает указатель к началу строки, которая
         находится в str[2]. Возвращаемого значения в случае ошибки нет.
               См.также getch, getche.
            
               Пример:
            
            #include <conio.h>
            
            char *result;
            int numread;
            .
            .
            .
            *buffer=80; / *максимальное количество символов */
                        
            /* Внимание. *buffer эквивалентно *buffer[0] */
            
               /* следующие операторы вводят строку с клавиатуры и находят
         ее длину: */
            
                result=cgets(buffer);
                numread=buffer[1];
         
                
               /* result указывает на строку, numread - на ее длину  ("ВК"
         не считается, т.к. заменяется нулевым символом */.