Описание функций Си

       

Cgets



     cgets

Фукция 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 или совместимых с ними.

Смотрите также

Пример:

#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; }



Содержание раздела