Emacs API (GNU Libidn 1.42)

11 Emacs API

Included in Libidn are punycode.el and idna.el that provides an Emacs Lisp API to (a limited set of) the Libidn API. This section describes the API. Currently the IDNA API always set the UseSTD3ASCIIRules flag and clear the AllowUnassigned flag, in the future there may be functionality to specify these flags via the API.

Punycode Emacs API
IDNA Emacs API

11.1 Punycode Emacs API

Variable: punycode-program ¶: Name of the GNU Libidn idn application. The default is ‘idn’. This variable can be customized.

Variable: punycode-environment ¶: List of environment variable definitions prepended to ‘process-environment’. The default is ‘("CHARSET=UTF-8")’. This variable can be customized.

Variable: punycode-encode-parameters ¶: List of parameters passed to punycode-program to invoke punycode encoding mode. The default is ‘("--quiet" "--punycode-encode")’. This variable can be customized.

Variable: punycode-decode-parameters ¶: Parameters passed to punycode-program to invoke punycode decoding mode. The default is ‘("--quiet" "--punycode-decode")’. This variable can be customized.

Function: punycode-encode string ¶: Returns a Punycode encoding of the string, after converting the input into UTF-8.

Function: punycode-decode string ¶: Returns a possibly multibyte string which is the decoding of the string which is a punycode encoded string.

11.2 IDNA Emacs API

Variable: idna-program ¶: Name of the GNU Libidn idn application. The default is ‘idn’. This variable can be customized.

Variable: idna-environment ¶: List of environment variable definitions prepended to ‘process-environment’. The default is ‘("CHARSET=UTF-8")’. This variable can be customized.

Variable: idna-to-ascii-parameters ¶: List of parameters passed to idna-program to invoke IDNA ToASCII mode. The default is ‘("--quiet" "--idna-to-ascii" "--usestd3asciirules")’. This variable can be customized.

Variable: idna-to-unicode-parameters ¶: Parameters passed idna-program to invoke IDNA ToUnicode mode. The default is ‘("--quiet" "--idna-to-unicode" "--usestd3asciirules")’. This variable can be customized.

Function: idna-to-ascii string ¶: Returns an ASCII Compatible Encoding (ACE) of the string computed by the IDNA ToASCII operation on the input string, after converting the input to UTF-8.

Function: idna-to-unicode string ¶: Returns a possibly multibyte string which is the output of the IDNA ToUnicode operation computed on the input string.