Перейти к основному содержимому

Консоль

Стд::СредаИсполнения::Консоль Тип-одиночка

Объект для ввода/вывода в консоль ОС.

Пример

метод Поприветствовать()
знч Имя = Консоль.СчитатьСтроку("Введите свое имя: ")
Консоль.Записать("Привет, %Имя")
;

Сравнение

Ссылочное

Иерархия типа

Базовые типы: Объект, Одиночка


Свойства

ПотокВвода

ТолькоЧтение

ПотокВвода: ПотокЧтения

Поток для чтения данных из входящего потока Консоли. Не требует закрытия.


ПотокВывода

ТолькоЧтение

ПотокВывода: ПотокЗаписи

Поток для вывода данных в поток записи Консоли. Не требует закрытия.


ПотокОшибок

ТолькоЧтение

ПотокОшибок: ПотокЗаписи

Поток ошибок Консоли. Не требует закрытия.


Методы

Записать

Записать(Значение: Объект?)
Записывает в выходной поток строковое представление объекта Значение и завершает запись символом перевода строки. Преобразование к строке осуществляется через ВСтроку.

Перегрузка
Записать(Значение: Объект?, ОкончаниеСтроки: Строка)


Записать

Записать(
Значение: Объект?,
ОкончаниеСтроки: Строка)
Записывает в выходной поток строковое представление объекта Значение с добавлением в конец строки ОкончаниеСтроки. Преобразование объекта к строке осуществляется через ВСтроку.

Перегрузка
Записать(Значение: Объект?)


ЗаписатьОшибку

ЗаписатьОшибку(ТекстОшибки: Строка)
Записывает в поток ошибок текст произошедшей ошибки ТекстОшибки.


ЗаписатьТаблицу

@ИменованныеПараметры
ЗаписатьТаблицу<ТипСтроки>(
Строки: Обходимое<ТипСтроки>,
ВыводитьЗаголовки: Булево = Истина,
Заголовки: Обходимое<Строка>? = Неопределено,
ВыводитьНумерацию: Булево = Ложь,
ВыравниваниеСтолбцов: Обходимое<ВыравниваниеСтолбцаТаблицыКонсоли>,
Формат: (Объект?)->Строка)
ТипСтроки: Тип экземпляра из Строки.

Вызов возможен только с именованными параметрами

Записывает в выходной поток свойства экземпляров из Строки в виде таблицы с заданным выравниванием для каждого столбца. Если у объектов нет свойств, то в поток записывается представления экземпляров. Если ВыводитьНумерацию имеет значение Истина - перед каждой строкой выводится её порядковый номер. Если ВыводитьЗаголовки имеет значение Истина - выводится строка заголовков таблицы. Если Заголовки имеет значение Неопределено и ВыводитьЗаголовки = Истина, то в качестве заголовков используются имена свойств (имена полей для структур) типа ТипСтроки. Чтобы вывести иные табличные заголовки, их нужно передать в параметре Заголовки. Если ВыводитьЗаголовки = Ложь, то значение Заголовки игнорируется. Если у объектов нет свойств, то заголовок таблицы будет выведен только в том случае, если явно указано значение Заголовки. Формат - используется для преобразования значений ячеек к строке, если не задан - используется ВСтроку.

Исключения

ИсключениеНедопустимыйАргумент - если число заголовков или столбцов в настройках выравнивания не совпадает с количеством выводимых свойств экземпляров. ИсключениеВводаВывода - ошибка при записи свойств в выходной поток.

Перегрузка
ЗаписатьТаблицу<ТипСтроки>(Строки: Обходимое<ТипСтроки>, ВыводитьЗаголовки: Булево = Истина, Заголовки: Обходимое<Строка>? = Неопределено, ВыводитьНумерацию: Булево = Ложь, ВыравниваниеСтрок: ВыравниваниеСтолбцаТаблицыКонсоли, ВыравниваниеЧисел: ВыравниваниеСтолбцаТаблицыКонсоли, Формат: (Объект?)->Строка)


ЗаписатьТаблицу

@ИменованныеПараметры
ЗаписатьТаблицу<ТипСтроки>(
Строки: Обходимое<ТипСтроки>,
ВыводитьЗаголовки: Булево = Истина,
Заголовки: Обходимое<Строка>? = Неопределено,
ВыводитьНумерацию: Булево = Ложь,
ВыравниваниеСтрок: ВыравниваниеСтолбцаТаблицыКонсоли,
ВыравниваниеЧисел: ВыравниваниеСтолбцаТаблицыКонсоли,
Формат: (Объект?)->Строка)
ТипСтроки: Тип экземпляра из Строки

Вызов возможен только с именованными параметрами

