*   <li>{@link CharMatcher#ascii} matches ASCII characters and provides text processing methods
 *       which operate only on the ASCII characters of a string.
 * </ul>
 *
 * @author Catherine Berry
 * @author Gregory Kick
 * @since 7.0
 */
@GwtCompatible
public final class Ascii {

  private Ascii() {}

  /* The ASCII control characters, per RFC 20. */
  /**

     * Tests if the terminal's charset can encode the Unicode character,
     * falling back to ASCII if not.
     *
     * @param terminal the terminal to get the icon for
     * @return the Unicode character if supported, otherwise the ASCII fallback
     */
    public String getIcon(Terminal terminal) {
        Charset charset = getTerminalCharset(terminal);

        assertEquals("•", ConsoleIcon.DETAIL.getIcon(mockTerminal));
        assertEquals("→", ConsoleIcon.ACTION.getIcon(mockTerminal));
    }

    @Test
    @DisplayName("should return ASCII fallback when terminal uses US-ASCII")
    void shouldReturnAsciiFallbackWhenTerminalUsesAscii() {
        Terminal mockTerminal = mock(Terminal.class);
        when(mockTerminal.encoding()).thenReturn(StandardCharsets.US_ASCII);

   * document's character encoding can encode any non-ASCII code points in the input (as UTF-8 and
   * other Unicode encodings can).
   *
   * <p><b>Note:</b> This escaper only performs minimal escaping to make content structurally
   * compatible with HTML. Specifically, it does not perform entity replacement (symbolic or
   * numeric), so it does not replace non-ASCII code points with character references. This escaper

   * characters. We want to avoid lower casing special chars like U+212A (Kelvin symbol) because
   * they can return ASCII characters that match real hostnames.
   */
  private fun String.asciiToLowercase(): String =
    when {
      isAscii() -> lowercase(Locale.US)

      // This is an ASCII string.
      else -> this
    }

    assertThat(Files.toString(temp, UTF_8)).isEqualTo(ASCII);
  }

  public void testCopyIdenticalFiles() throws IOException {
    File temp1 = createTempFile();
    Files.write(ASCII, temp1, UTF_8);
    File temp2 = createTempFile();
    Files.write(ASCII, temp2, UTF_8);
    Files.copy(temp1, temp2);
    assertThat(Files.toString(temp2, UTF_8)).isEqualTo(ASCII);
  }

  public void testEqual() throws IOException {

        String name1 = "WORKSTATION     ";
        System.arraycopy(name1.getBytes("US-ASCII"), 0, src, srcIndex + 1, 16);
        src[srcIndex + 16] = 0x00; // hex code
        src[srcIndex + 17] = 0x04; // flags: active

        // Second name entry (18 bytes)
        String name2 = "DOMAIN          ";
        System.arraycopy(name2.getBytes("US-ASCII"), 0, src, srcIndex + 19, 16);
        src[srcIndex + 34] = 0x00; // hex code

        } catch (final UnsupportedEncodingException e) {
            return host;
        }
    }

    /**
     * Converts the given host string to ASCII using IDN.
     *
     * @param host the host string to convert
     * @return the ASCII representation of the host string
     */
    protected String toAscii(final String host) {
        return IDN.toASCII(decode(host), flag);
    }

    /**

        descrField.setAccessible(true);
        String descr = (String) descrField.get(null);

        assertEquals("WrLeh\u0000B13BWz\u0000", descr);

        // Verify ASCII conversion
        byte[] descrBytes = descr.getBytes("ASCII");
        assertNotNull(descrBytes);
        assertEquals(13, descrBytes.length); // WrLeh(5) + null(1) + B13BWz(6) + null(1) = 13
    }

    @Test

 * lookups.
 *
 * <p>During construction, names are normalized in two ways:
 *
 * <ol>
 *   <li>ASCII uppercase characters are converted to lowercase.
 *   <li>Unicode dot separators other than the ASCII period ({@code '.'}) are converted to the ASCII
 *       period.
 * </ol>
 *
 * <p>The normalized values will be returned from {@link #toString()} and {@link #parts()}, and will