Функция из строки вида aaa|bbb|ccc|...|yyy|zzz
получает подстроку, стоящую в указанной позиции. Подстроки помещаются между разделителями. По умолчанию разделителем является вертикальная черта.
$args[
- строка
0
] args[
- позиция, из которой нужно получить подстроку.
1
]$args[
- разделитель. По умолчанию в качестве разделителя используется вертикальная черта.
2
]
Заготовленная строка:
Примеры работы функции:
Получает содержимое одиночного тега[1] из строки.
$args[
- текст, из которого нужно извлечь содержимое тега.
0
]$args[
- корень тега. Можно указать ключ 1
]/h
, чтобы вести проверку, соответствуют ли символы шестнадцатеричному числу; в этом случае, если содержимое тега не соответствует шестнадцатеричному числу, функция вернёт пустую строку.
Результат - только текстовое значение.
Примеры одиночных тегов с корнем tag
:
Первые два типа записей не должны содержать пробельных символов, остальные - могут. Тем не менее не рекомендуется использовать данную функцию для извлечения данных с пробельными символами.
Заготовленная строка:
Извлечённые значения:
Получает содержимое двойного тега из строки.
$args[
- текст, содержащий тег.
0
]$args[
- корень тега.
1
]
Результатом может быть только текстовое значение.
Примеры двойных тегов с корнем tag
:
Заготовленная строка:
Извлечённые значения:
Возвращает название переменной, содержащей максимальное значение.
$args[
- имена переменных, или точные указания на ячейки массивов, перечисленные списком через запятую
0
]$args[
... 1
]$args[
- каждый аргумент — отдельное имя переменной, или указание на конкретную ячейку массива, либо управляющая конструкция.
8
]
Пример:
В $args[
может быть не одно, а несколько имён переменных или конкретных ячеек массива, разделённых запятыми:0
]
При указании текстовых индексов для элементов массива в таком списке недопустимо, чтобы в этих текстовых индексах присутствовали запятые. Для указания таких ячеек массива используйте аргументы с $args[
по 1
]$args[
, либо замените в индексах запятые на 8
]%,%
.
Если нужно провести поиск максимального среди всех значений массива, можно использовать ключ /arr
, чтобы указать, что данное имя является не просто именем переменной (то есть нулевой ячейки массива), но и всего массива.
В последнем аргументе (номер аргумента при этом не важен) можно использовать управляющие конструкции. Аргументы после аргумента с управляющими конструкциями будут проигнорированы.
Список управляющих конструкций:
[list]
- в этом режиме функция возвращает список всех имён переменных, содержащих максимальное значение, если это значение присутствует во всех этих переменных.[max]
- в этом режиме функция производит поиск максимального значения. Режим по умолчанию, т.е. можно не указывать.[min]
- в этом режиме функция производит поиск минимального значения. Имеет приоритет над [max]
, если указаны оба.Возвращает название переменной, содержащей минимальное значение.
$args[
- имена переменных, или точные указания на ячейки массивов, перечисленные списком через запятую
0
]$args[
... 1
]$args[
- каждый аргумент — отдельное имя переменной, или указание на конкретную ячейку массива, либо управляющая конструкция.
8
]
Пример:
В $args[
может быть не одно, а несколько имён переменных или конкретных ячеек массива, разделённых запятыми:0
]
При указании текстовых индексов для элементов массива в таком списке недопустимо, чтобы в этих текстовых индексах присутствовали запятые. Для указания таких ячеек массива используйте аргументы с $args[
по 1
]$args[
, либо замените в индексах запятые на 8
]%,%
.
Если нужно провести поиск минимального среди всех значений массива, можно использовать ключ /arr
, чтобы указать, что данное имя является не просто именем переменной (то есть нулевой ячейки массива), но и всего массива.
В последнем аргументе (номер аргумента при этом не важен) можно использовать управляющие конструкции. Аргументы после аргумента с управляющими конструкциями будут проигнорированы.
Список управляющих конструкций:
[list]
- в этом режиме функция возвращает список всех имён переменных, содержащих минимальное значение, если это значение присутствует во всех этих переменных.Данная функция является надстройкой над функцией em.maxVar
.
Функция получает тип переменной.
$args[0
]
- имя переменной/массива. Можно указывать название непосредственно переменной/массива, или конкретную ячейку масссива.
$result
- в результате функция возвращает строку:
'both'
- этот результат означает, что существуют как текстовое, так и числовое значение для указанной переменной. В плеерах версии 5.7.0 и ниже в одном массиве под одним и тем же индексом можно хранить как текстовое так и числовое значение. Например:
'both'
'string'
- этот результат означает, что переменная содержит только текстовое значение отличное от значения переменной по умолчанию.'number'
- этот результат означает, что переменная содержит только числовое значение отличное от значения переменной по умолчнаию.'empty'
- этот результат означает, что переменная не создана, либо содержит значение по умолчанию, текстовое и числовое.Вызов:
Символ "$"
перед названием переменной при определении типа роли не играет.
Проверить тип переменных args
и result
с помощью данной функции нельзя, однако можно проверить тип любой другой локальной переменной.
Функция обратная функции rgb, встроенной в QSP. То есть данная функция наоборот: переводит числовой код цвета в три составляющие.
args[0
]
- числовой код цвета.
$args[1
]
- управляющая конструкция. При желании вы можете передать в этом параметре ключ '\wa'
, чтобы в результат была включена составляющая альфа-канала.
$result
или result
- функция возвращает все три составляющие в виде кортежа (если указать хотя бы два управляющих слова, или не указать ни одного), или возвращает в виде числа одну составляющую (если указать одну управляющую конструкцию).
[1] Теги - это метки в тексте, которые отмечают некоторую информацию. В контексте данного руководства и связанных с библиотекой программ различаются одиночные и двойные теги. Одиночные теги отличаются тем, что не требуют закрытия. Двойные теги состоят из открывающего и закрывающего элементов. Содержимое тегов - это информация, которую они отмечают, или выделяют. Пример: <p>Текст параграфа</p>
- здесь мы видим открывающий и закрывающий элементы тега 'p'
, между которыми размещён текст. В контексте данного руководства 'p'
— это корень тега, — а текст, размещённый между элементами тега, называется содержимым тега.
Aleks Versus'Easy Libraries'2013-2024
Aleks Versus'Game Adventure Making'Really Unimaginable Stories'2013-2024