array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.pg-field-prtlen.php', 1 => 'pg_field_prtlen', 2 => 'Возвращает количество выводимых символов', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Функции PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-field-num.php', 1 => 'pg_field_num', ), 'next' => array ( 0 => 'function.pg-field-size.php', 1 => 'pg_field_size', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/pgsql/functions/pg-field-prtlen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_field_prtlen

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_field_prtlen — Возвращает количество выводимых символов

Описание

function pg_field_prtlen(PgSql\Result $result, string|false|null $row, mixed $field_name_or_number): int
function pg_field_prtlen(PgSql\Result $result, mixed $field_name_or_number): int

Функция pg_field_prtlen() возвращает количество символов, которое займет при выводе значение поля из объекта result с результатами запроса к СУБД PostgreSQL. Строки нумеруются с нуля. Функция вернёт false, если возникнет ошибка.

Параметр field_name_or_number поддерживает значения int и string: тип int PHP распознаёт как номер поля, иначе аргумент интерпретируется как название поля.

Пример работы функции содержит страница с описанием функции pg_field_name().

Замечание:

Прежнее название функции: pg_fieldprtlen().

Список параметров

result
Экземпляр класса PgSql\Result, который возвращают функции pg_query(), pg_query_params() или pg_execute() (среди прочего).
row

Номер строки в результате. Нумерация строк начинается с нуля. При пропуске аргумента значение извлекается из текущей строки.

Возвращаемые значения

Функция возвращает количество символов, которое занимает значение поля при выводе.

Список изменений

Версия Описание
8.4.0 Сигнатура функции pg_field_prtlen() с двумя аргументами — result и field — устарела; функцию вызывают с тремя аргументами с передачей в параметр row значения null.
8.3.0 Параметр row теперь принимает значение null.
8.1.0 Параметр result теперь принимает объект PgSql\Result; раньше параметр принимал тип resource.

Примеры

Пример #1 Пример получение информации о полях выборки

<?php

$dbconn = pg_connect("dbname=publisher") or die("Ошибка подключения к БД");
$res = pg_query($dbconn, "SELECT * FROM authors WHERE author = 'Orwell'");

$i = pg_num_fields($res);
for ($j = 0; $j < $i; $j++) {
    echo "Столбец $j\n";
    $fieldname = pg_field_name($res, $j);
    echo "Название поля: $fieldname\n";
    echo "Количество: " . pg_field_prtlen($res, $fieldname) . " символов\n";
    echo "Размер в хранилище в байтах: " . pg_field_size($res, $j) . "\n";
    echo "Тип поля: " . pg_field_type($res, $j) . " \n\n";
}

Результат выполнения приведённого примера: 

Столбец 0
Название поля: author
Количество: 6 символов
Размер в хранилище в байтах: -1
Тип поля: varchar

Столбец 1
Название поля: year
Количество: 4 символов
Размер в хранилище в байтах: 2
Тип поля: int2

Столбец 2
Название поля: title
Количество: 24 символов
Размер в хранилище в байтах: -1
Тип поля: varchar

Смотрите также