Lite
Lite - это язык сценариев, используемый W3-mSQL. Его синтаксис очень похож на С и еще больше на Perl. Фактически, многие скрипты Lite синтаксически неотличимы от сценариев Perl. Однако Lite лишен многих расширенных возможностей Perl.
Ниже приводится краткий справочник стандартных функций Lite, доступных при использовании W3-mSQL.
chdir
$result = chdir($path)
Изменяет каталог на указанный путь. Если операцию произвести не удалось, возвращается отрицательное целое число.
chmod
$result = chmod($filename, $mode)
Изменяет режим указанного файла на значение, заданное в mode. Если операцию произвести не удалось, возвращается отрицательное целое число. Значение mode может быть задано как десятичное, восьмеричное или шестнадцатеричное.
chop
$string = chop($string)
Возвращает строку, у которой удален последний символ. Это весьма удобно для удаления символа конца строки из строк, прочитанных функцией read In.
close
close ($fd)
Закрывает файл, связанный с указанным файловым дескриптором.
ctime
$time = ctime($time)
Преобразует время time, заданное некоторым числом секунд с начала отсчета, в обычное текстовое представление времени Unix.
echo
echo($string)
Печатает заданную строку. Все переменные в строке заменяются на их значения.
fprintf
fprintf($fd, $string [, arg ...])
Работает как функция С (или Perl) с тем же именем. Первый аргумент - это файловый дескриптор. Отформатированная строка печатается в файл, связанный с файловым дескриптором.
gethostbyaddr
$hostinfo = gethostbyaddr($address)
Возвращает тот же массив, что и gethostbyname() для указанного IP-адреса. IP-адрес должен быть задан десятичной строкой типа «127.0.0.1». В официальной документации к W3-mSQL эта функция называется и gethostbyaddr , и gethostbyaddress . На момент написания этих строк gethostbyadd ress не было среди функций W3-mSQL.
gethostbyname
$hostinfo = gethostbyname($host)
Возвращает массив информации об указанном хосте. Первый элемент массива - это имя хоста, второй элемент - это его IP-адрес.
getpid
$pid = getpid()
Возвращает идентификатор процесса (PID) программы Lite.
getpwnam
$entry = getpwnam($username)
Возвращает массив информации о пользователе с пользовательским именем username . В массиве имеются следующие поля:
getpwuid
$entry = getpwuid($UID)
Возвращает массив, идентичный массиву, возвращаемому getpwnam для пользователя с пользовательским ID $UID.
includeFile
includeFile($filename)
Эта функция подключает файл filename к результату программы. Файл никак не изменяется и не анализируется.
kill
$result = kill($pid, $signal)
Посылает сигнал signal процессу pid. Если операцию выполнить не удалось, возвращается отрицательное целое число.
link
$result = link($file, $newlinkname)
Создает «жесткую» ссылку от file к newlinkname . Если операцию совершить не удалось, возвращается отрицательное целое число.
mkdir
$result = mkdir($directoryname)
Создает каталог с указанным именем. Если операцию выполнить не удалось, возвращается отрицательное целое число.
msqIConnect
$socket = msqlConnect($host)
Подключается к серверу mSQL на хосте host. Возвращает номер соке-та, используемый для последующей связи с сервером баз данных. При неудаче возвращается отрицательное целое число.
msqICIose
msqlClose($socket)
Закрывает подключение, указанное сокетом socket.
msqIDataSeek
msqlDataSeek($result, $location)
Помещает 'указатель' для result среазу перед записью. Указав location 0, вы поместите указатель в начало данных. Следующий вызов msqlFetchRow выберет строку сразу после location.
msqlEncode
$string = msqlEncode($string)
Функция возвращает перекодированную копию строки string, которую можно использовать в запросе mSQL.
msqlFetchRow
$row = msqlFetchRow($result)
Эта функция возвращает в виде массива следующую доступную запись из result.
msqIFieldSeek
msqlFieldSeek($result, Slocation)
Функция изменяет 'указатель' на результат, возвращаемый msqllnitFieldList, так же как msqIDataSeek изменяет результат msqlStoreResult . ..
msqIFreeResult
msqlFreeResult($result)
Функция освобождает всю память, использованную результатом, выбранным из базы с помощью msqlStoreRcsult . Эту функцию необходимо вызывать для каждого результата, с которым вы закончили работать.
msqllnitFieldList
$result = msqlInitFieldList($socket, $database, $table)
Создает информационную таблицу о таблице table в базе данных database на сервере, указанном аргументом socket.
msqIListDBs
$databases = msqlListDBs($socket)
Возвращает массив имен всех доступных баз данных на сервере, указанном аргументом socket.
msqIListField
$tableinfo = msqlListField($result)
Возвращает массив информации о следующем поле таблицы, созданной msqllnitFieldList , указываемой аргументом result. Каждый последующий вызов функции msqIListField выдает новый массив информации, пока не закончатся поля таблицы. Массив состоит из следующих полей:
msqIListTables
$tables = msqlListTables($socket, $database)
Возвращает массив имен доступных таблиц базы данных database на сервере, указанном аргументом socket.
msqINumRows
msqlNumRows($result)
Возвращает количество записей в данных, содержащихся в result.
msqIQuery
$result = msqlQuery($socket, $query)
Пытается послать запрос query к подключению, указанному аргументом socket. Если запрос не был успешно выполнен, возвращается отрицательное целое число.
msqISelectDB
$result = msqlSelectDB($socket, $database)
Функция пытается подключить socket к базе данных, указанной аргументом database . Если попытка не удалась, возвращается отрицательное целое число.
msqIStoreResult
$result = msqIStoreResult
Выбирает все данные, полученные в результате последнего вызова msqlQuery , и сохраняет их для чтения и обработки.
open
$fd = open($file, $mode)
Эта функция открывает указанный файл, используя заданный режим, и связывает с файлом файловый дескриптор. Режимы могут быть следующими:
> Открыть файл для записи
<Открыть файл для чтения
<> Открыть файл для чтения или записи
<Р Создать именованный канал и открыть его для чтения
>Р Создать именованный канал и открыть его для записи
<| Выполнить файл как команду и прочесть результаты
>| Выполнить файл как команду и сделать запись в процесс
pid
$pid = getppid()
Возвращает идентификатор (PID) родительского для программы Lite процесса.
printf
printf($string [, arg, ... ])
Работает как функция С (или Perl) с тем же именем. Значение переменных не подставляется; для ввода переменных в строку необходимо использовать стандартное для С форматирование '%s'.
read
$data = read($fd, $length)
Читает указанное в length число байт из заданного файлового дескриптора.
readln
$line =readln($fd)
Читает следующую строку из указанного файлового дескриптора.
readtok
$data = readtok($fd, $token)
Функция читает данные из указанного файлового дескриптора, пока не встретит маркер token. Используется только первый символ из token.
rename
$result = rename($oldname, $newname)
Функция пытается переименовать указанный файл (или каталог) из oldname в newname . Если операцию совершить не удалось, возвращается отрицательное целое число.
rmdir
$result = rmdir($path)
Функция пытается удалить указанный каталог. Если операцию совершить не удалось, возвращается отрицательное целое число.
setContentType
setContentType($string)
Заменяет заданный по умолчанию тип содержимого HTML-страницы, содержащей скрипт, на значение, указанное в string. Эта функция должна быть самой первой строкой документа. Перед ней не должно быть даже пустой строки.
sleep
sleep($time)
Останавливает работу программы на указанное количество секунд.
split
$strings = split($string, $token)
Разделяет заданную строку на массив строк, используя как разделитель символ token..
stat
$stat = stat($file)
Возвращает массив информации о файле file. В массиве содержатся следующие элементы:
strftime
$time = strftime($format, $time)
Преобразует время Unix в текстовое представление времени, используя заданный формат format. Все описанные ниже последовательности в строке format заменяются на соответствующие им значения:
%а
День недели в виде местных сокращений названий дней недели.
%А
День недели в виде местных полных названий дней недели.
%b
Месяц в виде местных сокращенных названий.
%В
Месяц в виде местных полных названий месяцев.
%d
День месяца (01-31).
%D
День в виде % m/% d/% у.
%е
День месяца (1-31, перед числами первого десятка добавляется пробел).
%Н
Час (00-23).
%I
Час (00-12).
%j
День в году (001-366).
%h
Часы (0-23, отделенные пробелами).
%l
Часы (1-12, отделенные пробелами).
%m
Номер месяца (01—12).
%M
Минуты (00-59).
%р
AM или РМ.
%S
Секунды (00-59).
%Т
Время в виде % Н:% М:% S.
%U
Номер недели в году (01-52).
%w
День недели (0-6, воскресенье является 0).
%y
Год века (00-99).
%Y
Год, включая век (например 1999).
strseg
$string = strseg($string, $start, $end)
Возвращает подстроку из указанной строки, которая начинается с позиции start и закачивается на позиции end от начала строки.
sub
$string = sub($string, $ехр1, $ехрr2)
Заменяет любые вхождения exprl в string на значение ехрг2. Значения exprl и ехрг2 могут быть разными по длине, строка string автоматически будет укорочена либо удлинена.
substr
$string = substr($string1, $regexp, $string2)
Находит подстроку в строке string"!, которая отвечает регулярному выражению regexp. Каждой части регулярного выражения, заключенной в скобки, присваивается переменная $1, $2, $3 и т. д., содержащая результат совпадения, если оно было найдено. Возвращается значение string2 , с расширенными переменными (включая $1, $2, $3 и т. д.).
tr
$string = tr($string, $list1, $list2)
Функция замещает все символы из списка listl, которые находит в строке string, их эквивалентом в списке list2 (например, tr("Robby", "oy", "ai") вернет строку «Rabbi»). Список символов может содержать диапазон символов, разделенный "-". В частности, tr("e.e. cummings", "a-z," "A-Z") вернет строку «E.E. CUMMINGS.»
truncate
$result = truncate($fale, $length)
Функция пытается сократить размер файла до указанной в байтах длины length . Обычно используется для создания файла с нулевой длиной. Если попытка не удалась, вернется отрицательное целое число.
umask
umask($mask)
Устанавливает umask текущего процесса в заданное значение mask, которое может быть десятичным, восьмеричным или шестнадцатерич-ным.
unixtime2*
$year = unixtime2year($time)
$month = unixtime2month($time)
$day = unixtime2day($time)
$hour = unixtirne2hour($time)
$min = unixtime2min($time)
$sec = unixtime2sec($time)
Данные функции берут в качестве аргумента значение времени в формате Unix и возвращают запрашиваемое значение. Например, функция unixtime2day(time()) может вернуть текущий день месяца (значение от 1 до 31).
unlink
$result = unlink(«filename»)
Удаляет указанный файл. Если удалить файл не удалось, возвращается отрицательное целое число.
urIEncode
$string = urlEncode($string)
Эта функция возвращает копию строки string , которая перекодирована для безопасной вставки в URL.
