pg_set_client_encoding

pg_set_client_encoding([PgSql\Connection $connection], string $encoding): int
```php

`pg_set_client_encoding` establece la codificación del cliente. Devuelve 0 en caso de éxito y -1 en caso de error.

PostgreSQL convertirá automáticamente los datos de la codificación de la base de datos a la codificación del cliente.

> [!NOTE]
> Anteriormente, esta función se llamaba `pg_setclientencoding`.

## Parámetros

`connection`  
Una `PgSql\Connection` instancia. Cuando `connection` no es especificado, se usa la conexión por defecto. La conexión predeterminada es la última conexión hecha por `pg_connect` o `pg_pconnect`

> [!WARNING]
> Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto.

`encoding`  
La codificación del cliente solicitada. Una de estas constantes: `SQL_ASCII`, `EUC_JP`, `EUC_CN`, `EUC_KR`, `EUC_TW`, `UNICODE`, `MULE_INTERNAL`, `LATINX` (X=1...9), `KOI8`, `WIN`, `ALT`, `SJIS`, `BIG5` o `WIN1250`.

La lista exacta de codificaciones disponibles depende de la versión de PostgreSQL, por lo que se debe consultar el manual de PostgreSQL para obtener una lista más específica.

## Valores devueltos

Devuelve `0` en caso de éxito o `-1` en caso de error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `connection` ahora espera una instancia de `PgSql\Connection` ; anteriormente, se esperaba un `resource`. |

## Ejemplos

Ejemplo con `pg_set_client_encoding`