fbird_field_info()函数—用法及示例

函数名称：fbird_field_info()

适用版本：Firebird 2.0.0 或更高版本（PHP 5 >= 5.3.0, PHP 7, PHP 8）

用法：fbird_field_info() 函数用于获取 Firebird 数据库查询结果集中字段的详细信息。

语法：array fbird_field_info ( resource $result [, int $field_number = -1 ] )

参数：

• result: Firebird 查询结果的资源标识符。
• field_number（可选）: 字段的索引或名称。默认值为 -1，表示返回所有字段的信息。

返回值：返回一个关联数组，包含字段信息的各个属性。

字段信息数组的键包括：

• name: 字段名称。
• alias: 字段的别名（如果有）。
• relation: 字段所属的表名。
• length: 字段的长度。
• type: 字段的数据类型。
• scale: 字段的小数位数。
• precision: 字段的精度。
• nullable: 字段是否可以为空（true 或 false）。
• charset: 字段的字符集。
• collation: 字段的排序规则。

示例：

<?php
// 假设已经连接到 Firebird 数据库并执行了查询
$query = "SELECT * FROM my_table";
$result = fbird_query($connection, $query);

// 获取第一个字段的信息
$fieldInfo = fbird_field_info($result, 0);

// 打印字段信息
echo "字段名称：" . $fieldInfo['name'] . "\n";
echo "字段别名：" . $fieldInfo['alias'] . "\n";
echo "字段所属表：" . $fieldInfo['relation'] . "\n";
echo "字段长度：" . $fieldInfo['length'] . "\n";
echo "字段数据类型：" . $fieldInfo['type'] . "\n";
echo "字段小数位数：" . $fieldInfo['scale'] . "\n";
echo "字段精度：" . $fieldInfo['precision'] . "\n";
echo "字段是否可为空：" . ($fieldInfo['nullable'] ? '是' : '否') . "\n";
echo "字段字符集：" . $fieldInfo['charset'] . "\n";
echo "字段排序规则：" . $fieldInfo['collation'] . "\n";
?>

注意事项：

• 在使用 fbird_field_info() 函数之前，必须先连接到 Firebird 数据库并执行查询。
• 如果指定了 field_number 参数，则只返回指定字段的信息；否则，返回所有字段的信息。