# groonga - An open-source fulltext search engine and column store.

- 日本語版はこちら

### Navigation

- index
- next |
- previous |
- groonga v3.0.8 documentation »
- 8. リファレンスマニュアル »
- 8.3. Command »

# 8.3.19. `normalize`

Caution

`normalize` command is the experimental feature. This command may be changed in the future.

## 8.3.19.1. Summary

`normalize` command normalizes text by the specified normalizer.

There is no need to create table to use `normalize` command. It is usefull for you to check the results of normalizer.

## 8.3.19.2. Syntax

`normalize` commands takes two parameters - `normalizer` and `string`. Both of them are required.

    normalize normalizer string

## 8.3.19.3. Usage

Here is a simple example of `normalize` command.

Execution example:

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

## 8.3.19.4. Parameters

This section describes parameters of `normalizer`.

### 8.3.19.4.1. Required parameter

There are required parameters, `normalizer` and `string`.

#### 8.3.19.4.1.1. `normalizer`

It specifies the name of normalizer. Currently, `normalize` command accepts `NormalizerAuto` or `NormalizerNFKC51` as built-in normalizer. If you want to try another normalizer, you need to register additional normalizer plugin by `register` command.

#### 8.3.19.4.1.2. `string`

It specifies any string which you want to normalize.

## 8.3.19.5. Return value

    [HEADER, normalized]

`HEADER`

> The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME]. See Output format about HEADER.

`normalized`

> normalized is the normalized text by the specified normalizer.

## 8.3.19.6. See also

- Normalizers

### Navigation

- index
- next |
- previous |
- groonga v3.0.8 documentation »
- 8. リファレンスマニュアル »
- 8.3. Command »