TBEL Helper Functions

var encodedData = btoa("Hello, world"); // encode a string
var decodedData = atob(encodedData);    // decode the string

var encodedData = btoa("Hello, world");
var decodedData = atob(encodedData); // "Hello, world"

toFixed(0.345, 1); // 0.3
toFixed(0.345, 2); // 0.35

toInt(0.3); // 0
toInt(0.5); // 1
toInt(2.7); // 3

stringToBytes("hello world");
// [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]

var base64Str = "eyJoZWxsbyI6ICJ3b3JsZCJ9";
var bytesStr = atob(base64Str);
stringToBytes(bytesStr);
// [123, 34, 104, 101, 108, 108, 111, 34, 58, 32, 34, 119, 111, 114, 108, 100, 34, 125]

stringToBytes("hello world", "UTF8");
// [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]

var bytes = [0x48, 0x45, 0x4C, 0x4C, 0x4F];
bytesToString(bytes); // "HELLO"

var base64Str = "eyJoZWxsbyI6ICJ3b3JsZCJ9";
var bytesStr = atob(base64Str);
var bytes = stringToBytes(bytesStr);
decodeToJson(bytes); // {"hello": "world"}

isBinary("1100110"); // 2
isBinary("2100110"); // -1

isOctal("4567734"); // 8
isOctal("8100110"); // -1

isDecimal("4567039"); // 10
isDecimal("C100110"); // -1

isHexadecimal("F5D7039"); // 16
isHexadecimal("K100110"); // -1

isNaN(0.0 / 0.0); // true
isNaN(1.0);        // false

var uri = "-_.!~*'();/?:@&=+$,#ht://example.ж д a/path with spaces/?param1=Київ 1&param2=Україна2";
encodeURI(uri);
// "-_.!~*'();/?:@&=+$,#ht://example.%D0%B6%20%D0%B4%20a/path%20with%20spaces/?param1=%D0%9A%D0%B8%D1%97%D0%B2%201&param2=%D0%A3%D0%BA%D1%80%D0%B0%D1%97%D0%BD%D0%B02"

var encoded = "-_.!~*'();/?:@&=+$,#ht://example.%D0%B6%20%D0%B4%20a/path%20with%20spaces/?param1=%D0%9A%D0%B8%D1%97%D0%B2%201&param2=%D0%A3%D0%BA%D1%80%D0%B0%D1%97%D0%BD%D0%B02";
decodeURI(encoded);
// "-_.!~*'();/?:@&=+$,#ht://example.ж д a/path with spaces/?param1=Київ 1&param2=Україна2"

raiseError("frequency_weighting_type must be 0, 1 or 2.");
// throws RuntimeException: "frequency_weighting_type must be 0, 1 or 2."

var value = 4;
var message = "frequency_weighting_type must be 0, 1 or 2. A value of " + value + " is invalid.";
raiseError(message);
// throws RuntimeException with the composed message

var list = hexToBytes("D8FF");
printUnsignedBytes(list); // [216, 255]

var list2 = hexToBytes("FFD8");
printUnsignedBytes(list2); // [255, 216]

padStart("010011", 8, '0');      // "00010011"
padStart("1001010011", 8, '0');  // "1001010011" (already >= 8)
padStart("1001010011", 16, '*'); // "******1001010011"

var fullNumber = "203439900FFCD5581";
var last6 = fullNumber.substring(11);
padStart(last6, fullNumber.length(), '*'); // "***********CD5581"

padEnd("010011", 8, '0');      // "01001100"
padEnd("1001010011", 8, '0');  // "1001010011" (already >= 8)
padEnd("1001010011", 16, '*'); // "1001010011******"

var fullNumber = "203439900FFCD5581";
var first11 = fullNumber.substring(0, 11);
padEnd(first11, fullNumber.length(), '*'); // "203439900FF******"

intToHex(0x7FFFFFFF, true, true);       // "0x7FFFFFFF"
intToHex(171, true, false);              // "AB"
intToHex(0xABCDEF, false, true, 4);     // "0xCDAB"
intToHex(0xABCD, false, false, 2);      // "AB"

longToHex(9223372036854775807, true, true);    // "0x7FFFFFFFFFFFFFFF"
longToHex(0x7A12BCD3, true, true, 4);          // "0xBCD3"
longToHex(0x7A12BCD3, false, false, 4);        // "127A"

floatToHex(123456789.00);        // "0x4CEB79A3"
floatToHex(123456789.00, false); // "0xA379EB4C"

doubleToHex(1729.1729d);        // "0x409B04B10CB295EA"
doubleToHex(1729.1729d, false); // "0xEA95B20CB1049B40"

intLongToRadixString(58, 2);                    // "00111010"
intLongToRadixString(9223372036854775807, 2);   // "0111111111...1" (63 digits)
intLongToRadixString(13158, 8);                 // "31546"
intLongToRadixString(-13158, 8);                // "1777777777777777746232"
intLongToRadixString(-13158, 10);               // "-13158"
intLongToRadixString(13158, 16);                // "3366"
intLongToRadixString(-13158, 16);               // "FFCC9A"
intLongToRadixString(9223372036854775807, 16);  // "7FFFFFFFFFFFFFFF"
intLongToRadixString(-13158, 16, true, true);   // "0xFFCC9A"

