php8.5
Home/ Manual/ mysqli / mysqli/ mysqli::get_charset

mysqli::get_charset

PHP function Edit on GitHub ✎

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

Returns a character set object

Description

Oop

mysqli::get_charset(): object|null

Procedural

mysqli_get_charset(mysqli $mysql): object|null

Returns a character set object providing several properties of the current active character set.

Parameters

Return Values

The function returns a character set object with the following properties:

charset

Character set name

collation

Collation name

dir

Directory the character set description was fetched from or "" for built-in character sets

min_length

Minimum character length in bytes

max_length

Maximum character length in bytes

number

Internal character set number

state

As of PHP 8.2.0, it is always 1

Examples

mysqli::get_charset example

Oop

php
<?php
  $db = mysqli_init();
  $db->real_connect("localhost","root","","test");
  $db->set_charset('latin1');
  var_dump($db->get_charset());
?>

Procedural

php
<?php
  $db = mysqli_init();
  mysqli_real_connect($db, "localhost","root","","test");
  mysqli_set_charset($db, 'latin1');
  var_dump(mysqli_get_charset($db));
?>

Outputs

output
object(stdClass)#2 (7) {
  ["charset"]=>
  string(6) "latin1"
  ["collation"]=>
  string(17) "latin1_swedish_ci"
  ["dir"]=>
  string(0) ""
  ["min_length"]=>
  int(1)
  ["max_length"]=>
  int(1)
  ["number"]=>
  int(8)
  ["state"]=>
  int(1)
}

See Also

Source: reference/mysqli/mysqli/get-charset.xml · from the official PHP manual (php/doc-en)