7.3.8.17 mysqli::get_charset, mysqli_get_charset

Copyright 1997-2022 the PHP Documentation Group.

• mysqli::get_charset

  mysqli_get_charset

  Returns a character set object

Description

Object-oriented style

public object|null mysqli::get_charset();

Procedural style

object|null mysqli_get_charset(mysqli mysql);

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

Parameters

mysql

Procedural style only: A mysqli object returned by mysqli_connect or mysqli_init

Return Values

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

charset

Character set name

collation

Collation name

dir

Directory the charset 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

Character set status (?)

Examples

Example 7.52 mysqli::get_charset example

Object-oriented style

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

Procedural style

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

The above examples will 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(801)
}

See Also

mysqli_character_set_name

mysqli_set_charset