程序包 org.antlr.runtime

类 TokenRewriteStream

  • 所有已实现的接口:
    IntStream, TokenStream
    public class TokenRewriteStream
extends CommonTokenStream
    Useful for dumping out the input stream after doing some augmentation or other manipulations. You can insert stuff, replace, and delete chunks. Note that the operations are done lazily--only if you convert the buffer to a String. This is very efficient because you are not moving data around all the time. As the buffer of tokens is converted to strings, the toString() method(s) check to see if there is an operation at the current index. If so, the operation is done and then normal String rendering continues on the buffer. This is like having multiple Turing machine instruction streams (programs) operating on a single input tape. :) Since the operations are done lazily at toString-time, operations do not screw up the token index values. That is, an insert operation at token index i does not change the index values for tokens i+1..n-1. Because operations never actually alter the buffer, you may always get the original token stream back without undoing anything. Since the instructions are queued up, you can easily simulate transactions and roll back any changes if there is an error just by removing instructions. For example, CharStream input = new ANTLRFileStream("input"); TLexer lex = new TLexer(input); TokenRewriteStream tokens = new TokenRewriteStream(lex); T parser = new T(tokens); parser.startRule(); Then in the rules, you can execute Token t,u; ... input.insertAfter(t, "text to put after t");} input.insertAfter(u, "text after u");} System.out.println(tokens.toString()); Actually, you have to cast the 'input' to a TokenRewriteStream. :( You can also have multiple "instruction streams" and get multiple rewrites from a single pass over the input. Just name the instruction streams and use that name again when printing the buffer. This could be useful for generating a C file and also its header file--all from the same buffer: tokens.insertAfter("pass1", t, "text to put after t");} tokens.insertAfter("pass2", u, "text after u");} System.out.println(tokens.toString("pass1")); System.out.println(tokens.toString("pass2")); If you don't use named rewrite streams, a "default" stream is used as the first example shows.

    • 字段详细资料

      • DEFAULT_PROGRAM_NAME

        public static final java.lang.String DEFAULT_PROGRAM_NAME
        另请参阅:
        常量字段值

      • PROGRAM_INIT_SIZE

        public static final int PROGRAM_INIT_SIZE
        另请参阅:
        常量字段值

      • MIN_TOKEN_INDEX

        public static final int MIN_TOKEN_INDEX
        另请参阅:
        常量字段值

      • programs

        protected java.util.Map<java.lang.String,​java.util.List<TokenRewriteStream.RewriteOperation>> programs
        You may have multiple, named streams of rewrite operations. I'm calling these things "programs." Maps String (name) → rewrite (List)

      • lastRewriteTokenIndexes

        protected java.util.Map<java.lang.String,​java.lang.Integer> lastRewriteTokenIndexes
        Map String (program name) → Integer index

    • 构造器详细资料

      • TokenRewriteStream

        public TokenRewriteStream()

      • TokenRewriteStream

        public TokenRewriteStream​(TokenSource tokenSource)

      • TokenRewriteStream

        public TokenRewriteStream​(TokenSource tokenSource,
                          int channel)

    • 方法详细资料

      • init

        protected void init()

      • rollback

        public void rollback​(int instructionIndex)

      • rollback

        public void rollback​(java.lang.String programName,
                     int instructionIndex)
        Rollback the instruction stream for a program so that the indicated instruction (via instructionIndex) is no longer in the stream. UNTESTED!

      • deleteProgram

        public void deleteProgram()

      • deleteProgram

        public void deleteProgram​(java.lang.String programName)
        Reset the program so that no instructions exist

      • insertAfter

        public void insertAfter​(Token t,
                        java.lang.Object text)

      • insertAfter

        public void insertAfter​(int index,
                        java.lang.Object text)

      • insertAfter

        public void insertAfter​(java.lang.String programName,
                        Token t,
                        java.lang.Object text)

      • insertAfter

        public void insertAfter​(java.lang.String programName,
                        int index,
                        java.lang.Object text)

      • insertBefore

        public void insertBefore​(Token t,
                         java.lang.Object text)

      • insertBefore

        public void insertBefore​(int index,
                         java.lang.Object text)

      • insertBefore

        public void insertBefore​(java.lang.String programName,
                         Token t,
                         java.lang.Object text)

      • insertBefore

        public void insertBefore​(java.lang.String programName,
                         int index,
                         java.lang.Object text)

      • replace

        public void replace​(int index,
                    java.lang.Object text)

      • replace

        public void replace​(int from,
                    int to,
                    java.lang.Object text)

      • replace

        public void replace​(Token indexT,
                    java.lang.Object text)

      • replace

        public void replace​(Token from,
                    Token to,
                    java.lang.Object text)

      • replace

        public void replace​(java.lang.String programName,
                    int from,
                    int to,
                    java.lang.Object text)

      • replace

        public void replace​(java.lang.String programName,
                    Token from,
                    Token to,
                    java.lang.Object text)

      • delete

        public void delete​(int index)

      • delete

        public void delete​(int from,
                   int to)

      • delete

        public void delete​(Token indexT)

      • delete

        public void delete​(Token from,
                   Token to)

      • delete

        public void delete​(java.lang.String programName,
                   int from,
                   int to)

      • delete

        public void delete​(java.lang.String programName,
                   Token from,
                   Token to)

      • getLastRewriteTokenIndex

        public int getLastRewriteTokenIndex()

      • getLastRewriteTokenIndex

        protected int getLastRewriteTokenIndex​(java.lang.String programName)

      • setLastRewriteTokenIndex

        protected void setLastRewriteTokenIndex​(java.lang.String programName,
                                        int i)

      • toOriginalString

        public java.lang.String toOriginalString()

      • toOriginalString

        public java.lang.String toOriginalString​(int start,
                                         int end)

      • toString

        public java.lang.String toString​(java.lang.String programName)

      • toString

        public java.lang.String toString​(int start,
                                 int end)
        从接口复制的说明: TokenStream
        Return the text of all tokens from start to stop, inclusive. If the stream does not buffer all the tokens then it can just return "" or null; Users should not access $ruleLabel.text in an action of course in that case.
        指定者:
        toString 在接口中 TokenStream
        覆盖:
        toString 在类中 BufferedTokenStream

      • toString

        public java.lang.String toString​(java.lang.String programName,
                                 int start,
                                 int end)

      • reduceToSingleOperationPerIndex

        protected java.util.Map<java.lang.Integer,​? extends TokenRewriteStream.RewriteOperation> reduceToSingleOperationPerIndex​(java.util.List<? extends TokenRewriteStream.RewriteOperation> rewrites)
        We need to combine operations and report invalid operations (like overlapping replaces that are not completed nested). Inserts to same index need to be combined etc... Here are the cases: I.i.u I.j.v leave alone, nonoverlapping I.i.u I.i.v combine: Iivu R.i-j.u R.x-y.v | i-j in x-y delete first R R.i-j.u R.i-j.v delete first R R.i-j.u R.x-y.v | x-y in i-j ERROR R.i-j.u R.x-y.v | boundaries overlap ERROR Delete special case of replace (text==null): D.i-j.u D.x-y.v | boundaries overlap combine to max(min)..max(right) I.i.u R.x-y.v | i in (x+1)-y delete I (since insert before we're not deleting i) I.i.u R.x-y.v | i not in (x+1)-y leave alone, nonoverlapping R.x-y.v I.i.u | i in x-y ERROR R.x-y.v I.x.u R.x-y.uv (combine, delete I) R.x-y.v I.i.u | i not in x-y leave alone, nonoverlapping I.i.u = insert u before op @ index i R.x-y.u = replace x-y indexed tokens with u First we need to examine replaces. For any replace op: 1. wipe out any insertions before op within that range. 2. Drop any replace op before that is contained completely within that range. 3. Throw exception upon boundary overlap with any previous replace. Then we can deal with inserts: 1. for any inserts to same index, combine even if not adjacent. 2. for any prior replace with same left boundary, combine this insert with replace and delete this replace. 3. throw exception if index in same range as previous replace Don't actually delete; make op null in list. Easier to walk list. Later we can throw as we add to index → op map. Note that I.2 R.2-2 will wipe out I.2 even though, technically, the inserted stuff would be before the replace range. But, if you add tokens in front of a method body '{' and then delete the method body, I think the stuff before the '{' you added should disappear too. Return a map from token index to operation.

      • catOpText

        protected java.lang.String catOpText​(java.lang.Object a,
                                     java.lang.Object b)

      • toDebugString

        public java.lang.String toDebugString()

      • toDebugString

        public java.lang.String toDebugString​(int start,
                                      int end)