Базовые встроенные функции

Базовые встроенные функции могут использоваться без ограничений при формировании любых публикаций и личных данных. Часть из них реализованы специально для нужд данной системы, а часть являются простыми ссылками на PHP-функции, их полными аналогами как с точки зрения именования, так и с точки зрения правил использования (порядка и типа передачи параметров). Дополнительные аналоги PHP-функций могут быть включены администратором в систему простой регистрацией их в конфигурационном файле вычислительной среды. Также несложно создать и включить в состав системы PHP-переходники, регламентирующие порядок использования тех или иных дополнительно подключаемых PHP-функций для разных категорий пользователей.

ip() - возвращает имя пользователя, обратившегося к публикации.

sp() - возвращает статус текущего пользователя (0 - неавторизованный, 1 - Читатель, 2 - Писатель, 3 - Эксперт, 6 - Редактор, 7 - Администратор).

@vzp("Ваш идентификатор=",ip(),"Ваш статус=",sp())

stroka(p1,p2,...,pN) - сцепляет все переданные ей аргументы в единую строку без каких-бы то ни было разделителей. Аргументами могут быть значения любого типа - переменные, константы и одномерные массивы.

Остальные строковые функции являются либо прямыми отсылками к PHP-функциям, либо простыми переходниками к ним. Поэтому здесь приведены лишь краткие описания. Детали см. в справках по PHP-функциям.

strlen(s) - возвращает число символов в строке s.

Пустые символы:

ltrim(str) - возвращает строку str с удалёнными из начала строки пустыми символами.

rtrim(str) - возвращает строку str с удалёнными в конце строки пустыми символами.

trim(str) - возвращает строку str с удалёнными в начале и конце строки пустыми символами.

strtoupper(str) - возвращает строку str, в которой все символы переведены в верхний регистр.

strtolower(str) - возвращает строку str, в которой все символы переведены в нижний регистр.

strpos(haystack,needle,offset) - возвращает позицию первого вхождения подстроки needle в строку haystack. Если подстрока needle не найдена, возвращает NULL. Если задан offset, то поиск начинается с символа с номером offset (нумерация символов строк начинается с нуля).

substr(str,start,dlina) - возвращает подстроку строки str длиной dlina, начинающегося со start символа по счету. Если параметр dlina не задан, то выбираются все символы до конца строки.

str_replace(search,replace,subject) - возвращает строку subject, в которой все вхождения search заменены на replace.

strcmp(str1,str2) - возвращает отрицательное число, если str1 меньше, чем str2; положительное число, если str1 больше, чем str2, и 0 если строки равны. Функция учитывает регистр символов.

strcmpx(str1,str2) - возвращает отрицательное число, если str1 меньше, чем str2; положительное число, если str1 больше, чем str2, и 0 если строки равны. Функция НЕ учитывает регистр символов.

strncmp(str1,str2,n) - возвращает отрицательное число, если str1 меньше, чем str2; положительное число, если str1 больше, чем str2, и 0 если строки равны. Функция учитывает регистр символов и сравнивает только первые n символов.

convert_cyr_string(str,from,to) - преобразует строку str из одной кириллической кодировки в другую. Аргументы from и to задают входную и выходную кодировки, соответственно, и состоят из одного символа. Поддерживаются следующие кодировки:

ostatok(x,n) - возвращает остаток от целочисленного деления x на n. Если либо x, либо n не являются целыми числами, то они округляются до ближайшего целого.

cislo(x) - возвращает 1, если аргумент x является числом и 0 в противном случае.

rnd(x) - случайное число в диапазоне от 0 до 1.

Остальные математические функции являются либо прямыми отсылками к PHP-функциям, либо простыми переходниками к ним. Поэтому здесь приведены лишь краткие описания. Детали см. в справках по PHP-функциям.

sqrt(x) - возвращает квадратный корень x, если его можно вычислить.

pow(x,p) - возвращает значение x в степени p, если значение можно вычислить.

exp(x) - возвращает экспоненту x.

