mb_convert_kana

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_convert_kanaConvert "kana" one from another ("zen-kaku", "han-kaku" and more)

Beschreibung

mb_convert_kana(string$string, string$mode = "KV", ?string$encoding = null): string

Performs a "han-kaku" - "zen-kaku" conversion for stringstring. This function is only useful for Japanese.

Parameter-Liste

string

The string being converted.

mode

The conversion option.

Specify with a combination of following options.

Applicable Conversion Options
OptionMeaning
r Convert "zen-kaku" alphabets to "han-kaku"
R Convert "han-kaku" alphabets to "zen-kaku"
n Convert "zen-kaku" numbers to "han-kaku"
N Convert "han-kaku" numbers to "zen-kaku"
a Convert "zen-kaku" alphabets and numbers to "han-kaku"
A Convert "han-kaku" alphabets and numbers to "zen-kaku" (Characters included in "a", "A" options are U+0021 - U+007E excluding U+0022, U+0027, U+005C, U+007E)
s Convert "zen-kaku" space to "han-kaku" (U+3000 -> U+0020)
S Convert "han-kaku" space to "zen-kaku" (U+0020 -> U+3000)
k Convert "zen-kaku kata-kana" to "han-kaku kata-kana"
K Convert "han-kaku kata-kana" to "zen-kaku kata-kana"
h Convert "zen-kaku hira-gana" to "han-kaku kata-kana"
H Convert "han-kaku kata-kana" to "zen-kaku hira-gana"
c Convert "zen-kaku kata-kana" to "zen-kaku hira-gana"
C Convert "zen-kaku hira-gana" to "zen-kaku kata-kana"
V Collapse voiced sound notation and convert them into a character. Use with "K","H"
encoding

Der Parameter encoding legt die Zeichenkodierung fest. Wird er nicht übergeben, so wird die interne Zeichenkodierung genutzt.

Rückgabewerte

The converted string.

Fehler/Exceptions

Throws a ValueError if the combination of different modes is invalid. For example "sS".

Changelog

VersionBeschreibung
8.2.0 A ValueError is now thrown if the combination of different modes is invalid.
8.0.0encoding ist nun nullable (akzeptiert den null-Wert).

Beispiele

Beispiel #1 mb_convert_kana() example

<?php

$str = mb_convert_kana($str, "KVC");


$str = mb_convert_kana($str, "KVa");
?>
To Top