Class RawEventStream

source code

              object --+                    
                       |                    
 structure.StructureBase --+                
                           |                
              object --+   |                
                       |   |                
           common.Parser --+                
                           |                
structure.ParseableStructure --+            
                               |            
             structure.Structure --+        
                                   |        
                       RecordingBase --+    
                                       |    
                          object --+   |    
                                   |   |    
                          GhostMixin --+    
                                       |    
                          object --+   |    
                                   |   |    
                           ActiveTag --+    
                                       |    
                             EventStream --+
                                           |
                                          RawEventStream

An event stream that records events, not expanding active tags.

Normal event streams expand embedded active tags in place. This is frequently what you want, but it means that you cannot, e.g., fill in loop variables through stream macros.

With non-expanded streams, you can do that:

       <NXSTREAM id="cols">
               <LOOP listItems="\stuff">
                       <events>
                               <column name="\item"/>
                       </events>
               </LOOP>
       </NXSTREAM>
       <table id="foo">
               <FEED source="cols" stuff="x y"/>
       </table>

Note that the normal innermost-only rule for macro expansions within active tags does not apply for NXSTREAMS. Macros expanded by a replayed NXSTREAM will be re-expanded by the next active tag that sees them (this is allow embedded active tags to use macros; you need to double-escape macros for them, of course).