log(x,b) - возвращает логарифм x по основанию b или NULL, если x<=0. Если b не задано, возвращает натуральный логарифм

ln(x) - возвращает натуральный логарифм x или NULL, если x<=0.

cos(x) - возвращает косинус x.

sin(x) - возвращает синус x.

tan(x) - возвращает тангенс x.

acos(x) - возвращает арккосинус x.

asin(x) - возвращает арксинус x.

atan(x) - возвращает арктангенс x.

deg2rad(x) - переводит градусы в радианы .

rad2deg(x) - переводит радианы в градусы.

pi() - значение числа пи с точностью до 14 знаков.

abs(x) - возвращает абсолютное значение x.

round(x,r) - округляет значение x до r десятичных знаков. Если r не задано или равно нулю, то до ближайшего целого.

max(p1,p2,...,pN) - возвращает максимальное значение из списка параметров или массива.

min(p1,p2,...,pN) - возвращает минимальное значение из списка параметров или массива.

mt_rand(a,b) - возвращает целое случайное число в диапазоне от a до b. Параметры можно не задавать.

mt_getrandmax() - возвращает максимальное значение случайного целого числа.

decbin(x) - переводит десятичное число в двоичное

dechex(x) - переводит десятичное число в шестнадцатиричное

decoct(x) - переводит десятичное число в восьмеричное

octdec(x) - переводит восьмеричное число в десятичное

hexdec(x) - переводит шестнадцатиричное число в десятичное

vms(x) - выводит значения индексов всех уровней массива x. Видоизменённый аналог php-функции print_r().

massiv(s[,r]) - преобразует строку s в массив. Строка разбивается на слова по разделителю r. Если параметр r не задан, то разделителями слов считаются пробелы. Каждое слово становится элементом массива. Если в слове имеется символ "двоеточие" (:), то последовательность символов до двоеточия становится индексом данного элемента, а последовательность символов после двоеточия - его значением. Если символ двоеточия в слове отсутствует, то в качестве индекса принимается очередное целое число.

~x=massiv("1 2 a:3 b:4 5 6 c:7")

@vms(x)

Array
(
    [0] => 1
    [1] => 2
    [a] => 3
    [b] => 4
    [2] => 5
    [3] => 6
    [c] => 7
)

zv(z,k) - возвращает массив из k элементов, заполненных значением z.

Остальные математические функции являются либо прямыми отсылками к PHP-функциям, либо простыми переходниками к ним. Поэтому здесь приведены лишь краткие описания. Детали см. в справках по PHP-функциям.

is_array(a) - возвращает 1, если переменная a является массивом и 0 в противном случае.

array_keys(a) - возвращает массив индексов элементов массива a. Индексами полученного массива являются натуральные числа, начиная с нуля.

array_values(a) - возвращает массив значений элементов массива a. Индексами полученного массива являются натуральные числа, начиная с нуля.

count(a) - возвращает число значений массива a. Синоним ke (количество элементов).

array_unique(a) - возвращает массив a без повторяющихся значений. Индексы элементов, которые остались в массиве, остаются без изменений.

array_slice(array,offset,length) - возвращает последовательность элементов массива array, которая начинается на расстоянии offset от его начала и включает length элементов. Если length не задан, в последовательность войдут все элементы исходного массива array, начиная с позиции offset. Функция изменяет ключи массива.

array_diff(a1,a2) - возвращает массив, состоящий из значений массива a1, которые отсутствуют в массиве a2. Индексы сохраняются.

array_sum(x) - возвращает сумму элементов массива x.

array_merge(a1,a2,...,aN) - объединяет элементы одного или большего количества массивов таким образом, что значения одного массива присоединяются к концу предыдущего. Если входные массивы имеют одинаковые строковые ключи, тогда каждое последующее значение будет заменять предыдущее. Однако, если массивы имеют одинаковые числовые ключи, значение, упомянутое последним, не заменит исходное значение, а будет добавлено в конец массива. В результирующем массиве значения исходного массива с числовыми ключами будут перенумерованы в возрастающем порядке, начиная с нуля.

