StatementInterface

定义查询语句的接口。

此接口是 PDOStatement 的部分独立实现。

2.0.0

Joomla 框架

方法

bindParam

将参数绑定到指定的变量名。

bindParam(string|int parameter,  &variable,  dataType = ParameterType::STRING, int length = null, array driverOptions = null) : 

2.0.0

参数

参数

string|int参数标识符。对于使用命名占位符的预处理语句,这将是形式为 :name 的参数名。对于使用问号占位符的预处理语句,这将是参数的 1 索引位置。

变量

mixed要绑定到 SQL 语句参数的 PHP 变量的名称。

数据类型

string对应于 SQL 数据类型的常量,这应该是来自 QueryInterface 的处理后的类型。

长度

int|null变量的长度。通常需要用于 OUTPUT 参数。

驱动程序选项

array<string|int, mixed>|null要使用的可选驱动程序选项。

响应

bool

closeCursor

关闭游标,使语句能够再次执行。

closeCursor() : 

2.0.0

响应

void

errorCode

获取与语句句柄上的最后操作相关的 SQLSTATE。

errorCode() : 

2.0.0

响应

string

errorInfo

获取与语句句柄上的最后操作相关的扩展错误信息。

errorInfo() : mixed||string|int

2.0.0

响应

array<string|int, mixed>

execute

执行预处理语句

execute(array|null parameters = null) : 

2.0.0

参数

参数

array<string|int, mixed>|null一个值数组,其中元素的数量与要执行的 SQL 语句中绑定的参数数量相同。

响应

bool

fetch

从结果集中获取下一行

fetch(int|null fetchStyle = null,  cursorOrientation = FetchOrientation::NEXT,  cursorOffset) : 

2.0.0

参数

获取样式

int|null控制如何将下一行返回给调用者。此值必须是 FetchMode 常量之一,默认为 FetchMode::MIXED 的值。

游标方向

int对于代表可滚动游标的 StatementInterface 对象,此值确定将哪一行返回给调用者。此值必须是 FetchOrientation 常量之一,默认为 FetchOrientation::NEXT。

游标偏移量

int对于代表可滚动游标的 StatementInterface 对象,其中 cursorOrientation 参数设置为 FetchOrientation::ABS,此值指定结果集中要获取的行号的绝对值。对于代表可滚动游标的 StatementInterface 对象,其中 cursorOrientation 参数设置为 FetchOrientation::REL,此值指定相对于调用 fetch() 之前游标位置的行进行获取。

响应

mixed此函数成功时的返回值取决于获取类型。在所有情况下,如果失败,则返回布尔值 false。

rowCount

返回受最后一条 SQL 语句影响的行数。

rowCount() : 

2.0.0

响应

int

setFetchMode

设置在迭代此语句时使用的获取模式。

setFetchMode( fetchMode,  args) : 

2.0.0

参数

获取模式

int获取模式,必须是 FetchMode 常量之一。

参数

mixed可选的模式特定参数。

响应

void