---
name: "mysql_field_count"
section: "3"
platform: "linux"
package: "mariadb"
version: "13.0.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mysql_field_count"
---

# mysql\_field\_count(3)

### Name

mysql\_field\_count - returns the number of columns for the most recent statement

### Synopsis

-

  ```
  #include <mysql.h>
  unsigned int mysql_field_count(MYSQL * mysql);
  ```

### Description

Returns the number of columns for the most recent statement on the connection represented by the link parameter as an unsigned integer. This function can be useful when using the **[mysql\_store\_result(3)](/mysql_store_result/3.md)** function to determine if the query should have produced a non-empty result set or not without knowing the nature of the query.

### Parameters

- •

  `mysql` is a connection identifier, which was previously allocated by **[mysql\_init(3)](/mysql_init/3.md)** and connected by **[mysql\_real\_connect(3)](/mysql_real_connect/3.md)**.

### Notes

The `mysql_field_count()` function should be used to determine if there is a result set available.

### Return value:

The number of columns for the most recent statement. The value is zero, if the statement didn’t produce a result set.

### See also

- •

  **[mysql\_store\_result(3)](/mysql_store_result/3.md)**

- •

  **[mysql\_use\_result(3)](/mysql_use_result/3.md)**