$push(<variable name> <data>)

This function appends a word to the end of <variable name>. The <data> is considered to be one word. This means if xdebug dword is turned on, then the client will add double quotes around <data> before appending it to the variable!

You need to turn off xdebug dword to get the epic4 behavior!

Push adds a new word to the end of $<variable name>, which is considered a variable containing a word list. It is equivalent to the following:

@ <variable_name> #= (<variable_name> ? [ ] : []) ## data

This function is useful to append a word to the end of a word list, which you might do to create a FIFO, LIFO, or other ordered queues. The reverse of push() is pop() and the inverse is unshift(), while the inverted reverse is shift().

If <variable name> doesn't exist before you push() something onto it, then it is created automatically for you.

The new value of $<variable name>.

$push(blah hello there)            adds "hello there" to end of $blah

This function first appeared in “+7” (post-ircII, pre-EPIC)