ocinewcollection()

创建一个新的集合对象,并返回一个指向该对象的句柄

首字母:O

函数名称:ocinewcollection()

函数描述:ocinewcollection() 函数创建一个新的集合对象,并返回一个指向该对象的句柄。

适用版本:PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8

语法:resource ocinewcollection ( resource $connection , string $tdo [, string $schema = "" ] )

参数:

  • $connection:一个有效的 OCI 连接标识符。
  • $tdo:用于在集合中存储数据的对象类型定义。对象类型定义必须在数据库中存在。
  • $schema:可选参数,指定对象类型定义所在的模式。

返回值:成功时返回一个有效的集合句柄,失败时返回 FALSE。

示例:

// 创建一个新的集合对象
$conn = oci_connect('username', 'password', 'localhost/XE');
$collection = ocinewcollection($conn, 'MY_OBJECT_TYPE');
if ($collection !== false) {
 echo "集合对象创建成功!";
 // 在集合中添加数据
 $data = ['John', 'Doe'];
 foreach ($data as $value) {
 ocicollappend($conn, $collection, $value);
 }
 // 通过集合句柄访问集合中的数据
 $numElements = ocicollsize($conn, $collection);
 for ($i = 1; $i <= $numElements; $i++) {
 $element = ocicollgetelem($conn, $collection, $i);
 echo "元素 $i: $element\n";
 }
 // 删除集合对象
 ocifreecollection($conn, $collection);
} else {
 echo "集合对象创建失败!";
}
// 关闭数据库连接
oci_close($conn);

以上示例演示了如何使用 ocinewcollection() 函数创建一个新的集合对象,并向集合中添加数据。然后通过集合句柄访问集合中的数据,并最后释放集合对象。请注意,示例中的 'MY_OBJECT_TYPE' 应替换为实际存在的对象类型定义名称。

同首字母函数