Admin: 1 revision imported

2021-02-07T06:52:40Z

1 revision imported

Admin: Created page with "{{infobox function |name=SpellNumber |caption=Функции работы со строками |type=1 |status=2 |db=0 |exception=Невозможно превратить в..."

2019-04-20T10:49:03Z

Created page with "{{infobox function |name=SpellNumber |caption=Функции работы со строками |type=1 |status=2 |db=0 |exception=Невозможно превратить в..."

New page

{{infobox function
|name=SpellNumber
|caption=Функции работы со строками
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, переполнение
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция превращает число в его прописное представление, используя указанный язык и грамматический род результата. Величина числа, которое можно прописать таким образом ограничено словарем профайла прописи (см. описание второго аргумента), если число выходит за пределы словаря, будет вызвано исключение. Функция принимает отрицательные числа. В случае отрицательного числа, результат будет начинаться со слова '''минус''' (для русского языка). При форматировании числа дробная часть будет отброшена (не округлена). Результат всегда представляется в нижнем регистре.

== Синтаксис ==
<code>
'''SpellNumber'''(''<Число>''{{Optional|,''<Язык кодирования (STRING)>''}}{{Optional|,''<Род результата (STRING)>''{{Default|{{Eq}}"М"}}}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Число>''</code> - Аргумент, числовое представление которого необходимо превратить в пропись.
* <code>''<Язык кодирования (STRING)>''</code> - {{Optional}} Две буквы языка форматирования в латинской нотации. По умолчанию используется язык умолчания сборки или язык, заданный функцией [[SelectLanguage]]. Словарь перевода задан в файлах профайла, находящихся в подпапке '''Profiles''' папки клиента. Файлы имеют формат UTF-16 с [[BOM]]. Файлы должны иметь наименование <code>Common.<язык>.sfs</code>. Т.е., для словая русского языка используется файл '''Common.ru.sfs''', английского '''Common.en.sfs'''. Файл словаря содержит кроме слов, связанных с созданием прописи чисел, также слова для превращения в текстовый формат даты и времени, прописи наименований валют и пр.
* <code>''<Род результата (STRING)>''</code> - {{Optional}} Задает род прописного представления числа. '''M''' для задания мужского рода (используется по умолчанию), '''F''' для задания женского рода. Применимо только в определенных языках представления (в английском, к примеру, будет игнорироваться)

==== Возвращаемое значение ====
Функция всегда возвращает строку UTF-16.

== Примеры ==
<pre>
Message(SpellNumber(1234567.89,"ru"));
//Будет выведено "один миллион двести тридцать четыре тысячи пятьсот шестьдесят семь"

Message(SpellNumber(1234567,"en"));
//Будет выведено "one million one hundred and thirty-four thousand five hundred and sixty-seven"

Message(SpellNumber(-555552,"ru","F"));
//Будет выведено "минус пятьсот пятьдесят пять тысяч пятьсот пятьдесят две"

Message(SpellNumber(123E16,"ru"));
//Будет выведено "один квинтиллион двести тридцать квадриллионов"

Message(SpellNumber(0,"ru"));
//Будет выведено "ноль"
</pre>

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

SpellNumber - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=SpellNumber |caption=Функции работы со строками |type=1 |status=2 |db=0 |exception=Невозможно превратить в..."