'
' --------------------------------------------------------------------------
' PUSHSTRING   and    POPSTRING          by Jacques                 may 2005
'
' Two Functions that may transform any string in a String Stack.
'
' HTML DOCUMENTATION
' --------------------------------------------------------------------------
'
' $Include "functions\PushPopString.Inc"
'
' Function  PUSHSTRING   PopUp a MsgDialog if limit size (10000 buytes) is reached
' --------------------
' StackLength = PushString (StackStringName, StringToPush)
'
' Function  POPSTRING  returns an empty string if the StackString is empty
' -------------------
' PopedString = PopString (StackStringName)
'
' Notes:
'   - Separator between used by functions to 'separate strings is 0 (Chr$(0)
'     so you may use any string providing it contains no Chr$(0)
'   - A Built in StackString size limit of a 10000 bytes is set in PUSHSTRING
'     You can modify it in PUSHSTRING
'   - You can use it to push and pop numbers, just use "Strs" and "Val"
'     to convert to Strings or to Numbers.
'   - This is a way to return multiple datas from different types 
'   - usefull to store datas in nested procedures ...
'   - PUSH/POPSTRING is rather slow
' ---------------------------------------------------------------------------
'