Число

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

graph BT;
Число-->Форматируемое;
Форматируемое-->Представляемое;
Представляемое-->Объект;
Число-->Сравнимое&ltЧисло>
Сравнимое&ltЧисло&gt-->Объект;

Десятичное число. Максимально допустимая разрядность числа 38 знаков.

Сравнение структурное.

Примеры

знч Двоичный = 0b11011
знч Десятичный = 27
знч Шестнадцатеричный = 0x1B

Литералы

• Двоичный: 0b{0|1}+
• Десятичный: [+|-]{0..9}[.{0..9}]
• Шестнадцатеричный: 0x{0..9|a..f|A..F}+

Арифметические операции

• Число + Число = Число (сложение)
• Число - Число = Число (вычитание)
• Число * Число = Число (умножение)
• Число / Число = Число (деление)
• Число % Число = Число (остаток от деления)
• Число ** Число = Число (возведение в степень)
• -Число = Число (унарный минус)

Приоритет операций (в порядке уменьшения):

• Выражения в круглых скобках
• • (унарный минус)
• Операции *, /, %, **
• Операции +, -

Конструкторы

Число

Число(Строка: Строка)

Преобразует строковое представление в соответствующий экземпляр числа. Поддерживаемые форматы:

• Целые, дробные числа
• Числа в экспоненциальной записи

Примеры:

новый Число("123") -> 123
новый Число("+1.23") -> 1.23
новый Число("-12.3") -> -12.3
новый Число("1.23e+2") -> 123
новый Число("-1.23e2") -> -123
новый Число("123E-2") -> 1.23

Исключения

ИсключениеНедопустимыйФормат - если представление не является валидным.

Методы

ВСтроку

ВСтроку(): Строка

Возвращает десятичное представление числа в формате литерала. Пример: "250000.50".

ВСтроку

ВСтроку(Основание: Число): Строка

Применим только к целым числам. Возвращает число в формате литерала, переведенное в заданную систему счисления. Доступны системы счисления от 2 до 36. Примеры:

(134).ToString(4) -> 2012
(134).ВСтроку(3) -> 11222

Исключения

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

Округлить

Округлить(Режим: РежимОкругления): Число

Возвращает число, округленное до целой части по правилу, заданному режимом округления Режим.

Округлить

Округлить(
  Разрядность: Число = 0,
  Режим: РежимОкругления = РежимОкругления.ПоловинаВверх
): Число

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

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

Представление(): Строка

Возвращает десятичное представление числа в следующем формате: 1) в качестве символа разделителя между дробной и целой частью выступает "," (запятая); 2) в качестве символа разделителя групп в целой части (цифры группируются по 3, начиная с младшего разряда) выступает символ " " (неразрывный пробел); 3) в дробной части выводятся все разряды дробной части, как в исходном числе (отсутствие точности).

Данный формат соответствует форматной строке "_".

Пример: “250 000,50”.

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

Представление(Формат: Строка): Строка

Возвращает десятичное представление числа, отформатированное в соответствии с форматной строкой Формат.

Устройство форматной строки

Форматная строка состоит из 3 частей, следующих друг за другом непрерывно (без каких-либо символов разделителей): 1) префикс; 2) форматирующая часть, не может быть представлена пустой строкой; 3) суффикс.

Имеет следующий синтаксис:

"'префикс'форматирующая_часть'суффикс'"

Префикс и суффикс в форматной строке в обязательном порядке указываются в отдельных одинарных кавычках.

Префикс

Префикс — это непосредственно текст (какой-либо набор символов), который должен быть вставлен перед отформатированным числом. При использовании символа ' (одинарная кавычка) в префиксе его необходимо экранировать: '' (две подряд идущие одинарные кавычки).

Примеры:

'val=' -> в итоговой строке префикс будет выглядеть, как val=

'''val=''' -> в итоговой строке префикс будет выглядеть, как 'val='

Форматирующая часть

Форматирующая часть состоит из четырех частей:

