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 `mode`s for inválida.
8.0.0	O parâmetro `encoding` agora pode ser nulo.

Exemplos

Example #1 Exemplo de mb_convert_kana()

<?php
/* Converte todo "kana" para "zen-kaku" "kata-kana" */
$str = mb_convert_kana($str, "KVC");

/* Converte "han-kaku" "kata-kana" para "zen-kaku" "kata-kana"
   e alfanuméricos "zen-kaku" para "han-kaku" */
$str = mb_convert_kana($str, "KVa");
?>