Package org.evolvis.tartools.rfc822

Class UXAddress

  • @Deprecated
public class UXAddress
extends Path
    Deprecated.
    not yet implemented
    Represents an RFC822 (and successors) eMail address header content, like Path, except the parser accepts more varying input, especially input by humans, and MIME-encodes nōn-ASCII characters.
    Author:
    mirabilos (t.glaser@tarent.de)

    • Constructor Detail

      • UXAddress

        protected UXAddress​(String input)
        Deprecated.
        Private constructor, use the factory method of(String) instead
        Parameters:
        input - string to analyse

    • Method Detail

      • of

        public static UXAddress of​(String addresses)
        Deprecated.
        Creates and initialises a new parser for eMail addresses.
        Parameters:
        addresses - to parse
        Returns:
        null if addresses was null or very large, the new instance otherwise

      • of

        protected static <T extends org.evolvis.tartools.rfc822.Parser> T of​(Class<T> cls,
                                                                     String input)
        Constructs a parser. Intended to be used by subclasses from static factory methods *only*; see Path.of(String) for an example.
        Type Parameters:
        T - subclass of Parser to construct
        Parameters:
        cls - subclass of Parser to construct
        input - user-provided String to parse
        Returns:
        null if input was null or too large, the new instance otherwise

      • jmp

        protected final int jmp​(int pos)
        Jumps to a specified input character position, absolute jump
        Parameters:
        pos - to jump to
        Returns:
        the codepoint at that position
        Throws:
        IndexOutOfBoundsException - if pos is not in or just past the input

      • bra

        protected final int bra​(int deltapos)
        Jumps to a specified input character position, relative jump
        Parameters:
        deltapos - to add to the current positioin
        Returns:
        the codepoint at that position
        Throws:
        IndexOutOfBoundsException - if pos is not in or just past the input

      • pos

        protected final int pos()
        Returns the current input character position, for saving and restoring (with jmp(int)) and for error messages
        Returns:
        position

      • s

        protected final String s()
        Returns the input string, for use with substring comparisons (this is safe because Java™ strings are immutable)
        Returns:
        String input

      • cur

        protected final int cur()
        Returns the wide character at the current position
        Returns:
        UCS-4 codepoint, or -1 if end of input is reached

      • peek

        protected final int peek()
        Returns the wide character after the one at the current position
        Returns:
        UCS-4 codepoint, or -1 if end of input is reached

      • accept

        protected final int accept()
        Advances the current position to the next character
        Returns:
        codepoint of the next character, or -1 if end of input is reached
        Throws:
        IndexOutOfBoundsException - if end of input was already reached

      • skip

        protected final int skip​(BiFunction<Integer,​Integer,​Boolean> matcher)
        Advances the current position as long as the matcher returns true and end of input is not yet reached
        Parameters:
        matcher - gets called with cur() and peek() as arguments
        Returns:
        codepoint of the first character where the matcher returned false, or -1

      • skip

        protected final int skip​(Function<Integer,​Boolean> matcher)
        Advances the current position as long as the matcher returns true and end of input is not yet reached; cf. skip(BiFunction)
        Parameters:
        matcher - gets called with just cur() as argument
        Returns:
        codepoint of the first character where the matcher returned false, or -1