[флаги][ширина][.точность][специальные флаги]

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

Флаги

Флаги позволяют управлять форматом строки с обрабатываемым числом. Если необходимо указать несколько флагов — они указываются в любом порядке друг за другом без разделительных символов. Флаги могут не указываться в форматной строке.

“Свободное место” будет вычисляться по формуле: MAX(Заданная ширина строки (0, в случае если не задана) - Минимальная ширина для вывода отформатированного числа, 0). Иными словами — количество символов, которых не хватает в отформатированном числе до значения ширина. По умолчанию — свободное место заполняется пробелами слева.

Ширина

Данная часть форматной строки контролирует общую итоговую ширину вывода форматируемого числа (в данном значении не учитывается текст идущий в префиксе и суффиксе — он отдельно приписывается до и после строки, содержащей отформатированное число, соответственно). Если указанной ширины не хватает для вывода числа с соблюдением всех флагов, а также специальных флагов, то она динамически расширяется до минимально необходимой для вывода отформатированного числа. Если же ширина больше необходимой для вывода отформатированного числа, то свободное место заполняется в соответствии с введенными флагами. Если флаги не указаны — свободное место будет заполнено пробелами слева. Если данный параметр не указан, то ширина строки будет минимально возможной для вывода отформатированного числа.

Примеры:

Для числа 1.234 применим форматную строку "6". Получим: “ 1,234”

Для числа 123123 применим форматную строку "1". Получим: “123123”

Точность

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

Пример: 1.2 с точностью 4 → “1.2000”.

Если данный параметр не указан, то выводится столько цифр после запятой, сколько было в исходном числе.

Специальные флаги

Специальные флаги служат для кастомизации выводимого числа. Специальные флаги, как и обычные флаги, могут указываться в произвольном порядке, но обязательно должны отделяться друг от друга символом “;” (точка с запятой). Также они должны быть отделены от предыдущей части символом “;” (точка с запятой), кроме случая, когда в форматирующей части строки нет никаких подчастей, кроме специальных флагов — тогда допускается не указывать символ разделитель.

Пример: "'val='РД=.'$'".

Синтаксис специальных флагов допускает использование пробелов для отделения названия специального флага от знака разделителя и знака присваивания.

Пример: "'test'(+_15.2; РГ =,; РД =.; ОК =ПВВ;'test'".

Однако, недопустимо отделение значения специального флага от знака присваивания и знака разделителя.

Нельзя: "'test'(+_15.2; РГ = , ;'test'"

В обязательном порядке подряд последовательно должны идти знак присваивания (=), значение специального флага(символ, либо режим округления для ОК), знак разделитель(;).

Специальные флаги могут не указываться в форматной строке.

Специальный флаг ОК имеет 4 режима округления, которые совпадают с режимами, введенными перечислением РежимОкругления, и отличаются от них лишь сокращенными названиями.

Если специальный флаг, задающий режим округления, не указан — режимом округления является РежимОкругления.ПоловинаВверх.

Суффикс

Суффикс — это непосредственно текст (какой-либо набор символов), который должен быть вставлен после форматированного числа. При использовании символа "'" (одинарная кавычка) в суффиксе его необходимо экранировать: "''" (две подряд идущие одинарные кавычки).

Примеры:

'$' -> в итоговой строке суффикс будет выглядеть, как "$"
'''$''' -> в итоговой строке суффикс будет выглядеть, как "'$'"

Именованные стандартные форматы

Для упрощения работы с форматными строками созданы именованные стандартные форматы, имеющие следующий синтаксис:

"'префикс'именованный_стандартный_формат'суффикс'"

Они заменяют форматирующую часть строки и упрощают создание форматных строк.

Примеры использования стандартных именованных форматов:

Исключения

ИсключениеНедопустимыйФормат - если введена некорректная форматная строка.

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

Примеры

ЦелаяЧасть

ЦелаяЧасть(): Число

Возвращает целую часть числа.

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

Объект

Сравнимое