[函数]cubrid_query()函数—用法及示例

函数名：cubrid_query()

适用版本：CUBRID 8.3.0+

用法：cubrid_query() 函数用于在 CUBRID 数据库上执行 SQL 查询。

语法：

cubrid_query ( resource $conn_identifier , string $query [, bool $async_mode = false ] ) : resource|false

参数：

• $conn_identifier：连接标识符，使用 cubrid_connect() 或者 cubrid_connect_with_url() 函数返回的 CUBRID 连接资源。
• $query：要执行的 SQL 查询语句。
• $async_mode（可选）：异步模式标志，表示查询是否以异步模式执行，默认为 false。

返回值：

• 如果查询成功，返回一个结果集资源，该资源可用于获取查询结果。
• 如果查询失败，返回 false。

示例：

// 建立与 CUBRID 数据库的连接
$conn = cubrid_connect('localhost', 33000, 'testdb', 'username', 'password');

// 检查连接是否成功
if (!$conn) {
    die('连接失败: ' . cubrid_error_msg());
}

// 执行查询
$result = cubrid_query($conn, 'SELECT * FROM customers');

// 检查查询是否执行成功
if ($result) {
    // 获取查询结果
    while ($row = cubrid_fetch_assoc($result)) {
        echo $row['id'] . ' - ' . $row['name'] . '<br>';
    }

    // 释放结果集资源
    cubrid_free_result($result);

} else {
    die('查询失败: ' . cubrid_error($conn));
}

// 关闭连接
cubrid_disconnect($conn);

注意事项：

• 在使用前，必须先通过 cubrid_connect() 或者 cubrid_connect_with_url() 函数建立与 CUBRID 数据库的连接。
• 必须调用 cubrid_free_result() 函数释放结果集资源，以避免内存泄漏。
• 可以使用 cubrid_num_rows() 函数获取结果集中的行数。
• 可以使用 cubrid_affected_rows() 函数获取最近一次执行的 INSERT、UPDATE 或 DELETE 语句所影响的行数。
• 如果需要执行多条 SQL 查询，建议使用 cubrid_execute() 函数，该函数支持执行多条 SQL 查询的批量操作。