Mnemonic aid: raw for RAW local variable
See also: [gload ] , [global ] , [graw ] , [gsave ] , [gv ] , [load ] , [local ] , [lv ] , [page ] , [save ] , [v ] , [vdec ] and [vinc ]
[raw ] is like [local ] , except that it is intended for use only in the outmost, top-level context. It scans through the supplied content without processing it, and stores it in the specified local variable. The contents can then be retrieved using [v ] or [lv ] , again only in the outmost context, without being processed. This allows you to place blocks of code verbatim from a variable. When using HTML, you'd contain this within an inline HTML <div> </div> to control the display; if you feed the [raw ] variable to any aa_macro operator, the content probably will be processed. There are a few operators, such as [getc ] , that are specifically designed to take [raw ] input.
Because [raw ] has to parse through its content until it finds its own closing ], the [ and ], and the { and } instances in the content must both be balanced, that is, for every [ there must be a later, corresponding ] and for every { there must be a later, corresponding }.