| InfoDirectory SDK 使用手引書 |
|
目次
索引
|
| 第2章 アプリケーション開発環境（LDAP C API） | > 2.2 関数インタフェース | > 2.2.19 エンコード／デコード処理 |
この関数は、以下の変換規則にしたがってコード変換をします。また、この関数は、ldap_conv_utf()機能を分割して、性能向上を図っています。
- Shift JIS → UTF-8
- UTF-8 → Shift JIS
- EUC → UTF-8
- UTF-8 → EUC
- ISO-8859-1 → UTF-8
- UTF-8 → ISO-8859-1
- Unicode → UTF-8
- UTF-8 → Unicode
【指定形式】
int ldap_conv_utf2(
ldap_conv_func *lcfp,
char *input,
char **output,
int in,
int out
);【パラメタの説明】
- cfp
ldap_conv_init()で獲得されたldap_conv_func構造体のアドレスを指定します。
- input
入力データのアドレスを指定します。入力データの最後にはNULL文字“\0”を設定する必要があります。
- output
出力データのアドレスを設定するための、ポインタ変数のアドレスを指定します。
- in
入力データのコード種別を指定します。inパラメタとoutパラメタのどちらか一方は、UTF-8を指定する必要があります。
- LDAP_CHARS_OPT_EUCJP ： EUC
- LDAP_CHARS_OPT_SJIS ： Shift JIS
- LDAP_CHARS_OPT_88591 ： ISO-8859-1
- LDAP_CHARS_OPT_UCS2 ： Unicode
- LDAP_CHARS_OPT_UTF8 ： UTF-8
- out
出力データのコード種別を指定します。inパラメタとoutパラメタのどちらか一方は、UTF-8を指定する必要があります。
- LDAP_CHARS_OPT_EUCJP ： EUC
- LDAP_CHARS_OPT_SJIS ： Shift JIS
- LDAP_CHARS_OPT_88591 ： ISO-8859-1
- LDAP_CHARS_OPT_UCS2 ： Unicode
- LDAP_CHARS_OPT_UTF8 ： UTF-8
【復帰値】
復帰値として以下に示す値を返します。
- 正常完了 ： 出力データのサイズ（バイト数）
- 異常完了 ： 0
正常完了の場合には、outputパラメタで指定されたポインタ変数に、出力データのアドレスが設定されています。
異常完了の場合のエラー詳細は、errnoを参照してください。
【注意事項】
- コード種別
inパラメタおよびoutパラメタには、コード変換の種類に応じて以下の値を指定します。
表: 指定するコード種別
コード変換の種類
指定するパラメタ
In
out
EUC → UTF-8 LDAP_CHARS_OPT_EUCJP LDAP_CHARS_OPT_UTF8 Shift JIS → UTF-8 LDAP_CHARS_OPT_SJIS LDAP_CHARS_OPT_UTF8 ISO-8859-1 → UTF-8 LDAP_CHARS_OPT_88591 LDAP_CHARS_OPT_UTF8 Unicode → UTF-8 LDAP_CHARS_OPT_UCS2 LDAP_CHARS_OPT_UTF8 UTF-8 → EUC LDAP_CHARS_OPT_UTF8 LDAP_CHARS_OPT_EUCJP UTF-8 → Shift JIS LDAP_CHARS_OPT_UTF8 LDAP_CHARS_OPT_SJIS UTF-8 → ISO-8859-1 LDAP_CHARS_OPT_UTF8 LDAP_CHARS_OPT_88591 UTF-8 → Unicode LDAP_CHARS_OPT_UTF8 LDAP_CHARS_OPT_UCS2
- 動的メモリの解放
ldap_conv_utf2()で通知された領域は、不要になった時点でldap_memfree()を使用して解放する必要があります。詳細は、動的メモリの解放を参照してください。
- ldap_conv_func構造体の解放
ldap_conv_init()で獲得されたldap_conv_func構造体の領域は、不要になった時点でldap_conv_close()を使用して解放する必要があります。
|
目次
索引
|
