関数リファレンス
   

関数

PQsetdbLogin
データベースの接続
   

書式

PGconn *PQsetdbLogin(const char *pghost,
                const char *pgport,
                const char *pgoptions,
                const char *pgtty,
                const char *dbName,
                const char *login,
                const char *pwd)

const char *pghost PostgreSQLのサーバ名(TCP/IP で接続)
const char *pgport サーバホストのポート番号,または UNIX ドメインの接続の場合はソケットファイルの拡張子
const char *pgoptions バックエンドに送るトレース/デバッグオプション
const char *pgtty バックエンドからのデバッグ出力のためのファイル, または tty名
const char *dbName データベース名
const char *login ユーザ名
const char *pwd パスワード

戻り値

接続情報が格納されている構造体(PGconn *)のアドレスを返す

エラー

PQstatus関数よりエラーかを判定する。

PGRES_EMPTY_QUERY クエリが無い
PGRES_COMMAND_OK 問い合わせは返すデータのないコマンドだった
PGRES_TUPLES_OK 問い合わせがタプルを返すのに成功した
PGRES_COPY_OUT サーバからの)コピーアウトの開始
PGRES_COPY_IN (サーバへの)コピーインの開始
PGRES_BAD_RESPONSE 予期しない応答を受け取った
PGRES_NONFATAL_ERROR 致命的なエラーではないがエラーが発生
PGRES_FATAL_ERROR 致命的なエラーが発生

 

   

機能

データベースの接続を行う。接続するにはユーザ、パスワードなどを引数に渡して、サーバで認証を行う。
もし、認証が正しかった場合、接続が行われる。

引数がNULLの場合、クライアントの環境設定が引数となる。もし、クライアントの環境設定が行われていない場合、サーバのデフォルト値が有効になる。

 

関数の引数

 
   
 

クライアントの環境設定

 
   
 

サーバのデフォルト値

 

 

   

サンプル

//一番簡単な接続方法です

PGconn *pPgconn;    
pPgconn = PQsetdbLogin("192.168.1.1",
                                  NULL,                  
                                  NULL,
                                  NULL,
                                  NULL,
                                  "postgres",
                                  "xxxxxx");

 

PostgreSQL Manualより抜粋