lib-mesgbox

A collection of routines for handling message-boxes, such as those used by p #mail, mail, and gen-mesgboard or cmd-bbs

MBOX-badref?	refnum base dbref -- bad?	Returns whether or not the given message number exists.
MBOX-ref2prop	refnum base dbref -- mbase dbref	Returns the name and dbref of the specific message number in the given message box.
MBOX-ref2num	refnum base dbref -- msgnum	Returns the absolute message number of a message referred to by the given reference number. See MBOX-num2ref for an explanation of those terms.
MBOX-num2ref	msgnum base dbref -- refnum	Returns the reference number of the message that has the given absolute message number. The reference number is the position number of the message in the message list. The absolute message number is the number that the message was given when it was created. The absolute reference number of a message will never change. If the message with the given message number no longer exists, then the reference to the first message after the given message number is returned.
MBOX-create	base dbref --	Creates a new message box with no messages in it.
MBOX-count	base dbref -- count	Returns the number of messages contained in the given message box.
MBOX-destroy	base dbref --	Destroys the message box and all of it's contents.
MBOX-append	{strrange} infostr base dbref -- refnum	Creates a new message with the given message items and info string and appends it at the end of the message box. Returns the message's number.
MBOX-insmesg	{strrange} infostr refnum base dbref -- refnum	Creates a new message with the given message items and info string and inserts it before the given message number in the message box. Returns the message's number.
MBOX-delmesg	refnum base dbref --	Delete the given message number in the message box. It moves the rest of the messages after it up in the message box.
MBOX-setmesg	{strrange} infostr refnum base dbref --	Sets the given message number in the given message box to contain the given message items and info string.
MBOX-msginfo	refnum base dbref -- infostr	Returns the info string of the goven message number in the message box.
MBOX-setinfo	refnum base dbref --	Sets the info string for the given message number in the message box.
MBOX-message	refnum base dbref -- {strrange}	Returns the contents of the given message number in the message box as a range of strings.

feaelin@kemenel.org
lib-mesgbox / Revised 2004 March 31 22:06 (Wednesday)
© 2004 Iain E. Davis