Одна из основных функций, позволяющая упразднять несущественные нули в конце натурального числа, а так же все несущественные нули в начале.
$args[ - обрабатываемое число, только в текстовом виде.
0] args[ - разряд до которого требуется удалить нули. 1 - до целых, 10 - до десятых, 100 - до сотых и т.д, по умолчанию 1.
1] $result - текстовое значение вида 000.000
Вычисляет рациональное частное от целых чисел.
args[ - делимое;
0] args[ - делитель, по умолчанию = 100;
1] args[ - точность вычисления. 1 - до целых, 10 - до десятых, 100 - до сотых и т.д. По умолчанию, вычисляет до девятого знака после запятой (максимальное значение аргумента).2] $result - текстовое значение вида 000.000
Использует функцию #dz#
Имеются ограничения на значения аргументов (для QSP 5.7.0 в пределах [-2147483648 ... 2147483647]).
Переводит рациональное число в целое (фактически умножает рациональное число на круглое число, с округлением-отсечением дробной части).
$args[ - рациональное число
0] args[ - точность перевода 10 - один знак после запятой, 100 - два знака, и т.д, по умолчанию до последнего знака после запятой
1] result - целое число
Не использует дополнительных функций, однако есть ограничение на значения аргументов и результата (для QSP 5.7.0 в пределах [-2147483648 ... 2147483647]).
Получает разрядность дробной части числа в виде целого круглого числа
$args[ - число в текстовом виде
0] result - число, в числовом виде (соответственно для QSP 5.7.0 в пределах [-2147483648 ... 2147483647])
Округляет число до указанной разрядности
возможны варианты 1, 10, 100, 1000 и т.п., и 0.1, 0.01 и т.п.
$args[ - рациональное число в текстовом виде;
0]$args[ - разрядность. Возможны варианты: 1, 10, 100, 1000 и т.п., и 0.1, 0.01 и т.п.;
1]$args[ - 2][up] в сторону увеличения, [down] - с округлением-отсечением; если не указано, используются правила округления к ближайшему целому.
Функция работоспособна, но не доработана (актуально для версии библиотеки 2.1.4 и ниже). Использует функции #dz#, #zero#.
Функция сложения. Может суммировать целые и дробные числа любого знака любой длины (ограничение на значение текстовых переменных для QSP 5.7.0 около 2Гб).
Использует функции #zero#, #add#, #dev#, #dz#. Каждая из этих функций включает в себя один и более циклов, в результате чего могут наблюдаться заметные подвисания плеера для ОЧЕНЬ больших чисел. Вычисления могут оказаться долгими, но они будет произведены - результат гарантирован.
$args[ ... 0]$args[ - девять слагаемых. Могут быть переданы в числовом виде (для QSP 5.7.0 в пределах [-2147483648 ... 2147483647]).
8] $result - всегда текстовое значение.
Будьте внимательны. Функция работает с переменными minus_em_plus, i_em_plus, o_em_plus, len_em_plus. Если вы используете такие же переменные в своей игре, переименуйте переменные в функции.
Перемножает несколько чисел любой длины.
Внимание! Функция использует функции #add#, #zero#, #dz#, каждая из которых основана на циклических расчётах. Сама функция использует для подсчёта 4 цикла, что может замедлять работу программ при вычислении больших значений. Тем не менее функция работает, хотя и несколько подвешивает игру, если выполнять несколько умножений подряд.
$args[ ... 0]$args[ - девять множителей. Могут быть переданы в числовом виде (для QSP 5.7.0 в пределах [-2147483648 ... 2147483647]).
8] $result - всегда текстовое значение.
Функция деления любого числа на любое.
$args[ - делимое, только текстовое
0]$args[ - делитель, только текстовое
1] args[ - точность 1 -целые- 10 десятые доли, 100 сотые, 1000 - тысячные.
2] $result - частное, текстовое значение
Используются функции #dz#, #zero#, #dev#.
Прежде данная функция выглядела так:
Это давало повышенную скорость работы. Где-то в 10 раз быстрее. Однако это и накладывало некоторые ограничения на аргументы. Например, старая версия функции неверно вычисляла вот такие значения:
Теперь ограничение связано только с числом знаков после запятой, до которого можно выполнить вычисления.
Функция сравнивает два числа и выдаёт в результат большее.
Функция использует функции #dz#, #zero#, соответственно для неё актуальны все ограничения связанные с этими функциями.
$args[ - первое число, только текстовое значение
0]$args[ - второе число, только текстовое значение
1] $result - результат, текстовое значение
Внимание, результаты функции даются в обработке функцией #dz#, а значит они могут отличаться по количеству символов с данными, передаваемыми в аргументах. Будьте аккуратны при использовании сравнений.
Вычисление квадратного корня методом Ньютона.
$args[ - число, текстовое значение
0] args[ - точность. Целое число: 100 - сотые, 1000 - тысячные и т.д.
1]$args[ - первое приближение, только текстовое значение. Вы можете указать примерно чему будет равен результат. Это ускорит вычисление
2]
Существует простое линейное уравнение, повторяя вычисление которого несколько раз, мы получаем корень числа с некоторой погрешностью. Чем чаще мы производим вычисление, тем точнее результат. Округление числа производится до требуемого знака после запятой. Когда предыдущее вычисленное значение становится равно предыдущему, проверяется погрешность вычисления. Если погрешность не превышает 0.00000001, число принимается. В противном случае выдаётся ноль.
Функция использует #:#, #*#, #+#, в связи с чем к ней применимы те же ограничения, что и к этим функциям. Так же поскольку производится несколько десятков и сотен циклических вычислений, функция может заметно подвешивать игру даже при вычислении небольших значений. В настоящее время функция позволяет использовать значение первого приближения, чтобы сократить время расчётов. Значение необходимо передавать вторым аргументом ($args[). В будущем таблицы приближений небольших чисел будут непосредственно встроены в функцию.
2]
Даётся в условной записи. Функции в QSP по-прежнему вызываются с помощью ключевого слова $func.
при вычислении без первого приближения расчёт для всех значений в совокупности даёт 9 секунд задержки. При вычислении с первым приближением близким по значению к результату, время на все вычисления составило 3 секунды задержки. Наибольшее количество времени ушло на вычисление корня из 1000, причём без первого приближения это время оказалось в два раза больше, чем с первым приближением.
Простая функция . Подставляет в начало строки '-', если его там нет, и убирает, если он там есть.
$args[ - строка (по идее число в текстовой записи)
0] $result - полученная строка
Честно говоря необходимость в этой функции отпала, когда была разработана вторая версия библиотеки. Поскольку я не помню, где ещё я мог использовать эту функцию, я её оставил. Тем не менее может пригодиться, скажем, для быстрого инвертирования шестнадцатеричных чисел.
