ocinewcollection()函式—用法及示例

函式名稱：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' 應替換為實際存在的物件型別定義名稱。