pg_field_prtlen
PHP Manual
PHP Manual»Функции PostgreSQL»pg_field_prtlen

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

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

To Top