gnu.inet.encoding

## Class IDNA

- java.lang.Object
- - gnu.inet.encoding.IDNA

-     public class IDNA
      extends Object

  This class offers static methods for converting internationalized domain names to ACE and back.
  - RFC3490 IDNA
  Note that this implementation only supports 16-bit Unicode code points.

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static String` | `ACE_PREFIX`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `IDNA()`

  - ### Method Summary

    All Methods Static Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `static String` | `toASCII(String input)` Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1.
    `static String` | `toASCII(String input, boolean allowUnassigned, boolean useSTD3ASCIIRules)` Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1.
    `static String` | `toUnicode(String input)` Converts an ASCII-encoded string to Unicode.
    `static String` | `toUnicode(String input, boolean allowUnassigned, boolean useSTD3ASCIIRules)` Converts an ASCII-encoded string to Unicode.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### ACE_PREFIX

          public static final String ACE_PREFIX

      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### IDNA

          public IDNA()

  - ### Method Detail

    - #### toASCII

          public static String toASCII(String input)
                                throws IDNAException

      Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1. Unassigned characters are not allowed and STD3 ASCII rules are enforced. The input string may be a domain name containing dots.
      Parameters:
        `input` - Unicode string.
      Returns:
        Encoded string.
      Throws:
        `IDNAException`

    - #### toASCII

          public static String toASCII(String input,
                                       boolean allowUnassigned,
                                       boolean useSTD3ASCIIRules)
                                throws IDNAException

      Converts a Unicode string to ASCII using the procedure in RFC3490 section 4.1. Unassigned characters are not allowed and STD3 ASCII rules are enforced.
      Parameters:
        `input` - Unicode string.
        `allowUnassigned` - Unassigned characters, allowed or not?
        `useSTD3ASCIIRules` - STD3 ASCII rules, enforced or not?
      Returns:
        Encoded string.
      Throws:
        `IDNAException`

    - #### toUnicode

          public static String toUnicode(String input)

      Converts an ASCII-encoded string to Unicode. Unassigned characters are not allowed and STD3 hostnames are enforced. Input may be domain name containing dots.
      Parameters:
        `input` - ASCII input string.
      Returns:
        Unicode string.

    - #### toUnicode

          public static String toUnicode(String input,
                                         boolean allowUnassigned,
                                         boolean useSTD3ASCIIRules)

      Converts an ASCII-encoded string to Unicode.
      Parameters:
        `input` - ASCII input string.
        `allowUnassigned` - Allow unassigned Unicode characters.
        `useSTD3ASCIIRules` - Check that the output conforms to STD3.
      Returns:
        Unicode string.

Copyright © 2022 "Tigase, Inc.". All rights reserved.