翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ENCODE 関数
<a name="ENCODE"></a>

ENCODE 関数は、指定された文字エンコードを使用して文字列をバイナリ表現に変換するために使用されます。

この関数は、バイナリデータを使用する必要がある場合や、異なる文字エンコーディング間で変換する必要がある場合に便利です。たとえば、バイナリストレージを必要とするデータベースにデータを保存する場合や、異なる文字エンコードを使用するシステム間でデータを転送する必要がある場合に、ENCODE 関数を使用できます。

## 構文
<a name="ENCODE-syntax"></a>

```
encode(str, charset)
```

## 引数
<a name="ENCODE-arguments"></a>

 *str*   
エンコードされる STRING 式。

 *文字セット*   
エンコードを指定する STRING 式。  
サポートされている文字セットエンコーディング (大文字と小文字を区別しない): `'US-ASCII'`、`'ISO-8859-1'`、`'UTF-8'`、`'UTF-16BE'`、`'UTF-16LE'`、および `'UTF-16'`。

## 戻り型
<a name="ENCODE-return-type"></a>

ENCODE 関数は BINARY を返します。

## 例
<a name="ENCODE-example"></a>

次の例では、エン`'utf-8'`コードを使用して文字列を`'abc'`バイナリ表現に変換します。この場合、元の文字列が返されます。これは、エン`'utf-8'`コードが可変幅の文字エンコードであり`'a'`、文字ごとに 1 バイトを使用して ASCII 文字セット全体 (、`'b'`、 を含む`'c'`) を表すことができるためです。したがって、 `'abc'`を使用する のバイナリ表現`'utf-8'`は、元の文字列と同じです。

```
SELECT encode('abc', 'utf-8');
 abc
```