pg_set_client_encoding

(PHP 4 >= 4.0.3, PHP 5)

pg_set_client_encoding — クライアントのエンコーディングを設定する

説明

int pg_set_client_encoding ([ resource $connection ], string $encoding )

pg_set_client_encoding() はクライアントのエンコーディングを設定し、成功した場合に 0、エラー時に -1 を返します。

PostgreSQL は、バックエンドのデータベースエンコーディングを自動的にフロントエンドのエンコーディングに変換します。

注意: この関数は、以前は pg_setclientencoding() と呼ばれていました。

パラメータ

connection

PostgreSQL データベース接続リソース。connection が指定されていない場合はデフォルトの接続が使用されます。デフォルトの接続は、直近の pg_connect() あるいは pg_pconnect() によって作成されたものです。

encoding

クライアントエンコーディング。以下のうちのひとつです。SQL_ASCII、EUC_JP、 EUC_CN、EUC_KR、EUC_TW、 UNICODE、MULE_INTERNAL、LATINX (X=1...9)、 KOI8、WIN、ALT、SJIS、 BIG5 あるいは WIN1250 。

利用可能なエンコーディングの完全なリストは、使用している PostgreSQL のバージョンに依存します。詳細な情報については PostgreSQL のマニュアルを参照ください。

返り値

成功した場合に 0 、エラー時に -1 を返します。

例

例1 pg_set_client_encoding() の例


<?php

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

// クライアントのエンコーディングを UNICODE にする。
// データは、バックエンドのエンコーディングから自動的に変換される。
pg_set_client_encoding($conn, "UNICODE");

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

// UTF-8 データを書き出す。
while ($row = pg_fetch_row($result)) {
  echo "Author: $row[0]  E-mail: $row[1]";
  echo "<br />\n";
}
 
?>

参考

pg_client_encoding() - クライアントのエンコーディングを取得する