R_TO_S - преобразование числа в строку

Назначение.

Функциональный блок R_TO_S применяется для преобразования вещественного числа в строку заданной длины.

Состав структурной переменной.

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

Описание алгоритма.

На вход INP передается вещественное число, которое будет преобразовано в строку длиной WIGHT. Входной параметр PRECISION позволяет ограничить количество символов после запятой, при этом осуществляется округление до целого числа. Например, для вещественного числа INP=1.118 и двух символов после запятой PRECISION=2 будет возвращена строка '1.12' (два знака после запятой с округлением в большую сторону).

Если значение ALIGN больше количества цифр в числе INP (с учетом точки), то отсутствующие цифры будут заменены на символы пробела по правилам:

при ALIGN=0 символы пробела добавляются в конец строки
при ALIGN=1 символы пробела распределяются равномерно в начало и конец строки. Если четность значения WIGHT и количества цифр (с учетом точки) не совпадает, в конце строки вставляется на один символ пробела больше.
при ALIGN=2 символы пробелы добавляются в начало строки

На выход передается пустая строка, если общее количество символов целой части, точки и вещественной части превышает значение WIGHT. Например:

Пример синтаксиса на языке ST.

//вызов функционального блока

R_TO_S_1.R_TO_S(12345.12345, 10, 2, 1);

//чтение результата преобразования, OUT = ' 12345.12 '

OUT := _R_TO_S_1.OUT;