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

函数名称：sqlsrv_num_fields()

适用版本：PHP 5.2.0 及以上版本

函数描述：sqlsrv_num_fields() 函数用于返回查询结果集中的字段数。

语法：int sqlsrv_num_fields ( resource $stmt )

参数：

• $stmt：必需。一个有效的 SQL Server 语句句柄，通过 sqlsrv_query() 函数返回。

返回值：返回查询结果集中的字段数，如果查询失败或结果集为空则返回 false。

示例：

<?php
// 连接到 SQL Server 数据库
$serverName = "serverName\sqlexpress";
$connectionOptions = array(
    "Database" => "dbName",
    "Uid" => "username",
    "PWD" => "password"
);
$conn = sqlsrv_connect($serverName, $connectionOptions);

// 执行查询语句
$query = "SELECT * FROM tableName";
$stmt = sqlsrv_query($conn, $query);

// 获取查询结果集的字段数
if ($stmt !== false) {
    $numFields = sqlsrv_num_fields($stmt);
    if ($numFields !== false) {
        echo "查询结果集中的字段数为：" . $numFields;
    } else {
        echo "获取字段数失败";
    }
} else {
    echo "查询失败";
}

// 关闭连接
sqlsrv_close($conn);
?>

注意事项：

• 在调用 sqlsrv_num_fields() 函数之前，必须先执行 sqlsrv_query() 函数来执行查询语句，并将返回的句柄作为参数传递给 sqlsrv_num_fields() 函数。
• 如果查询失败或结果集为空，sqlsrv_num_fields() 函数将返回 false。
• sqlsrv_num_fields() 函数只能用于查询语句，不能用于 INSERT、UPDATE 或 DELETE 语句。