parseHexToInt("BBAA");        // 48042
parseHexToInt("BBAA", true);  // 48042
parseHexToInt("AABB", false); // 48042
parseHexToInt("BBAA", false); // 43707

parseHexToFloat("41EA62CC");         // 29.29824
parseHexToFloat("41EA62CC", true);   // 29.29824
parseHexToFloat("41EA62CC", false);  // -5.948442E7
parseHexToFloat("CC62EA41", false);  // 29.29824

parseHexIntLongToFloat("0x0A", true);     // 10.0
parseHexIntLongToFloat("0x0A", false);    // 10.0
parseHexIntLongToFloat("0x00000A", true); // 10.0
parseHexIntLongToFloat("0x0A0000", false); // 10.0
parseHexIntLongToFloat("0x000A0A", true); // 2570.0
parseHexIntLongToFloat("0x0A0A00", false); // 2570.0

parseHexToDouble("409B04B10CB295EA");         // 1729.1729
parseHexToDouble("409B04B10CB295EA", true);   // 1729.1729
parseHexToDouble("409B04B10CB295EA", false);  // -2.7208640774822924E205
parseHexToDouble("EA95B20CB1049B40", false);  // 1729.1729

hexToBytes("D8FF"); // [-40, -1]

parseBytesToInt([0xBB, 0xAA]);        // 48042
parseBytesToInt([0xBB, 0xAA], true);  // 48042
parseBytesToInt([0xAA, 0xBB], false); // 48042

parseByteToBinaryArray(0xFF); // [1, 1, 1, 1, 1, 1, 1, 1]
parseByteToBinaryArray(0x00); // [0, 0, 0, 0, 0, 0, 0, 0]

parseBytesToBinaryArray([0xFF, 0x00]);
// [1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0]

parseLongToBinaryArray(255L);
// [0,0,...,0, 1,1,1,1,1,1,1,1] (56 zeros followed by 8 ones)

parseBinaryArrayToInt([1, 1, 1, 1, 1, 1, 1, 1]); // 255
parseBinaryArrayToInt([0, 0, 1, 1, 1, 0, 1, 0]); // 58

parseInt("123"); // 123

parseLong("9223372036854775807"); // 9223372036854775807

parseFloat("3.14"); // 3.14

parseDouble("3.141592653589793"); // 3.141592653589793

var a = 0xFF;
var b = 0x0F;
var andResult = a & b;  // 15 (0x0F)
var orResult  = a | b;  // 255 (0xFF)
var xorResult = a ^ b;  // 240 (0xF0)
var shifted   = 1 << 8; // 256

base64ToHex("SGVsbG8gV29ybGQ="); // "48656C6C6F20576F726C64"

bytesToBase64([72, 101, 108, 108, 111]); // "SGVsbG8="

base64ToBytes("SGVsbG8gV29ybGQ=");
// [72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]

var json = {"temperature": 42, "nested": {"humidity": 73}};
toFlatMap(json);
// {"temperature": 42, "nested.humidity": 73}

var json = {"temperature": 42, "nested": {"humidity": 73}};
toFlatMap(json, true);  // {"temperature": 42, "nested.humidity": 73}
toFlatMap(json, false); // {"temperature": 42, "humidity": 73}

var json = {"temperature": 42, "nested": {"humidity": 73, "pressure": 1013}};
toFlatMap(json, ["pressure"]);
// {"temperature": 42, "nested.humidity": 73}

var json = {"temperature": 42, "nested": {"humidity": 73, "pressure": 1013}};
toFlatMap(json, ["pressure"], true);
// {"temperature": 42, "nested.humidity": 73}

var date1 = new Date("2024-01-15");
var date2 = new Date("15/01/2024", "dd/MM/yyyy");
var date3 = new Date("15/01/2024", "dd/MM/yyyy", "en_US");
var date4 = new Date("15/01/2024", "dd/MM/yyyy", "en_US", "UTC");

var date1 = new Date(2024, 1, 15);
var date2 = new Date(2024, 1, 15, 14, 30, 45);
var date3 = new Date(2024, 1, 15, "UTC");
var date4 = new Date(2024, 1, 15, 14, 30, 45, "UTC");

var options = {
    pattern: "yyyy-MM-dd HH:mm:ss",
    locale: "en_US",
    timeZone: "UTC"
};
var date = new Date("2024-01-15 14:30:45", options);

var date = new Date(2024, 1, 15);
date.addYears(1);          // 2025-01-15
date.addMonths(2);         // 2025-03-15
date.addWeeks(1);          // 2025-03-22
date.addDays(5);           // 2025-03-27
date.addHours(3);          // 2025-03-27 03:00
date.addMinutes(30);       // 2025-03-27 03:30
date.addSeconds(45);       // 2025-03-27 03:30:45
date.addMilliseconds(500); // 2025-03-27 03:30:45.500

var polygon = [
    [55.75, 37.61],
    [55.75, 37.62],
    [55.74, 37.62],
    [55.74, 37.61]
];
isInsidePolygon(55.745, 37.615, polygon); // true

isInsideCircle(55.745, 37.615, 55.75, 37.62, 1.5); // true (within 1.5 km)