array_search(a,x) - возвращает ключ первого вхождения значения x массив a. Если значение не найдено - возвращается NULL.

array_rand(a[,n]) - возвращает n случайных ключей из массива a. По умолчанию n=1. Если выбирается только одно значение, то возвращается ключ, соответствующий этому значению. Если n>1, то возвращается массив ключей, соответствующих случайным значениям.

asort(a) - Сортирует массив a в порядке возрастания и поддерживает ассоциацию индексов.

arsort(a) - Сортирует массив a в порядке убывания и поддерживает ассоциацию индексов.

ksort(a) - Сортирует массив a в порядке возрастания ключей и поддерживает ассоциацию индексов.

krsort(a) - Сортирует массив a в порядке убывания ключей и поддерживает ассоциацию индексов.

array_count_values(a) - возвращает массив, ключами которого являются значения массива a (которые должны быть целыми числами или строками), а значениями - количество повторений этих значений в массиве.

array_intersect(a1,a2,...,aN) - возвращает массив, содержащий все значения массива a1, которые содержатся во всех остальных массивах. Ключи сохраняются.

implode(r,a) - объединяет элементы массива a в строку с разделителями r.

explode(r,s) - создаёт массив из элементов строки s, разделённых разделителем r.

В системе все даты представляются в формате ГГГГ-ММ-ДД - четырёхзначный номер года, двузначный номер месяца, двузначный номер дня. Поэтому все даты должны подаваться функциям их обработки именно в таком формате.

dmd(d1,d2) - возвращает число дней между двумя датами.

@vzp(dmd('2022-12-31','2023-12-31'))

spv(sek) - переводит число секунд sek в часы, минуты и секунды.

@vzp(spv(102022000))

vpd(dx) - восстанавливает представление полной даты в соответствии с правилами системы. Добавляет ведущие нули, если не задан месяц или день выбирает примерно середину года или месяца.

@vzp(vpd('532-3-7'))

@vzp(vpd('64-3'))

@vzp(vpd('1960'))

Система позволяет вставлять произвольный html-код в статьи. Из программ на встроенном языке его можно просто выводить в текст статьи функцией vzp(), комбинируя данные нужным образом с функциями обработки строк. Однако имеется множество примитивов для вывода html-конструкций, которые во многих случаях могут существенно упростить работу. Многочисленные примеры использования подобных функций приведены в статьях, посвящённых рассмотрению существующих расширений системы.

nt(x) - выводит заголовок таблицы типа x (класс tbx).

kt() - выводит конец таблицы.

nst(x) - выводит начало строки таблицы типа x (класс trx)

kst() - выводит конец строки таблицы.

td(z,k,n,s) - выводит ячейку таблицы co значением z, объединяя k столбцов, применяя класс tdn и объединяя s строк. Если не задан ни один параметр - выводится пустая ячейка. Если не заданы k,n,s, то значение z выводится в одинарной ячейке с классом td1. Если не заданы n,s, то значение z выводится в ячейке, объединяющей k столбцов с классом td1. Если не задано s, то значение z выводится в ячейке, объединяющей k столбцов с классом tdn.

tdc(z,k,n,s) - то же, что и td(), но с выравниванием z центру.

tdr(z,k,n,s) - то же, что и td(), но с выравниванием z вправо.

st(t,p1,p2,...,pN) - выводит строку таблицы стиля t полностью. Если параметр pi является скалярной величиной, то он выводится в одну ячейку. Если параметр - массив, то каждый его элемент выводится в отдельной ячейке. Если t=1, а параметр распознаётся как полноценное число, то оно округляется по разумным правилам (см. далее) и выравнивается в ячейке вправо, в противном случае призводится выравнивание влево. Если тип строки t>1, то вывод значений производится по правилам заголовка - по центру.

@nt(1)

@st(2,massiv("1 2 3 4 5 6"))

