@ary ref = $cibh->selectcol arrayref ($stateinent, [\%attr [, @bind values] ]) ; Выполняет определенный параметром $stateinent оператор и возвращает первый столбец результирующего набора, комбинируя в процессе выполнения методы ргерагеО и execute (). Возвращаемый результат представлен в виде ссылки на массив, содержащий первый столбец из каждой строки. Если в процессе выполнения имеет место ощибка, этот метод возвращает значение undef.

Если параметр $statement содержит уже подготовленный оператор, этап метода prepare () пропускается.

Параметр @bind values имеет то же значение, что и для метода do О .

@ary ref = $dbh->selectrow arrayref {$statement, [\%attr [, @bind values] ] ) ; Выполняет определенный параметром $statement оператор и возвращает первую строку результирующего набора, комбинируя в процессе выполнения методы ргерагеО, execute() и fetchrow array{).

Если параметр $ statement определяет уже подготовленный оператор, этап метода prepare () пропускается.

При вызове в контексте списка метод selectrow array () возвращает массив, представляющий значения строки, либо пустой массив, если имела место ощибка. При вызове в скалярном контексте метод selectrow array () возвращает значение первого элемента массива (первого столбца строки), либо значение undef, если имела место ощибка.

Параметр @bind values имеет то же значение, что и для метода do О .

Методы дескрипторов операторов

Описанные в этом разделе методы вызываются с помощью дескриптора оператора, который, в свою очередь, можно получить посредством вызова метода prepare {).

$гс = $sth->bind col {$col num, \$var to bind); Привязывает определенный столбец запроса SELECT к переменной языка Perl, которая должна передаваться как ссылка. Значение параметра $col num может находиться в диапазоне от 1 до количества столбцов, выбранных запросом. Всякий раз при выборке строки эта переменная автоматически обновляется с помощью нового значения столбца.

Метод bind col () следует вызывать после метода prepare О и до вызова метода execute ().

Если заданный номер столбца выходит за пределы описанного ранее диапазона, метод bindcol () возвращает значение False . $гс = $sth->bind columns (\$var to bindl, \$var to bind2, ...); Привязывает возвращенные оператором select столбцы к списку переменных. Более детально об этом рассказывается в описании метода bind col ().

Если число ссылок не соответствует числу выбранных запросом столбцов, метод bind coluins () возвращает значение False .

$rv = $sth->bind param ($n, $value [, \%attr]); $rv = $sth->bind param ($n, $value [, $bind type]); Привязывает значение к маркеру ( ? ) запроса. Этот метод следует вызывать после метода prepare О и до вызова метода execute ().

Значение параметра $п определяет номер маркера, к которому следует привязать значение $value, и может находиться в диапазоне от 1 до заданного количества маркеров. Чтобы привязать значение null, задайте этому методу значение undef.

Параметр \%attr или $bind type может выполнять роль подсказки относительно типа привязываемого значения. Для определения, например, целочисленного значения метод bindparamO можно вызвать одним из двух следующих способов:

$rv = $sth->bind param ($n, $value , { type => dbi::sql integer }) ;

$rv = $sth->bind param ($n, $value, dbi::sql integer);

По умолчанию переменная рассматривается как имеющая тип varchar. Зачастую это воспринимается нормально, поскольку MySQL в случае необходимости самостоятельно преобразует типы строковых значений запросов.

$rows = $sth->dump results ([$maxlen [, $line sep [, $field sep [, $fh] ] ] ]); Извлекает все строки, используя дескриптор запроса $sth, форматирует их с помощью функции dbi: : neatlist () И выводит, используя заданный дескриптор файла. Этот метод возвращает число выбранных строк.

Для параметров $maxlen, $line sep, $field sep и $fh по умолчанию установлены значения 35, \п , , и stdout соответственно.

$rv = $sth->execute ([@bind values] ) ; Выполняет заранее подготовленный запрос. Возвращает истинное значение, если оператор выполняется успещно либо значение undef, если имела место ощибка.

Параметр @bind values имеет то же значение, что и для метода do О.

$ary ref = $sth->fetch () ; Метод fetch () является псевдоименем метода f etchrow arrayref () .

$tbl ary ref = $sth->fetchall arraYref ([$slice array ref]);

$tbl ary ref = $sth->fetchall arraYref ([$slice hash ref ]) ; Выполняет выборку всех строк, используя дескриптор оператора $sth, и возвращает ссылку на массив, содержащий по одной ссылке на каждую выбранную строку. Значение каждой ссылки массива зависит от заданного аргумента. Если не задан ни один аргумент, или задан аргумент ссылки на массив, каждый элемент значения $tbl ary ref является ссылкой на массив, содержащий значения для одной строки результирующего набора. Если задан аргумент ссылки на хэщ, каждый элемент значения $tbl ary ref является ссылкой на хэщ, содержащий значения для одной строки результирующего набора.

@агу = $sth->fetchrow arraY О; При вызове в контексте списка метод fetchrow array () возвращает массив со значениями столбцов для следующей строки результирующего набора либо пустой массив, если строк больще нет или имела место ощибка. При вызове в скалярном контексте метод f etchrow array () возвращает значение первого элемента массива (т.е. первого столбца строки) либо значение undef, если строк больще нет или имела место ощибка.

Чтобы отличить нормальное заверщение от ошибочного, достаточно проверить значение метода $sth->err (). Нулевое значение отражает нормальное заверщение, а соответственно и отсутствие ошибки.

$ary ref = $sth->fetchrow arraYref () ; Возвращает ссылку на массив со значениями столбца для следующей строки результирующего набора. Если строк больше нет или имела место ошибка, этот метод возврашает значение undef.

Чтобы отличить нормальное завершение от появления ошибки, достаточно проверить значение метода $sth->err (). Нулевое значение отражает нормальное заверщение, а соответственно и отсутствие ошибки.

$hash ref = $sth->fetchrow hashref ([$name]); Возвращает ссылку на хэш со значениями столбцов для следующей строки результирующего набора. Если строк больше нет или имела место ошибка, этот метод возвращает значение undef. В качестве значений индексов хэша выступают имена столбцов, а элементы хэша содержат значения столбцов.

Аргумент $name может задаваться для определения атрибута дескриптора оператора, используемого для ключевых значений хэша.