# mb-convert-kana

mb_convert_kana

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

# 

ENTITY

string

mb_convert_kana

string

string

string

mode

"KV"

string

null

encoding

ENTITY

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

# 

ENTITY

`string`  
The `string` being converted.

`mode`  
The conversion option.

Specify with a combination of following options.

| Option | Meaning |
|----|----|
| `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" |

Applicable Conversion Options

`encoding`  
ENTITY

# 

ENTITY

The converted `string`.

# 

ENTITY

Throws a `ValueError` if the combination of different `mode`s is invalid. For example `"sS"`.

ENTITY

# 

ENTITY

| ENTITY | ENTITY |
|----|----|
| 8.2.0 | A `ValueError` is now thrown if the combination of different `mode`s is invalid. |

# 

ENTITY

<div class="example">

<div class="title">

`mb_convert_kana` example

</div>

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

/* Convert "han-kaku" "kata-kana" to "zen-kaku" "kata-kana" 
   and "zen-kaku" alphanumeric to "han-kaku" */
echo mb_convert_kana('ｺｳｻﾞﾊﾞﾝｺﾞｳ ０１２３４５６', "KVa") . "\n";
?>

   
```

ENTITY

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

       

</div>