Описание функций C (Си) / C++ - cgets

Описание функций C (Си) / C++ - cgets


#include требуется только для объявления
функции


char *cgets(str);
char *str; память для хранения данных

Описание.

Функция cgets читает строку символов прямо с консоли и за-
поминает строку и ее длину в местоположении, указанном str. Str
должно быть указателем на массив символов. Первый элемент массива
- str[0] должен содержать максимальную длину (в символах) читае-
мой строки. Массив должен быть достаточно большим, чтобы содер-
жать строку, символ окончания ' и два дополнительных байта.
Функция cgets продолжает считывать символы, пока не будет прочи-
тана комбинация "ВК-ПС" или определенное количество символов.
Строка запоминается, начиная с str[2]. Если комбинация "ВК-ПС"
прочитана, перед запоминанием она заменяется нулевым символом
'.
Функция cgets во втором элементе массива str[1] запоминает
действительную длину строки.

Возвращаемое значение.

Функция cgets возвращает указатель к началу строки, которая
находится в str[2]. Возвращаемого значения в случае ошибки нет.
См.также getch, getche.

Пример:

#include

char *result;
int numread;
.
.
.
*buffer=80; / *максимальное количество символов */

/* Внимание. *buffer эквивалентно *buffer[0] */

/* следующие операторы вводят строку с клавиатуры и находят
ее длину: */

result=cgets(buffer);
numread=buffer[1];


/* result указывает на строку, numread - на ее длину ("ВК"
не считается, т.к. заменяется нулевым символом */.





Опубликовал admin
11 Мар, Вторник 2008г.



Программирование для чайников.