* <td>bytes</td>
 * <td>characters</td>
 * <td>bytes, characters</td>
 * <td>characters</td>
 * </tr>
 * <tr>
 * <th>{@link Reader}</th>
 * <td>characters</td>
 * <td>characters</td>
 * <td>characters</td>
 * <td>characters</td>
 * </tr>
 * <tr>
 * <th>{@link File}</th>
 * <td>bytes</td>
 * <td>characters</td>
 * <td>bytes, characters</td>
 * <td>characters</td>
 * </tr>
 * <tr>

  private boolean doneFlushing;

  /**
   * Creates a new input stream that will encode the characters from {@code reader} into bytes using
   * the given character set. Malformed input and unmappable characters will be replaced.
   *
   * @param reader input source
   * @param charset character set used for encoding chars to bytes
   * @param bufferSize size of internal input and output buffers

            }
            size--;
        }
    }

    /**
     * Converts a long value to hexadecimal characters and writes them to the specified character array.
     *
     * @param val the long value to convert to hexadecimal characters
     * @param dst the destination character array to write the hex digits into
     * @param dstIndex the starting index in the destination array

   * character, then iterates the remainder of the sequence calling {@link #matches(char)} for each
   * character.
   *
   * @param sequence the character sequence to replace matching groups of characters in
   * @param replacement the character to append to the result string in place of each group of
   *     matching characters in {@code sequence}
   * @return the new string
   */

        return "allintitle".equals(value) || "allinurl".equals(value);
    }

    /**
     * Escapes specific characters in a query string.
     * Replaces each specified character with its escaped version (prefixed with backslash).
     *
     * @param q the query string to escape
     * @param values the characters to escape
     * @return the escaped query string
     */

> **This list is non exhaustive, it depends on the operating system and filesystem under use - please consult your operating system vendor for a more comprehensive list of special characters**.

  }

  /**
   * Tests that specifying any alphanumeric characters as 'safe' causes an {@link
   * IllegalArgumentException}.
   */
  public void testBadArguments_badchars() {
    String msg = "Alphanumeric characters are always 'safe' and should not be explicitly specified";
    IllegalArgumentException expected =

    }

    /**
     * Test with special characters in the target name.
     */
    @Test
    void testSpecialCharacters() {
        String specialChars = "サーバー名/ドメイン.com-123!@#$"; // Japanese characters and symbols
        AvTargetName avTargetName = new AvTargetName(specialChars);
        assertEquals(specialChars, avTargetName.getTargetName(), "Special characters should be handled correctly");
    }

}

/**
 * Returns the next index in this at or after [startIndex] that is a character from
 * [characters]. Returns the input length if none of the requested characters can be found.
 */
private fun String.indexOfElement(
  characters: String,
  startIndex: Int = 0,
): Int {
  for (i in startIndex until length) {
    if (this[i] in characters) {
      return i
    }
  }
  return length

        if (chars.length >= 2 && Character.isUpperCase(chars[0]) && Character.isUpperCase(chars[1])) {
            return name;
        }
        chars[0] = Character.toLowerCase(chars[0]);
        return new String(chars);
    }

    /**
     * Capitalizes a string according to JavaBeans conventions.
     * Note: If the first two characters are uppercase, the string will not be capitalized.
     * <p>