pg_set_client_encoding

Set the client encoding

&reftitle.description; `int` `pg_set_client_encoding` `PgSql\Connection` `connection` `string` `encoding`

`pg_set_client_encoding` sets the client encoding and returns 0 if success or -1 if error.

PostgreSQL will automatically convert data in the backend database encoding into the frontend encoding.

The function used to be called `pg_setclientencoding`.

&reftitle.parameters;

`connection`

- &pgsql.parameter.connection-with-unspecified-default;

`encoding`

- The required client encoding. One of `SQL_ASCII`, `EUC_JP`, `EUC_CN`, `EUC_KR`, `EUC_TW`, `UNICODE`, `MULE_INTERNAL`, `LATINX` (X=1...9), `KOI8`, `WIN`, `ALT`, `SJIS`, `BIG5` or `WIN1250`.

  The exact list of available encodings depends on your PostgreSQL version, so check your PostgreSQL manual for a more specific list.

&reftitle.returnvalues;

Returns `0` on success or `-1` on error.

&reftitle.changelog;

&Version; | &Description;
&pgsql.changelog.connection-object;

&reftitle.examples;

### `pg_set_client_encoding` example

    <?php

    $conn = pg_pconnect("dbname=publisher");
    if (!$conn) {
      echo "An error occurred.\n";
      exit;
    }

    // Set the client encoding to UNICODE.  Data will be automatically
    // converted from the backend encoding to the frontend.
    pg_set_client_encoding($conn, "UNICODE");

    $result = pg_query($conn, "SELECT author, email FROM authors");
    if (!$result) {
      echo "An error occurred.\n";
      exit;
    }

    // Write out UTF-8 data
    while ($row = pg_fetch_row($result)) {
      echo "Author: $row[0]  E-mail: $row[1]";
      echo "<br />\n";
    }

    ?>

&reftitle.seealso;

- `pg_client_encoding`