Conversion Functions¶
fn.pkid_to_bkey: Given a pkid, return the business key.
fn.bkey_to_pkid: Given a business key, return the pkid Provide the data type as an argument.
fn.from_business_key_format: Convert a field business key string format to a list
fn.as_int: Given a string, return an integer.
fn.as_string: Given an integer, return a string.
fn.as_bool: Given strings “True”, “TRUE”, “T”, “t”, “1”, return True. Given strings “False”, “FALSE”, “F”, “f”, “0”, return False.
fn.as_list: Given input, return it as a list. List input is returned as is.
fn.int_to_hex: Return the hexadecimal value of an integer. Application example: for gateways that use hexadecimal values for port numbers.
fn.hex_to_int: Return the integer value of a hexadecimal value. Application example: for gateways that use hexadecimal values for port numbers.
fn.getMajorMinorVersion: Given a version in various formats, return a version of the format <major>.<minor>.
fn.list_to_string: Given a list as input, return the list as a string.
Note the following in the output - refer to the example below:
strings in the list will be prefixed with a Unicode character
u
the “
[
” and “]
” as well as the commas between list items are included in the converted string
fn.list_items_to_string: Given a list as input (strings or integers), return each item as a string.
Only simple lists are supported.
fn.list_items_to_int: Given a list of integers as input, return each item as a string.
Only simple lists are supported.
Only lists of integers are supported.
Examples:
Example |
Output |
---|---|
macro: USA_pkid =
{{data.Countries.__pkid
iso_country_code:USA}}
{{fn.pkid_to_bkey macro.USA_pkid}}
|
"[u'United States of America',
u'USA', u'']"
|
macro: a_country_bkey =
{{data.Countries.__bkey
__pkid:macro.USA_pkid}}
{{fn.bkey_to_pkid macro.a_country_bkey,
data/Countries}}
|
"52d3eba8893d57373f842acb"
|
context data: {
"self": {
"bk": "[\"10.110.21.101\",
\"8443\",
\"hcs.CS-P.CS-NB.AAAGlobal\"]"
}
}
function: {{ fn.from_business_key_format self.bk }}
|
[
"10.110.21.101",
"8443",
"hcs.CS-P.CS-NB.AAAGlobal"
[
|
Example |
Output |
---|---|
{{fn.as_int "1"}}
|
1
|
{{fn.as_string 12345}}
|
"12345"
|
{{fn.as_bool "T"}}
{{fn.as_bool "0"}}
|
true
false
|
{#fn.as_list foo bar#}
{#fn.as_list 'foo,bar'#}
{#fn.as_list ['foo','bar']#}
|
['foo bar']
['foo,bar']
['foo','bar']
|
{{fn.int_to_hex 255}}
|
ff
|
{{fn.hex_to_int ff}}
|
255
|
Example |
Output |
---|---|
{{ fn.getMajorMinorVersion 10.5(4) }}
{{ fn.getMajorMinorVersion 11.5(1) SU1 }}
{{ fn.getMajorMinorVersion 11.5.3 }}
|
10.5
11.5
11.5
|
{"pwf": {
"my_list": [1, null, 2,"test", 3, null]
}
}
{{ fn.list_to_string pwf.my_list }}
|
"[1, None, 2, u'test', 3, None]"
|
{"pwf": {
"my_list": [1, 2, "3", 4]
}
}
{{ fn.list_items_to_string pwf.my_list }}
|
['1', '2', '3', '4']
|
{"pwf": {
"my_list": [1, 2, "3", 4]
}
}
{{ fn.list_items_to_int pwf.my_list }}
|
[1, 2, 3, 4]
|