# groonga - オープンソースのカラムストア機能付き全文検索エンジン

- English page

### ナビゲーション

- 索引
- 次へ |
- 前へ |
- groonga v3.0.8ドキュメント »
- 8. リファレンスマニュアル »
- 8.3. コマンド »

# 8.3.19. `normalize`

ご用心

`normalize` コマンドは実験的な機能です。このコマンドは将来的に変更されるかも知れません。

## 8.3.19.1. 概要

`normalize` コマンドは指定したノーマライザーでテキストを正規化します。

`normalize` コマンドを使うのにテーブルを作成する必要はありません。このコマンドは、ノーマライザーの結果を確認するのに便利です。

## 8.3.19.2. 構文

`normalize` コマンドは `normalizer` と `string` という二つの引数をとります。これらの引数はどちらも必須です。

    normalize normalizer string

## 8.3.19.3. 使い方

以下は `normalize` コマンドの簡単な使用例です。

実行例:

    normalize NormalizerAuto "aBcDe 123"
    # [
    #   [
    #     0,
    #     1337566253.89858,
    #     0.000355720520019531
    #   ],
    #   {
    #     "normalized": "abcde 123",
    #     "types": []
    #   }
    # ]

## 8.3.19.4. 引数

このセクションでは `normalizer` の引数について説明します。

### 8.3.19.4.1. 必須引数

必須引数は二つあります。 `normalizer` と `string` です。

#### 8.3.19.4.1.1. `normalizer`

ノーマライザーの名前を指定します。今のところ `normalize` コマンドは `NormalizerAuto` もしくは `NormalizerNFKC51` を組み込みノーマライザーとして受けつけます。もし他のノーマライザーを使いたい場合には、追加したいノーマライザーを register コマンドで登録する必要があります。

#### 8.3.19.4.1.2. `string`

正規化したい文字列を指定します。

## 8.3.19.5. 戻り値

    [HEADER, normalized]

`HEADER`

> HEADERのフォーマットは [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME] です。HEADERについては 出力形式 を参照してください。

`normalized`

> normalizedは指定したノーマライザーによる正規化されたテキストです。

## 8.3.19.6. 参考

- ノーマライザー

### ナビゲーション

- 索引
- 次へ |
- 前へ |
- groonga v3.0.8ドキュメント »
- 8. リファレンスマニュアル »
- 8.3. コマンド »