@URLEncode (式言語)

文字列を URL セーフ形式にエンコードします。

構文

@URLEncode( encodingFormat ; token )

パラメータ

encodingFormat

文字列。トークンの変換に使用するエンコードの種類です。文字列引数または MIME 文字セットを指定できます。

文字列引数の場合

"Domino" -- Domino Web サーバーで使用される標準文字セットのトークンをエンコードします。このキーワードは、MIME 文字セットの "UTF-8" に相当します。
"Platform" -- 現在のシステムのネイティブ文字セットを使用してトークンをエンコードします。

MIME 文字セットの場合

非 ASCII 文字を指定された文字セットに変換し、その文字を %XX 形式にエンコードします。XX はエンコードされた値を表す 16 進数値です。次に例を示します。

"UTF-8": UCS (Universal Character Set) Transformation Format 8。ASCII 互換のマルチバイト Unicode と UCS エンコード方式です。
"ISO-8859-1": ヨーロッパ言語向けの ISO (International Standards Organization) の 8 ビット、シングルバイトコード化グラフィック文字セットです。
"Shift_JIS": 日本語向けの文字セットです。

token

文字列または文字列リスト。エンコードされる URL 文字列です。

戻り値

encodedURLString

文字列または文字列リスト。URL 文字列を指定のエンコード形式でエンコードしたものが返されます。

使用法

@URLEncode を使用して URL 文字列全体をエンコードしないでください。例えば、@URLEncode("Domino";"http://www.ibm.com/") は「http%3A%2Fwww.ibm.com%2F」を返しますが、この文字列を使用しても目的の Web サイトには正しくリンクできません。

例

次の式では、エンコードされた URL として「By%20Date」が返されます。
```
@URLEncode("Domino";"By Date")
```
次の式では、エンコードされた URL として「Support%20%E0%20la%20client%E8le」が返されます。
```
@URLEncode("ISO-8859-1";"Support à la clientèle")
```
次の式では、エンコードされた URL として「Support%20%C3A0%20la%20client%C3%A8le」が返されます。
```
@URLEncode("UTF-8";"Support à la clientèle")
```