array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mb-convert-kana.php', 1 => 'mb_convert_kana', 2 => 'Converte "kana" de um tipo para outro ("zen-kaku", "han-kaku" e mais)', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Strings Multibyte e Funções', ), 'prev' => array ( 0 => 'function.mb-convert-encoding.php', 1 => 'mb_convert_encoding', ), 'next' => array ( 0 => 'function.mb-convert-variables.php', 1 => 'mb_convert_variables', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mbstring/functions/mb-convert-kana.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_convert_kana

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

mb_convert_kana — Converte "kana" de um tipo para outro ("zen-kaku", "han-kaku" e mais)

Descrição

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

Realiza uma conversão "han-kaku" - "zen-kaku" para a string string. Esta função é útil apenas para o japonês.

Parâmetros

string

A string a ser convertida.

mode

A opção de conversão.

Especifique com uma combinação das seguintes opções.
Opções de Conversão Aplicáveis
Opção Significado
r Converte alfabetos "zen-kaku" para "han-kaku"
R Converte alfabetos "han-kaku" para "zen-kaku"
n Converte números "zen-kaku" para "han-kaku"
N Converte números "han-kaku" para "zen-kaku"
a Converte alfabetos e números "zen-kaku" para "han-kaku"
A Converte alfabetos e números "han-kaku" para "zen-kaku" (Caracteres incluídos nas opções "a", "A" são U+0021 - U+007E, excluindo U+0022, U+0027, U+005C, U+007E)
s Converte espaço "zen-kaku" para "han-kaku" (U+3000 -> U+0020)
S Converte espaço "han-kaku" para "zen-kaku" (U+0020 -> U+3000)
k Converte "zen-kaku kata-kana" para "han-kaku kata-kana"
K Converte "han-kaku kata-kana" para "zen-kaku kata-kana"
h Converte "zen-kaku hira-gana" para "han-kaku kata-kana"
H Converte "han-kaku kata-kana" para "zen-kaku hira-gana"
c Converte "zen-kaku kata-kana" para "zen-kaku hira-gana"
C Converte "zen-kaku hira-gana" para "zen-kaku kata-kana"
V Colapsa a notação de som sonoro e converte-os em um caractere. Use com "K","H"

encoding

O parâmetro encoding é a codificação de caracteres. Se for omitido ou null, o valor da codificação de caracteres interna será usado.

Valor Retornado

A string convertida.

Erros/Exceções

Gera um ValueError se a combinação de diferentes modes for inválida. Por exemplo, "sS".

Registro de Alterações

Versão Descrição
8.2.0 Um ValueError agora é gerado se a combinação de diferentes modes for inválida.
8.0.0 O parâmetro encoding agora pode ser nulo.

Exemplos

Exemplo #1 Exemplo de mb_convert_kana()

<?php
/* Converte todos "han-kaku" "kata-kana" para "zen-kaku" "hira-gana" */
echo mb_convert_kana('ﾔﾏﾀﾞ ﾊﾅｺ', "HV") . "\n";

/* Converte "han-kaku" "kata-kana" para "zen-kaku" "kata-kana"
e alfanuméricos "zen-kaku" para "han-kaku" */
echo mb_convert_kana('ｺｳｻﾞﾊﾞﾝｺﾞｳ ０１２３４５６', "KVa") . "\n";
?>

O exemplo acima produzirá:

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