Difference between revisions of "POP DATASESSION"
From Lianjapedia
Yvonne.milne (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
Line 6: | Line 6: | ||
==See Also== | ==See Also== | ||
− | [[PUSH DATASESSION]], [[RESTORE DATASESSION]], [[RESTORE RECORDVIEW]], [[SAVE DATASESSION]], [[SAVE RECORDVIEW]] | + | [[DATASESSIONLEVEL()]], [[PUSH DATASESSION]], [[RESTORE DATASESSION]], [[RESTORE RECORDVIEW]], [[SAVE DATASESSION]], [[SAVE RECORDVIEW]] |
==Description== | ==Description== | ||
Line 15: | Line 15: | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
+ | ? datasessionlevel() // returns 0 | ||
// save the current data session | // save the current data session | ||
push datasession | push datasession | ||
+ | ? datasessionlevel() // returns 1 | ||
// Carry out other operations with different data | // Carry out other operations with different data | ||
// then save this second data session | // then save this second data session | ||
push datasession | push datasession | ||
+ | ? datasessionlevel() // returns 2 | ||
// Carry out other operations with different data | // Carry out other operations with different data | ||
// then restore the second data session | // then restore the second data session | ||
pop datasession | pop datasession | ||
+ | ? datasessionlevel() // returns 1 | ||
// Carry out other operations with different data | // Carry out other operations with different data | ||
// then restore the original data session | // then restore the original data session | ||
pop datasession | pop datasession | ||
+ | ? datasessionlevel() // returns 0 | ||
</code> | </code> | ||
Latest revision as of 06:01, 19 March 2018
Contents
Purpose
Restore the last 'pushed' data session
Syntax
POP DATASESSION
See Also
DATASESSIONLEVEL(), PUSH DATASESSION, RESTORE DATASESSION, RESTORE RECORDVIEW, SAVE DATASESSION, SAVE RECORDVIEW
Description
The POP DATASESSION command is used to restore the last data session saved with PUSH DATASESSION. Data sessions can be pushed and popped up to 256 levels deep and operate on a last in, first out basis.
The SAVE DATASESSION and RESTORE DATASESSION commands can also be used to save and restore the current data session, optionally saving and restoring from a memory variable.
Example
? datasessionlevel() // returns 0 // save the current data session push datasession ? datasessionlevel() // returns 1 // Carry out other operations with different data // then save this second data session push datasession ? datasessionlevel() // returns 2 // Carry out other operations with different data // then restore the second data session pop datasession ? datasessionlevel() // returns 1 // Carry out other operations with different data // then restore the original data session pop datasession ? datasessionlevel() // returns 0