db2_conn_error

db2_conn_error([resource $connection]): string
```php

`db2_conn_error` devuelve el valor de SQLSTATE que representa la razón por la cual el último intento de conexión a la base de datos ha fallado. Cuando `db2_connect` devuelve `false` en caso de un intento de conexión fallido, no se debe pasar ningún argumento a `db2_conn_error` para obtener el valor de SQLSTATE.

Si por el contrario la conexión fue exitosa pero se ha vuelto inválida con el tiempo, se puede pasar el argumento de conexión `connection` para obtener el valor de SQLSTATE para la conexión específica.

Para entender los valores de SQLSTATE, se puede ingresar el siguiente comando en el procesador de línea de comandos de DB2: `db2 '? sqlstate-value'`. También se puede llamar a la función `db2_conn_errormsg` para obtener un mensaje de error explícito junto con el valor de SQLCODE asociado.

## Parámetros

`connection`  
Un recurso de conexión asociado a la conexión que previamente fue exitosa, pero que se ha vuelto inválida con el tiempo.

## Valores devueltos

Devuelve el valor de SQLSTATE resultante de un intento de conexión fallido. Devuelve un string vacío si no hay error asociado con el último intento de conexión.

## Ejemplos

Obtención del valor de SQLSTATE para un intento de conexión fallido

El siguiente ejemplo muestra cómo devolver un valor de SQLSTATE después de pasar un argumento inválido a la función `db2_connect`.

Valor de SQLSTATE: 08001