Общие сведения
-
Все символьные параметры функций чувствительны к регистру символов.
-
Если длина символьного параметра функции превышает максимально допустимую длину в СУБД ЛИНТЕР, то значение параметра усекается до допустимой длины и функция выполняется с усечённым значением параметра.
-
Функции возвращают результат типа
int,string,objectилиarray. В случае ошибки всегда возвращаетсяint.Возможные коды завершения:
Возвращаемое значение Описание 0 (LPE_SUCCESS) Нормальное завершение, возвращаемое значение отсутствует Положительное Возвращаемое функцией значение (нормальное завершение) Отрицательное Неудачное завершение функции -
Причиной неудачного завершения функции может являться как ошибка PHP-модуля, так и результат обработки функции СУБД ЛИНТЕР. Если причиной является код завершения СУБД ЛИНТЕР, то возвращается
LPE_LINTER_ERROR. Все остальные отрицательные коды относятся к ошибкам PHP-модуля. Для получения дополнительной информации об ошибке (в том числе и детализацииLPE_LINTER_ERROR) используйте функциюLinter_Last_Error(см. Linter_Blob_Append).
Пример обработки кода завершения
<?php
#
# Linter SQL Server and Linter PHP module errors handler
# Parameters: $con - connection or cursor id;
# $err - value was returned by any Linter_* routine.
#
function Errors_Handler($con, $err)
{
if ($err >= 0 && $con >= 0)
return;
if ($err == LPE_LINTER_ERROR || $con < 0)
{
$lin_err = Linter_Last_Error($con, LINTER_ERROR);
$sys_err = Linter_Last_Error($con, SYSTEM_ERROR);
$err_msg = Linter_Error_Msg($con);
if ($lin_err <= 2) // no more rows
return;
printf("Linter error %d (%s) ", $lin_err, $err_msg);
if ($lin_err >= 2000 && $lin_err < 3000) // SQL syntax errors
{
$row = $sys_err & 0xFFFF;
$pos = $sys_err >> 16;
printf("at row %d, position %d", $row, $pos);
}
else
printf(" system error %d", $sys_err);
printf("\n");
}
else
printf("Module internal error %d\n", $err);
Linter_Close_Connect($con);
die;
}
?>
-
Примеры
demo(x).phpиз подкаталогаsamples/phpустановочного каталога СУБД ЛИНТЕР предназначены для запуска из командной строки. Для просмотра их в браузере используйте примеры с постфиксомhtml, например,demo3html.php.