Pg field prtlen: примеры (PHP)

$conn = pg_connect("host=localhost dbname=test user=postgres");
$result = pg_query($conn, "SELECT id, name FROM products");
$length = pg_field_prtlen($result, 0, 'name');
echo "Длина значения в первом ряду, поле 'name': ".$length;

Длина значения в первом ряду, поле 'name': 12

$result = pg_query($conn, "SELECT id, name, price FROM products");
$length = pg_field_prtlen($result, 1, 2); // Вторая строка, третье поле (price)
echo "Длина: ".$length;

Длина: 7

$result = pg_query($conn, "SELECT description FROM products");
pg_fetch_row($result); // Перемещаемся к первой строке
$length = pg_field_prtlen($result, 'description'); // Для текущей строки
echo "Длина: ".$length;

Длина: 24

Функция pg_field_size() возвращает внутренний размер поля в байтах. Она полезна для определения фактического объема данных, но не учитывает форматирование при выводе.

Функция pg_field_name() получает имя поля по его номеру. Используется для получения метаинформации о структуре результата запроса.

Функция pg_field_type() возвращает имя типа данных поля. Помогает в динамическом анализе структуры результатов.

Рекомендации: pg_field_prtlen применяют для задач форматирования вывода. Для работы с размерами данных в хранилище используют pg_field_size. Для получения метаданных результата — pg_field_name и pg_field_type.

import psycopg2
conn = psycopg2.connect("dbname=test user=postgres")
cur = conn.cursor()
cur.execute("SELECT name FROM products")
row = cur.fetchone()
length = len(str(row[0]))
print(f"Длина: {length}")

Длина: 12

const { Client } = require('pg');
const client = new Client();
(async () => {
  await client.connect();
  const res = await client.query('SELECT name FROM products');
  const length = String(res.rows[0].name).length;
  console.log(`Длина: ${length}`);
})();

Длина: 12

Pg field prtlen в MySQL

В MySQL нет прямой аналогии. Для определения длины строкового представления используют функцию CHAR_LENGTH() в самом запросе.

SELECT name, CHAR_LENGTH(name) AS prtlen FROM products;

| name | prtlen |
|------------|--------|
| Product A  | 9      |

В отличие от аналогов в Python и JavaScript, функция pg_field_prtlen работает с ресурсом результата, не требуя предварительного извлечения данных в переменные. Это позволяет экономить память при работе с большими объемами данных.

$length = pg_field_prtlen(null, 0, 'name');
var_dump($length);

bool(false)

Возникает, когда передан неверный или пустой ресурс. Всегда проверяйте результат выполнения pg_query.

$result = pg_query($conn, "SELECT name FROM products LIMIT 1");
$length = pg_field_prtlen($result, 5, 'name'); // Строки 5 не существует
echo "Длина: ".$length;

Warning: pg_field_prtlen(): Bad row offset

$result = pg_query($conn, "SELECT name FROM products");
$length = pg_field_prtlen($result, 0, 'nonexistent');
var_dump($length);

bool(false)

Убедитесь, что указанное имя или номер поля существуют в результате запроса.

Функция pg_field_prtlen была добавлена в PHP 4.2.0. Существенных изменений в поведении функции в последних версиях PHP не было. Однако начиная с PHP 7.0, при неверных параметрах функция возвращает false и генерирует предупреждение, тогда как в более ранних версиях поведение могло отличаться.

В PHP 8 сохраняется обратная совместимость. Типизация аргументов стала строже, но сигнатура функции не изменилась.

$result = pg_query($conn, "SELECT id, name, price FROM products LIMIT 5");
$fieldCount = pg_num_fields($result);

// Определяем ширину столбцов
$widths = [];
for ($i = 0; $i < $fieldCount; $i++) {
    $maxLen = strlen(pg_field_name($result, $i));
    for ($j = 0; $j < pg_num_rows($result); $j++) {
        $len = pg_field_prtlen($result, $j, $i);
        if ($len > $maxLen) $maxLen = $len;
    }
    $widths[$i] = $maxLen + 2;
}

// Вывод заголовков
for ($i = 0; $i < $fieldCount; $i++) {
    printf("%-{$widths[$i]}s", pg_field_name($result, $i));
}
echo "\n";

// Вывод данных
while ($row = pg_fetch_row($result)) {
    for ($i = 0; $i < $fieldCount; $i++) {
        printf("%-{$widths[$i]}s", $row[$i]);
    }
    echo "\n";
}

id  name       price 
1   Product A  100.00
2   Product B  200.50
3   Product C  150.75

$result = pg_query($conn, "SELECT NULL as null_value, '' as empty_string");
$len1 = pg_field_prtlen($result, 0, 'null_value');
$len2 = pg_field_prtlen($result, 0, 'empty_string');
echo "NULL длина: ".$len1."\n";
echo "Пустая строка длина: ".$len2;

NULL длина: 0
Пустая строка длина: 0

$result = pg_query($conn, "SELECT current_date as date, 123.456::numeric as num");
$dateLen = pg_field_prtlen($result, 0, 'date');
$numLen = pg_field_prtlen($result, 0, 'num');
echo "Дата: ".$dateLen." символов\n";
echo "Число: ".$numLen." символов";

Дата: 10 символов
Число: 7 символов

$result = pg_query($conn, "SELECT 'Много\nстрочный\nтекст' as multiline");
$len = pg_field_prtlen($result, 0, 'multiline');
echo "Длина с учетом символов новой строки: ".$len;

Длина с учетом символов новой строки: 18