@st(1,massiv("Строка1 10 20 30 40 50"))

@st(1,massiv("Строка2 100 200 300 нет 500"))

@kt()

vvt(v) - выводит одномерный массив v как таблицу с заголовками - ключами.

@vvt(massiv("Строка2 100 200 300 нет 500"))

vmt(v[,p]) - выводит двумерный массив m как таблицу с ключами строк и столбцов.

~w('a')=massiv('10 20 30 40')

~w('i')=massiv('100 200 300 400')

@vmt(w)

При использовании необязательного параметра p помимо вывода данных двумерного массива в каждой ячейке могут выводиться также дополнительные данные:

Параметр p может быть массивом с необязательным набором ключей ik, ga, va или строкой, содержащей данные в формате ключ:значение, где ключами выступают параметры ik, ga, va. В последнем случае строка трансформируется в массив с этими ключами.

Если задан ключ ik и его значение ненулевое, то внизу таблицы выводятся итоги по соответствующей колонке.

При задании ненулевого (непустого) значения ключа ga каждая ячейка таблицы, помимо абсолютного значения, будет содержать значение его относительного изменения по отношению к базе, принимаемой за 100 по данной строке. В качестве базы принимается первое ненулевое числовое значение в данной строке при просмотре строки слева направо. Значение вычисляется, если может быть вычислено (соответствующий элемент массива имеет числовой значение). По сути дела - это базисные темпы роста по данной строке.

При задании ненулевого (непустого) значения ключа va каждая ячейка таблицы, помимо абсолютного значения, будет содержать значение его доли в процентах относительно суммы значений элементов в данном столбце. Значение вычисляется, если может быть вычислено (соответствующий элемент массива имеет числовое значение).

Пример использования специальных параметров.

~w=massiv()

~w('a')=massiv('1000 2000 3000 4000')

~w('b')=massiv('2000 1000 2000 3000')

@vmt(w,'ik:1 ga:1 va:1')

В данном примере сначала "сбрасываются" значения массива w, поскольку ранее он уже использовался. Далее создаётся двумерный массив из двух строк и четырёх столбцов. Функция vmt указана с дополнительных параметром, в котором заданы требования выводить итоги по столбцам (ik:1), базисные темпы роста по строкам (ga:1), а также процент значения в конкретной ячейке по отношению к итогу по столбцу (va:1).

В результате получаем вывод, в котором каждая ячейка данных таблицы включает три числа: абсолютное значение, базисный темп роста по отношению к строке, а также его процент по отношению к итогу по столбцу. Внизу таблицы выводятся: сумма значений по столбцу, а также базисный темп роста итогов по столбцу. Процентное отношение не выводится, поскольку оно везде равно 100.

Наиболее типовое применение использования функции vmt() с дополнительными параметрами - типовые задачи горизонтального (va) и вертикального (va) анализа статей бухгалтерской отчётности. В данном случае строками будут являться статьи баланса, а столбцами - периоды.

is(t,h,w,p) - выводит индексируемую ссылку h с текстом t на окно с именем w и всплывающим комментарием p. Если w=0, то ссылка открывается в том же окне, если w=1 - в новом. Параметры w и p не обязательны. По умолчанию w=1.

ss(t,h,w,p) - выводит служебную ссылку (с пожеланиями роботам по ней не переходить и содержимое не индексировать) h с текстом t на окно с именем w и всплывающим комментарием p. Если w=0, то ссылка открывается в том же окне, если w=1 - в новом. Параметры w и p не обязательны. По умолчанию w=1.

vc(t) - выводит текст t по центру блока.

cz(z,u) - выводит заголовок уровня u (1,2,3) с текстом z по центру блока.

vis(f) - выводит изображение из файла f с маштабированием до 100% контейнера. Если размер изображения по ширине меньше контейнера, то выводит изображение по центру.

okrugl(z) - возвращает округлённое и форматированное число. Предназначено для компактного вывода чисел с длинной дробной частью. Округление производится по следующим правилам (применительно к абсолютному значению):

