# Преобразование типов данных

/**
 * Преобразует аргумент в строку
 * @param {Integer, Real, Boolean} arg целое число
 * @return {String}
 */
function String(arg) {...}

// Пример
String(123.45)
// '123.45'

String(false)
// 'false'

/**
 * Преобразует целочисленный аргумент в строку.
 * @param {Integer} arg           целое число
 * @param {Integer} digitsNum     минимальное число символов в строке. Недостающие символы компенсируются нулями перед числом. Необязательный аргумент.
 * @param {Boolean} addGroupDelim разделять тысячные разряды пробелами. Необязательный аргумент.
 * @return {String}
 */
function StrInt(arg, digitsNum, addGroupDelim) {...}

// Пример
StrInt(11500);
// '11500'

StrInt(11500, 6);
// '011500' 

StrInt(11500, 0, true);
// '11 500'

/**
 * Преобразует вещественный аргумент в строку.
 * @param {Real} arg              вещественный аргумент
 * @param {Integer} pricision     максимальное число знаков после запятой (Integer). По умолчанию 6. Необязательный аргумент. 
 * @param {Boolean} addGroupDelim разделять тысячные разряды пробелами (Bool). Необязательный аргумент.
 * @return {String}
 */
function StrReal(arg, pricision, addGroupDelim) {...}

// Пример
StrReal(90154.249);
// '90154.249'

StrReal(90154.249, 2);
//'90154.25'

StrReal(90154.249, 2, true);
//'90 154.25'

/**
 * Преобразует вещественный аргумент в строку, с фиксированным количеством символов в дробной части.
 * @param {Real} arg              вещественный аргумент
 * @param {Integer} pricision     число символов в дробной части числа. Недостающие символы компенсируются нулями. 
 * @param {Boolean} addGroupDelim разделять тысячные разряды пробелами. Необязательный аргумент.
 * @return {String}
 */
function StrRealFixed(arg, pricision, addGroupDelim) {...}

// Пример
StrRealFixed(90154.2);
// '90154.20'

StrRealFixed(90154.2, 2, true);
// '90 154.20'

/**
 * Преобразует целое число в словесное строковое представление. Только для русского языка.
 * @param {Integer} arg    числовой аргумент
 * @param {Integer} gender род (0 - мужской, 1 - женский). Необязательный аргумент.
 * @return {String}
 */
function TextInt(arg) {...}

// Пример
TextInt(121);
// 'сто двадцать один'

TextInt(121, 1);
//'сто двадцать одна'

/**
 * Преобразует дату в строку в "длинном" формате (со словесным написанием месяца). Если в качестве аргумента передается null или пустая строка, функция возвращает пустую строку.
 * @param {Date, null, ""} Объект Date
 * @return {String}
 */
function StrLongDate(date) {...}

// Пример
StrLongDate(Date('06.10.2009 11:44:37'));
// '6 октября 2009 г.';

/**
 * Возвращает строку, полученную путем склеивания данных из элементов массива.
 * @param {Array} array ма\ссив
 * @param {String} elemExpr выражение, вычисляющее значение, используемое для склейки, относительно элемента массива
 * @param {String} delim строка-разделитель. Необязательный аргумент.
 * @return {String}
 */
function ArrayMerge(array, elemExpr, delim) {...}

// Пример
ArrayMerge(groupDoc.TopElem.collaborators, "This.person_fullname", ",");
// "Васильева Людмила Петровна,Жирова Антонина Васильевна,Иванов Иван Иванович" 

/**
 * Преобразует значение аргумента к целому числу. Если аргумент не может быть преобразован к целому числу, функция отрабатывает с ошибкой.
 * @param {Integer} arg целое число, вещественное число или строка, содержащая число
 * @return {Integer, Error}
 */
function Int(arg) {...}

// Пример
 Int(123)
 // 123

 Int('123')
 // 123

 Int(123.45)
 // 123

/**
 * Преобразует целое положительное число в отрицательное число
 * @param {0 - Integer} arg ноль минус целое положительное число, которое надо преобразовать в отрицательное
 * @return {Integer}
 */
function StrSignedInt(arg) {...}

// Пример
StrSignedInt(0-5423);
// -5423

/**
 * Преобразует значение аргумента к вещественному числу. Если аргумент не может быть преобразован к вещественному числу, функция отрабатывает с ошибкой
 * @param {Integer, Real, String} arg целое число, вещественное число или строка, содержащая вещественное число
 * @return {Real, Error}
 */
function Real(arg) {...}

// Пример
Real(12.6);
// 12.6

Real('12.6'); 
// 12.6