データベース接続のデフォルトの文字コードセットを返す

# mysqli::character_set_name

# mysqli_character_set_name

(PHP 5, PHP 7)

mysqli::character_set_name -- mysqli_character_set_name — データベース接続のデフォルトの文字コードセットを返す

### 説明

オブジェクト指向型

mysqli::character_set_name ( void ) : string

手続き型

mysqli_character_set_name ( mysqli `$link` ) : string

データベース接続の現在の文字コードセットを返します。

### パラメータ

`link`

  手続き型のみ: mysqli_connect() あるいは mysqli_init() が返すリンク ID。

### 返り値

現在の接続のデフォルト文字セットを返します。

### 例

例1 mysqli::character_set_name() の例

オブジェクト指向型

`<?php
/* 接続をオープンします */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
/* 現在の文字セットを表示します */
$charset = $mysqli->character_set_name();
printf ("Current character set is %s\n", $charset);
$mysqli->close();
?>`

手続き型

`<?php
/* 接続をオープンします */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (!$link) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
/* 現在の文字セットを表示します */
$charset = mysqli_character_set_name($link);
printf ("Current character set is %s\n",$charset);
/* 接続を閉じます */
mysqli_close($link);
?>`

上の例の出力は以下となります。

    Current character set is latin1_swedish_ci

### 参考

- mysqli_set_charset() - クライアントのデフォルト文字セットを設定する
- mysqli_client_encoding() - mysqli_character_set_name のエイリアス
- mysqli_real_escape_string() - 接続の現在の文字セットを考慮して、SQL 文で使用する文字列の特殊文字をエスケープする