Общие сведения

  1. Все символьные параметры функций чувствительны к регистру символов.

  2. Если длина символьного параметра функции превышает максимально допустимую длину в СУБД ЛИНТЕР, то значение параметра усекается до допустимой длины и функция выполняется с усечённым значением параметра.

  3. Функции возвращают результат типа int, string, object или array. В случае ошибки всегда возвращается int.

    Возможные коды завершения:

    Возвращаемое значение Описание
    0 (LPE_SUCCESS) Нормальное завершение, возвращаемое значение отсутствует
    Положительное Возвращаемое функцией значение (нормальное завершение)
    Отрицательное Неудачное завершение функции
  4. Причиной неудачного завершения функции может являться как ошибка 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;
}
? >
  1. Примеры demo(x).php из подкаталога samples/php установочного каталога СУБД ЛИНТЕР предназначены для запуска из командной строки. Для просмотра их в браузере используйте примеры с постфиксом html, например, demo3html.php.