Округлённое число форматируется с разделением на тройки в целой части и заменой дробной точки на запятую.

@vzp(okrugl(23468290.63553))

@vzp(okrugl(1.335533738))

komment(t) - выводит текст t как html-комментарий.

zapros(i) - обеспечивает доступ ко всем значениям, использованным при вызове скрипта формирования публикации - содержимому суперглобального php-массива $_REQUEST. Если функция вызвана без параметров, то она возвращает все значения php-массива $_REQUEST. Если параметр i задан, то возвращается только значение переменной с запрошенным именем.

@vms(zapros())

Array
(
    [file] => dok/bvf.s
    [~] => vsf
)

При наличии понимания о содержимом этих данных их можно использовать в программах на встроенном языке для формирования публикации.

Для взаимодействия модулей между собой в системе ведётся глобальное хранилище данных. Одни модули могут помещать в него информацию, а другие - её использовать. В этом случае отпадает необходимость в считывании данных из контекста других модулей, поскольку достаточно знать лишь как именуются те или иные переменные глобальных данных. Для взаимодействия с глобальным хранилищем используется функция gd.

gd(i[,d]) - если параметр d задан, то его значение присваивается переменной i глобального хранилища. Если же параметр d не задан, то функция возвращает значение переменной i глобального хранилища.

@gd('gp','Значение глобальной переменной gp')

~x=gd('gp')

@vzp(x)

Система хранит данные в нескольких специфически организованных структурах. Для доступа к этим данным из публикаций используются отдельные библиотеки встроенных функций. Подробнее об организации данных и доступе к ним см. статьи:

kod(ud[,d]) - выводит код файла или его секции по указателю ud (см. Указатели данных ) в том виде, как он создан. Если параметр d не задан или равен нулю, то вставки по команды вставки (^) (см. Заполнение секций данными из других источников ) не выполняются. При ненулевом значении d сначала выполняются все команды вставки, а потом выводится код. Если пользователь, просматривающий публикацию, использующую функцию kod(), не имеет права на просмотр кода данных по заданному указателю, то выводится сообщение об отсутствии прав на просмотр кода и данные не выводятся.

rvs(ms) - рекурсивная вставка строк в массив строк ms в соответствии с заданными в строках командами вставки (см. Заполнение секций данными из других источников. )

vss(p) - выводит случайные ссылки на публикации из заданного перечня. Параметр p должен быть массивом или строкой с данными в формате ключ:значение. Ключ d должен определять источник данных, в котором каждая строка содержит имя файла публикации. Ключ k должен определять количество случайно выбираемых ссылок на публикации. Если k=0, то выбираются все ссылки из указанного источника. При каждой загрузке страницы перечень выводимых ссылок будет случайно изменяться.

@vss('d:shurem/vp.txt k:10')

vst(f) - выводит текст "как есть" из случайно выбранной секции файла f. Файл не обязательно должен быть статьёй или книгой. Любой переданный файл может рассматривается как разбитый на секции по правилам системы. Функция может использоваться для вывода HTML/CSS/JS баннеров в теле публикации.

nsd(d) - нумерологическая свёртка даты. Последовательно сворачивает суммы цифр даты до одной цифры. Смысл алгоритма и пример использования см. в статье Число 7 в моей жизни (см. код статьи).

fotostat(p) - выводит статистику по числу специально именованных файлов в заданном каталоге. Используется автором для подсчёта числа отсканированных фотоснимков и цифровых фотографий за выбранные периоды. Файлы именуются в формате ГГГГ-ММ-ДД_ЧЧ-ММ-СС (год-месяц-день_час-минута-секунда). Такое представление весьма удобно для формирования различного рода альбомов с хронологическим упорядочением изображений.

Параметр p является массивом или строкой, содержащей данные в формате ключ:значение. Могут использоваться следующие данные:

10 символов - дата YYYY-MM-DD

07 символов - месяц YYYY-MM

04 символа - год YYYY

@fotostat("d:db/photo/vs k:4")