PostgreSQL结果集¶

属性	值
命名空间	fize\db\realization\pgsql\mode\driver\pgsql
类名	Result

方法:

方法名	说明
__construct()	构造
__destruct()	析构时释放资源
affectedRows()	返回受影响的记录数目
fetchAllColumns()	以数组的形式获取特定结果列中的所有行
fetchAll()	从结果中提取所有行作为一个数组
fetchArray()	提取一行作为数组
fetchAssoc()	提取一行作为关联数组
fetchObject()	提取一行作为对象
fetchResult()	从结果资源中返回值
fetchRow()	提取一行作为枚举数组
fieldIsNull()	测试字段是否为 NULL
fieldName()	返回字段的名字
fieldNum()	返回字段的编号
fieldPrtlen()	返回打印出来的长度
fieldSize()	返回指定字段占用内部存储空间的大小
fieldTable()	返回tables字段的名称或oid
fieldTypeOid()	返回对应字段号的类型ID (OID)
fieldType()	返回相应字段的类型名称
freeResult()	释放查询结果占用的内存
lastOid()	返回上一个对象的 oid
numFields()	返回字段的数目
numRows()	返回行的数目
resultErrorField()	返回错误报告的单个字段
resultError()	获得查询结果的错误信息
resultSeek()	在结果资源中设定内部行偏移量
resultStatus()	获得查询结果的状态

方法¶

__construct()¶

构造

public function __construct (

    resource &$result

)

参数:

名称	说明
result	结果集

__destruct()¶

析构时释放资源

public function __destruct ()

affectedRows()¶

返回受影响的记录数目

public function affectedRows () : int

fetchAllColumns()¶

以数组的形式获取特定结果列中的所有行

public function fetchAllColumns (

    int $column = 0

) : array

参数:

名称	说明
column	要从结果资源中检索的列号(从零开始)

fetchAll()¶

从结果中提取所有行作为一个数组

public function fetchAll (

    int $result_type = 1

) : array

参数:

名称	说明
result_type	返回类型 PGSQL_ASSOC \| PGSQL_NUM \| PGSQL_BOTH

fetchArray()¶

提取一行作为数组

public function fetchArray (

    int $row = null,

    int $result_type = 3

) : array

参数:

名称	说明
row	要从结果资源中检索的列号(从零开始)
result_type	常量PGSQL_ASSOC，PGSQL_NUM 和 PGSQL_BOTH

fetchAssoc()¶

提取一行作为关联数组

public function fetchAssoc (

    int $row = null

) : array

参数:

名称	说明
row	要从结果资源中检索的列号(从零开始)

fetchObject()¶

提取一行作为对象

public function fetchObject (

    int $row = null

) : object

参数:

名称	说明
row	要从结果资源中检索的列号(从零开始)

fetchResult()¶

从结果资源中返回值

public function fetchResult (

    int $row,

    mixed $field

) : mixed

参数:

名称	说明
row	要从结果资源中检索的列号(从零开始)
field	字段名（字符串）或字段索引（整数）。

fetchRow()¶

提取一行作为枚举数组

public function fetchRow (

    int $row = null

) : array

参数:

名称	说明
row	要从结果资源中检索的列号(从零开始),未指定则为下一行

fieldIsNull()¶

测试字段是否为 NULL

public function fieldIsNull (

    int $row,

    mixed $field

) : int

参数:

名称	说明
row	要从结果资源中检索的列号(从零开始)
field	字段名（字符串）或字段索引（整数）。

返回值:

为null返回1，不为null返回0

fieldName()¶

返回字段的名字

public function fieldName (

    int $field_number

) : string

参数:

名称	说明
field_number	字段编号从 0 开始

fieldNum()¶

返回字段的编号

public function fieldNum (

    string $field_name

) : int

参数:

名称	说明
field_name	字段名

返回值:

未找到或者出错时返回-1

fieldPrtlen()¶

返回打印出来的长度

public function fieldPrtlen (

    int $row_number,

    string $field_name

) : int

参数:

名称	说明
row_number	要从结果资源中检索的列号(从零开始)
field_name	字段名

fieldSize()¶

返回指定字段占用内部存储空间的大小

public function fieldSize (

    int $field_number

) : int

参数:

名称	说明
field_number	字段编号从 0 开始

返回值:

字段大小为 -1 表示可变长度字段。如果出错本函数返回 FALSE

fieldTable()¶

返回tables字段的名称或oid

public function fieldTable (

    int $field_number,

    bool $oid_only = false

) : mixed

参数:

名称	说明
field_number	字段编号从 0 开始
oid_only	默认情况下，返回字段所属的表名，但如果oid_only设置为TRUE，则返回oid。

fieldTypeOid()¶

返回对应字段号的类型ID (OID)

public function fieldTypeOid (

    int $field_number

) : int

参数:

名称	说明
field_number	字段编号从 0 开始

fieldType()¶

返回相应字段的类型名称

public function fieldType (

    int $field_number

) : string

参数:

名称	说明
field_number	字段编号从 0 开始

freeResult()¶

释放查询结果占用的内存

public function freeResult ()

lastOid()¶

返回上一个对象的 oid

public function lastOid () : string|bool

返回值:	没有定义oid时返回false

numFields()¶

返回字段的数目

public function numFields () : int

numRows()¶

返回行的数目

public function numRows () : int

resultErrorField()¶

返回错误报告的单个字段

public function resultErrorField (

    int $fieldcode

) : string

参数:

名称	说明
fieldcode	指定常量配置

resultError()¶

获得查询结果的错误信息

public function resultError () : string

resultSeek()¶

在结果资源中设定内部行偏移量

public function resultSeek (

    int $offset

) : bool

参数:

名称	说明
offset	偏移量

resultStatus()¶

获得查询结果的状态

public function resultStatus () : string