English | 简体中文 | 繁體中文
查询

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 语句。
补充纠错
上一个函数: sqlsrv_num_rows()函数
下一个函数: sqlsrv_next_result()函数
热门PHP函数
分享链接