mb_convert_kana

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

mb_convert_kanaConvierte un "kana" en otro ("zen-kaku", "han-kaku" y más)

Descripción

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

Realiza una conversión "han-kaku" - "zen-kaku" en la cadena string. Esta función es únicamente útil para los japoneses.

Parámetros

string

La cadena a convertir.

mode

La opción de conversión.

Especifique las conversiones combinando los siguientes valores.

Opciones de conversión disponibles
Opción Significado
r Convierte el alfabeto "zen-kaku" en "han-kaku"
R Convierte el alfabeto "han-kaku" en "zen-kaku"
n Convierte los números "zen-kaku" en "han-kaku"
N Convierte los números "han-kaku" en "zen-kaku"
a Convierte los números y alfabeto "zen-kaku" en "han-kaku"
A Convierte los números y alfabeto "zen-kaku" en "han-kaku". (Los caracteres incluidos en las opciones "a", "A" son U+0021 - U+007E excluyendo U+0022, U+0027, U+005C, U+007E)
s Convierte "zen-kaku" en "han-kaku" (U+3000 -> U+0020)
S Convierte "han-kaku" en "zen-kaku" (U+0020 -> U+3000)
k Convierte "zen-kaku kata-kana" en "han-kaku kata-kana"
K Convierte "han-kaku kata-kana" en "zen-kaku kata-kana"
h Convierte "zen-kaku hira-gana" en "han-kaku kata-kana"
H Convierte "han-kaku kata-kana" en "zen-kaku hira-gana"
c Convierte "zen-kaku kata-kana" en "zen-kaku hira-gana"
C Convierte "zen-kaku hira-gana" en "zen-kaku kata-kana"
V Elimina las notaciones vocales y las convierte en caracteres. Usar con "K","H"

encoding

El parámetro encoding es la codificación de caracteres. Si es omitido o null, será usado el valor de la codificación de caracteres interna.

Valores devueltos

La cadena convertida.

Errores/Excepciones

Genera un ValueError si la combinación de diferentes mode no es válida. Por ejemplo "sS".

Historial de cambios

Versión Descripción
8.2.0 Ahora se genera un ValueError si la combinación de diferentes modes no es válida.
8.0.0 encoding ahora es nullable.

Ejemplos

Ejemplo #1 Ejemplo con mb_convert_kana()

<?php
/* Convierte todos los "han-kaku" "kata-kana" en "zen-kaku" "hira-gana" */
echo mb_convert_kana('ヤマダ ハナコ', "HV") . "\n";

/* Convierte "han-kaku" "kata-kana" en "zen-kaku" "kata-kana"
y "zen-kaku" alfanumérico en "han-kaku" */
echo mb_convert_kana('コウザバンゴウ 0123456', "KVa") . "\n";
?>

El resultado del ejemplo sería:

やまだ はなこ
コウザバンゴウ 0123456