import org.jspecify.annotations.Nullable;

/**
 * An object that converts literal text into a format safe for inclusion in a particular context
 * (such as an XML document). Typically (but not always), the inverse process of "unescaping" the
 * text is performed automatically by the relevant parser.
 *
 * <p>For example, an XML escaper would convert the literal string {@code "Foo<Bar>"} into {@code

     *
     * @param context
     *            The context in which to parse the spec. Must not be {@literal null}.
     * @param spec
     *            A string to be parsed as a <code>URL</code>. Must not be {@literal null} or empty.
     * @return A <code>URL</code>.
     */
    public static URL create(final URL context, final String spec) {

    }

    /**
     * Converts to {@literal int}.
     *
     * @param o
     *            The object to convert
     * @return The converted {@literal int}
     */
    public static int toPrimitiveInt(final Object o) {
        return toPrimitiveInt(o, null);
    }

    /**
     * Converts to {@literal int}.
     *
     * @param o
     *            The object to convert

import java.util.Iterator;

import org.codelibs.core.exception.ClUnsupportedOperationException;

/**
 * {@link Iterator} with index. The index starts from {@literal 0}.
 *
 * <p>
 * Usage example:
 * </p>
 *
 * <pre>
 * import static org.codelibs.core.collection.IndexedIterator.*;
 *
 * List&lt;String&gt; list = ...;

    }

    /**
     * Converts to {@literal double}.
     *
     * @param o
     *            The object to convert
     * @return The converted {@literal double}
     */
    public static double toPrimitiveDouble(final Object o) {
        return toPrimitiveDouble(o, null);
    }

    /**
     * Converts to {@literal double}.
     *
     * @param o
     *            The object to convert

    /**
     * Creates a {@link Reader} to read from a file with the specified encoding.
     *
     * @param is
     *            the input stream (must not be {@literal null})
     * @param encoding
     *            the encoding of the input stream (must not be {@literal null} or empty)
     * @return a {@link Reader} to read from the file
     */
    public static InputStreamReader create(final InputStream is, final String encoding) {

     * @return the value as an object
     */
    Object getAsObject(String value);

    /**
     * Returns {@literal true} if this converter can handle the specified type.
     *
     * @param clazz
     *            the type. Must not be {@literal null}
     * @return {@literal true} if this converter can handle the specified type
     */
    boolean isTarget(Class<?> clazz);

    }

    /**
     * Converts to {@literal byte}.
     *
     * @param o
     *            The object to convert
     * @return The converted {@literal byte}
     */
    public static byte toPrimitiveByte(final Object o) {
        return toPrimitiveByte(o, null);
    }

    /**
     * Converts to {@literal byte}.
     *
     * @param o
     *            The object to convert

import com.google.errorprone.annotations.DoNotMock;

/**
 * An object that converts literal text into a format safe for inclusion in a particular context
 * (such as an XML document). Typically (but not always), the inverse process of "unescaping" the
 * text is performed automatically by the relevant parser.
 *
 * <p>For example, an XML escaper would convert the literal string {@code "Foo<Bar>"} into {@code

     *
     * @param algorithm
     *            The algorithm (refer to the Javadoc of {@link MessageDigest} for available algorithms).
     *            Must not be {@literal null} or an empty string.
     * @return {@link MessageDigest}
     * @throws RuntimeException
     *             If a {@link NoSuchAlgorithmException} occurs
     */