PG_SET_CLIENT_ENCODING(3) PG_SET_CLIENT_ENCODING(3)
pg_set_client_encoding - Set the client encoding
SYNOPSIS
int pg_set_client_encoding ([resource $connection], string $encoding)
DESCRIPTION
pg_set_client_encoding(3) 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.
Note
The function used to be called pg_setclientencoding(3).
PARAMETERS
o $connection
- PostgreSQL database connection resource. When $connection is not present, the default connection is used. The default connection
is the last connection made by pg_connect(3) or pg_pconnect(3).
o $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 Post-
greSQL manual for a more specific list.
RETURN VALUES
Returns 0 on success or -1 on error.
EXAMPLES
Example #1
pg_set_client_encoding(3) example
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "An error occurred.
";
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.
";
exit;
}
// Write out UTF-8 data
while ($row = pg_fetch_row($result)) {
echo "Author: $row[0] E-mail: $row[1]";
echo "<br />
";
}
?>
SEE ALSO
pg_client_encoding(3).
PHP Documentation Group PG_SET_CLIENT_ENCODING(3)
