Формат вызова | Описание | Пример использования |
---|
<value>.coalesce(<list_of_values>) | | $)
|
extract(<code_type>, <start_position>[, <length>])
| | $)
|
<string>.format_mac([<delimeter>][, <groups>])
| | $)
|
<number>.gigabytes()
| | $)
|
int([<base>])
| | $)
|
<string>.ip4_and(<mask_string>)
| | $)
|
<string>.ip4_or(<mask_string>)
| | $)
|
<string>.ip4_scan()
| | $)
|
<list_of_strings>.join(<delimeter>)
| | $)
|
<string>.lower()
| Приведение строки <string> к нижнему регистру. | $request.RAD_REQUEST.User-Name.lower()
"sUpErUsEr.321" → "superuser.321" "TEST-LOGIN" → "test-login"
|
<list_of_strings>.map_join(<delimeter>)
| | $)
|
<???>.merge(<list_of_values>)
| | $)
|
<number>.mod(<divider>)
| | $)
|
<string>.normalize_mac()
| | $)
| Приведение MAC-адреса из строки <string> к формату, используемому Гидрой: верхний регистр, пары шестнадцатеричных цифр разделены дефисом. | $request.RAD_REQUEST.Agent-Remote-Id.normalize_mac()
"acf1.dfaf.42c0" → "AC-F1-DF-AF-42-C0" "428d01c53db7" → "42-8D-01-C5-3D-B7"
|
<string>.pad_left(<length>, <pad_string>)
| | $)
| <character>)
| Дополнение строки <string> до длины <length> путём добавления в начало символов <character> . Если длина строки меньше или равна указанной в <length> , возвращается исходная строка <string> . | '0x' + $var.Port-Number.to_hex().substring(2).pad_left(12, "0")
|
<string>.pad_right(<length>, <pad_string>)
| | $)
| <character>)
| Дополнение строки <string> до длины <length> путём добавления в конец символов <character> . Если длина строки меньше или равна указанной в <length> , возвращается исходная строка <string> . | $var.Port-Number.to_hex().pad_right(14, "0")
|
<dictionary>.pairs()
| | $)
|
<string>.regexp_replace(<regexp>[, <replacement_template>]) | Замена в строке <string> удовлетворяющих регулярному выражению <regexp> подстрок в соответствии с шаблоном <replacement_template> . Если <replacement_template> не задан, подстроки удаляются. В шаблоне могут использоваться ссылки на группы из регулярного выражения. Правила замены и синтаксис шаблона идентичны таковым у метода re.sub в Python за исключением необходимости дополнительного экранирования символа \ в шаблоне. | $request.RAD_REQUEST.User-Name.regexp_replace("^office([0-9]+?)$", "\\1")
"office2" → "2" "office123456789" → "123456789"
|
<string>.replace(<string_to_replace>[, <replacement>])
| Замена в строке <string> подстроки подстрок <string_to_replace> на <replacement> . Если <replacement> не задан, подстрока удаляетсяподстроки удаляются. | $request.RAD_REQUEST.Agent-Circuit-Id.replace("0x")
"0x10006a12" → "10006a12"
|
<value>.reverse()
| Изменение порядка символов строки или элементов списка <value> на обратный. | $request.RAD_REQUEST.Cisco-Attributes.h323-incoming-conf-id.reverse()
"A0E8218F 9A4011E4" → "4E1104A9 F8128E0A"
$var.ServicesDNS-Servers-List.reverse()
["Internet-409610.1.0.254", "IPTV", "TurboLimit-24"10.254.0.254"] → ["TurboLimit-2410.254.0.254", "IPTV", "Internet-4096"10.1.0.254"]
|
<string>.split([<separator>[, <maxsplit>]])
| Разбиение строки <string> на части (результат — список строк) по строке-разделителю <separator> . Правила разбиения и аргументы идентичны таковым у метода str.split в Python: описание на docs.python.org. | $response.RAD_REPLY.DHCP-Classless-Static-Route.replace(".", ";").split(';')
"24;192.168.123;10.1.1.1" → ["24", "192", "168", "123", "10", "1", "1", "1"]
$var.Routed-Subnets.split(',')
"192.168.14.128/29,,10.0.0.0/8" → ["192.168.14.128/29", "", "10.0.0.0/8"]
|
<string>.strip()
| Удаление пробелов в начале и конце строки <string> . | $request.RAD_REQUEST.User-Name.strip()
" Vasiliy Terkin " → "Vasiliy Terkin"
|
<string>.substring(<from_position>[, <to_position>])
| Извлечение подстроки из <string> : <from_position> — начало, а <to_position> — окончание. Символы нумеруются с нуля, верхняя граница интервала не включается. Если верхняя граница <to_position> не задана, подстрока извлекается до конца исходной строки. | $request.RAD_REQUEST.DHCP-Relay-Remote-Id.substring(6)
"0x010a31302e3232312e332e34" → "31302e3232312e332e34"
$request.RAD_REQUEST.DHCP-Relay-Circuit-Id.substring(12,14)
"0x0005010d0004e3a1" → "04" "0x0005010d00c" → "c"
|
<string>.to_date(<format>)
| Приведение строки в формате <format> к дате с временем (тип datetime.datetime в Python). Правила преобразования и описания формата идентичны таковым у метода datetime.strptime в Python: описание на docs.python.org. | $request.RAD_REQUEST.Event-Timestamp.to_date("%d.%m.%Y %H:%M:%S")
"06.08.1961 06:00:00" → datetime.datetime(1961, 8, 6, 6, 0)
|
<number>.to_days()
| Приведение количества дней <number> к разнице между датами с временем (тип datetime.timedelta в Python). <number> — целое число, либо преобразуемая к такому числу строка. | $session.attributes.Trial-Period-Days.to_days()
"-5" → datetime.timedelta(-5) 123 → datetime.timedelta(123)
|
<number>.to_hex() | Перевод целого числа <number> в шестнадцатеричную систему с возвращением результата в виде строки в нижнем регистре с префиксом 0x . | $var.Service-Priority.to_hex()
24 → "0x18" -237 → "-0xed"
|
<number>.to_hours()
| Приведение количества часов <number> к разнице между датами с временем (тип datetime.timedelta в Python). <number> — целое число, либо преобразуемая к такому числу строка. | $provider_profile.attributes.Acct-UTC-Offset.to_hours()
"-5" → datetime.timedelta(-1, 68400) 123 → datetime.timedelta(5, 10800)
|
<value><string>.to_i([<base>]) | Приведение <value> содержащей целое число в системе счисления с основанием <base> строки <string> к целому числу. Если <value> — это число, оно будет округлено к меньшему по модулю («к нулю»). Если <value> является строкой, то в ней должно быть только целое десятичное число: - Перед числом может присутствовать знак:
+ или - . Знак может быть отделён от числа пробелами. - По краям могут быть пробелы — они будут отрезаны автоматически.
основаПравила преобразования и ограничения идентичны таковым у конструктора int в Python. | $request.RAD_REQUEST.Bill-Total-Amount.to_i()
"012" → 12 " - 12345 " → -12345 -123.45 → -123
|
<number>.to_minutes()
| Приведение количества минут <number> к разнице между датами с временем (тип datetime.timedelta в Python). <number> — целое число, либо преобразуемая к такому числу строка. | $customer_profile.attributes.Timeout.to_minutes()
"-5" → datetime.timedelta(-1, 86100) 123 → datetime.timedelta(0, 7380)
|
<value>.to_s([<format>])
| Приведение <value> к строке. Если <value> — это дата с временем (тип datetime.datetime в Python), то она будет преобразована в соответствии с форматом <format> (его указание в этом случае обязательно). Правила преобразования и описания формата идентичны таковым у метода datetime.strftime в Python: описание на docs.python.org. | ($var.Connection-Date.to_date("%d.%m.%Y %H:%M:%S") + 1.to_seconds()).to_s("%Y-%m-%dT%H:%M:%S")
datetime.datetime(1961, 4, 12, 9, 7) → "1961-04-12T09:07:00"
|
<number>.to_seconds()
| Приведение количества секунд <number> к разнице между датами (тип datetime.timedelta в Python). <number> — целое число, либо преобразуемая к такому числу строка. | $var.Delay-In-Seconds.to_seconds()
"-5" → datetime.timedelta(-1, 86395) 123 → datetime.timedelta(0, 123)
|
<string>.to_subnet_suffix()
| Определение длины префикса IPv4-подсети с маской <string> (суффикса подсети в CIDR-нотации). | $response.RAD_REPLY.Framed-IP-Netmask.to_subnet_suffix()
"255.255.255.248" → 29 "255.255.240.0" → 20
|
<number>.to_subnet_mask()
| Формирование маски IPv4-подсети с длиной префикса равной <number> бит. <number> — целое число от 0 до 32, либо преобразуемая к такому числу строка. | $customer_profile.attributes.Custom-Netmask-Prefix.to_subnet_mask()
30 → "255.255.255.252" "21" → "255.255.248.0"
|
<value>.try(<key>[, <default_value>])
| Возвращение соответствующего ключу <key> значения из <value> , или значения по умолчанию <default_value> , если такого ключа нет. Если <default_value> не задано, в качестве него используется пустое значение (None ). Особенности поведения в зависимости от типа <value> : - Пустое значение (
None ) — возвращается <default_value> независимо от <key> . Это позволяет применять несколько методов try в одном выражении. - Список — возвращается элемент списка с номером <key>, нумерация элементов списка ведётся с нуля.
<key> — целое неотрицательное число.
| $request.RAD_REQUEST.try("ERX-Service-Session") $customer_profile.provider_profiles.try(0).try("equipment_id") $var.try("Service-Auth-Speed-Limits").try("Rate", "100000000") $response.try("RAD_REPLY").try("Cisco-Account-Info").present?()
|
<string>.unhex()
| Декодирование строки <string> , представленной в виде шестнадцатеричных кодов символов (формат ASCII-HEX). Если в исходной строке есть префикс 0x , он отбрасывается. | $request.RAD_REQUEST.DHCP-Relay-Remote-Id.unhex()
"61383a66393a34623a35623a31623a3032" → "a8:f9:4b:5b:1b:02" "0x3137322e31362e3132302e323130" → "172.16.120.210"
|
<string>.upper()
| Приведение строки <string> к верхнему регистру. | $request.RAD_REQUEST.User-Name.upper()
|