Записывает в выходной поток свойства экземпляров из Строки в виде таблицы. Если у объектов нет свойств, то в поток записывается представления экземпляров. Для столбцов, свойства которых являются числовыми, используется выравнивание ВыравниваниеЧисел, для иных - ВыравниваниеСтрок. Если ВыводитьНумерацию имеет значение Истина - перед каждой строкой выводится её порядковый номер. Если ВыводитьЗаголовки имеет значение Истина - выводится строка заголовков таблицы. Если Заголовки имеет значение Неопределено и ВыводитьЗаголовки = Истина, то в качестве заголовков используются имена свойств (имена полей для структур) типа ТипСтроки. Чтобы вывести иные табличные заголовки, их нужно передать в параметре Заголовки. Если ВыводитьЗаголовки = Ложь, то значение Заголовки игнорируется. Если у объектов нет свойств, то заголовок таблицы будет выведен только в том случае, если явно указано значение Заголовки. Формат - используется для преобразования значений ячеек к строке, если не задан - используется ВСтроку.

Исключения

ИсключениеНедопустимыйАргумент - если число заголовков не совпадает с количеством выводимых свойств экземпляров. ИсключениеВводаВывода - ошибка при записи свойств в выходной поток.

Перегрузка
ЗаписатьТаблицу<ТипСтроки>(Строки: Обходимое<ТипСтроки>, ВыводитьЗаголовки: Булево = Истина, Заголовки: Обходимое<Строка>? = Неопределено, ВыводитьНумерацию: Булево = Ложь, ВыравниваниеСтолбцов: Обходимое<ВыравниваниеСтолбцаТаблицыКонсоли>, Формат: (Объект?)->Строка)


СчитатьБулево

СчитатьБулево(ПодсказкаВвода: Строка = ""): Булево
Считывает из входящего потока строку и возвращает соответствующее значение булево. Начальные пробелы и символы табуляции игнорируются. Чтение выполняется до первого пробельного символа, табуляции или символа конца строки. Все символы, расположенные после первого разделителя, игнорируются. Допустимый формат ввода (регистр не учитывается):

  • Истина: "True" / "Истина" / "Yes" / "Да"
  • Ложь: "False" / "Ложь" / "No" / "Нет"

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

ПодсказкаВвода - Текст, который добавляется в виде подсказки для пользователя в начало ввода.


СчитатьПароль

СчитатьПароль(ПодсказкаВвода: Строка = ""): Строка
Считывает и возвращает из входящего потока пароль. При вводе символов, вывод в консоль не осуществляется.

ПодсказкаВвода - Текст, который добавляется в виде подсказки для пользователя в начало ввода.

Примеры

Запросить ввести пароль:

метод ПрочитатьУчетныеДанные()
знч ИмяПользователя = Консоль.СчитатьСтроку("Пользователь: ")
знч Пароль = Консоль.СчитатьПароль("Пароль (%ИмяПользователя): ")

Консоль.Записать("Учетные данные приняты.")
;

Вывод в консоль:

Пользователь: IvanovI
Пароль (IvanovI):
Учетные данные приняты.

СчитатьСимвол

СчитатьСимвол(ПодсказкаВвода: Строка = ""): Строка
Считывает и возвращает из входящего потока 1 символ. Начальные пробелы и символы табуляции игнорируются. Чтение выполняется до первого пробельного символа, табуляции или символа конца строки. Все символы, расположенные после первого разделителя, игнорируются. В случае если считать строку не удалось или было введено более одного символа, пользователю отображается сообщение и предлагается еще раз ввести строку. ПодсказкаВвода - Текст, который добавляется в виде подсказки для пользователя в начало ввода.


СчитатьСтроку

СчитатьСтроку(ПодсказкаВвода: Строка = ""): Строка
Считывает и возвращает из входящего потока строку целиком. В случае если считать строку не удалось, пользователю отображается сообщение и предлагается еще раз ввести строку.

ПодсказкаВвода - Текст, который добавляется в виде подсказки для пользователя в начало ввода.


СчитатьЧисло

СчитатьЧисло(ПодсказкаВвода: Строка = ""): Число
Считывает из входящего потока строку и возвращает соответствующее числовое значение. Начальные пробелы и символы табуляции игнорируются. Чтение выполняется до первого пробельного символа, табуляции или символа конца строки. Все символы, расположенные после первого разделителя, игнорируются. Формат вводимого для чтения числа обусловлен локалью (разделители между разрядами, перед дробной частью). В случае несоответствия формату попытка ввода повторяется, пользователю отображается сообщение и предлагается еще раз ввести число.

ПодсказкаВвода - Текст, который добавляется в виде подсказки для пользователя в начало ввода.


Список унаследованных методов

Объект

ВСтроку

ПолучитьТип

Представление