Доступные версии документации

Получить характеристики курсора

Назначение
 

Функция Linter_Get_Cursor_Opt позволяет получить характеристики курсора.

Все настройки делаются в ini-файле.

Синтаксические правила
string |int Linter_Get_Cursor_Opt(идентификатор_курсора, характеристика_курсора); 

Возможные значения параметра характеристика_курсора:

Значение Описание
CO_COL_COUNT  Число столбцов в курсорной выборке данных
CO_CONNECT_ID  Реальный номер канала связи с СУБД ЛИНТЕР
CO_CUR_ROW  Текущая запись в курсорной выборке данных
CO_CUR_ROWID  Идентификатор текущей записи в курсорной выборке данных
CO_DECIMAL_AS_DOUBLE  Управление представлением значений типа данных DECIMAL как DOUBLE. По умолчанию (или при установке значения 0) данные возвращаются как строка
CO_DT_FORMAT  Формат дата/время по умолчанию
CO_ERR_POS  Положение ошибки в записи курсорной выборки данных
CO_ERR_ROW  Номер ошибочной записи в курсорной выборке
CO_FETCH_BLOBS_AS_USUAL_DATA  Строковый режим извлечения BLOB-данных
CO_FETCH_BLOBS_AS_STREAM  Потоковый режим извлечения BLOB-данных (с помощью RESOURCE)
CO_FETCH_BOOL_AS_BOOL  Управление представлением булевского типа данных. По умолчанию (или при установке значения 0) данные этого типа возвращаются как строки TRUE или FALSE. Настройка в ini-файле – fetch_bool_as_bool
CO_GENERATE_COL_NAME  Управление представлением неименованных столбцов выборки данных (заставляет для пустых имён столбцов автоматически генерировать имя AUTO_GENERATED_NAME). Предназначено для работы в программной среде, которая требует обязательного задания имён столбцов в выборке данных. По умолчанию (или при установке значения 0) автоматическое именование пустых столбцов не выполняется
CO_LAST_ROWID  Последний изменённый, добавленный или удалённый ROWID в курсорной выборке данных
CO_NAME  Имя курсора
CO_NODE_NAME  Имя узла ЛИНТЕР-сервера
CO_NULL_AS_NULL_OBJECT  Управление обработкой NULL-значений (при получении данных и привязке параметра). По умолчанию (или при установке значения 0) данные обрабатываются как пустые строки/нулевые значения/FALSE. Настройка в ini-файле – null_as_null_object
CO_PARAM_COUNT  Количество параметров транслируемого запроса
CO_QUERY_TYPE  

Тип курсорного запроса:

1 – SELECT-запрос;

52 – EXECUTE-запрос;

47 – GRANT;

42 – ALTER;

0 – остальные запросы

CO_RENAME_DUBBED_COL  Управление дубликатами имен столбцов в выборке данных. В случае дублирующихся имён столбцов к имени столбца добавляется постфикс _N, где N – номер дубля. (Первый столбец остаётся со своим именем). По умолчанию (или при установке значения 0 (FALSE)) дубликаты имен столбцов остаются неизменными. Однако в комбинации PDO::FETCH_LAZY + PDO::ATTR_RENAME_DUBBED_COL = FALSE переименование столбцов с одинаковыми именами будет выполняться. В случае совместного использования с параметром CO_GENERATE_COL_NAME именами дубликатов пустых столбцов будет AUTO_GENERATED_NAME_1, AUTO_GENERATED_NAME_2 и т.д.
CO_ROW_COUNT  Число записей в выборке данных
CO_UPDATABLE  

Тип курсора:

1 – обновляемый;

0 – необновляемый

Возвращаемое значение
Характеристика курсора Тип возвращаемого значения
CO_NAME  string
CO_DT_FORMAT  string
CO_COL_COUNT  integer
CO_ROW_COUNT  integer
CO_ERR_ROW  integer
CO_ERR_POS  integer
CO_CUR_ROW  integer
CO_CUR_ROWID  integer
CO_CONNECT_ID  integer
CO_NODE_NAME  string
CO_LAST_ROWID  integer
CO_UPDATABLE  integer
CO_PARAM_COUNT  integer
CO_FETCH_BLOBS_AS_USUAL_DATA  integer
CO_QUERY_TYPE  integer
Пример
$upd = Linter_Get_Cursor_Opt($con,CO_UPDATABLE);
$typ = Linter_Get_Cursor_Opt($con,CO_QUERY_TYPE);
printf("upd %d type %d \n", $upd, $typ);

См. также пример demo4.php в подкаталоге samples\php установочного каталога СУБД ЛИНТЕР.

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter