Эта функция вернет строку, введенную пользователем с дополнительной подсказкой на экране (если не в графическом режиме) или на текущем буфере, используемом для вывода графики. Обычно Вы присвоите значение этой команды строчной переменной для более позднего использования.