This is an old revision of the document!
Table of Contents
Util
Miscellaneous internal utility functions that don't seem to fit anywhere else. You probably won't ever need to directly use any of these, except maybe String.capitalize().
String Prototypes
String.prototype.capitalize()
Returns the string with the first character capitalized.
: This doesn't work if the first character is a quotation mark or other punctuation, or a number. Does it need to?
SmutBook.Util.log( logName, message )
If Sugarcube has been put in debug mode (Config.debug=true), this function logs the given logName and message to the JS console. If Sugarcube is not in debug mode, it does nothing.
LibEcho.Util.MessageQueue
A global message queue system to allow the story author to more easily hook into the Inventory and Apparel UIs and display various flavor texts and do other processing while a player is fooling around with Inventory and Apparel.
Not fully implemented. May change as we rejigger the UIs. Maybe ought to move from here to the UI classes.
MessageQueue.push( message )
If the queue is enabled, push a message into the top of the queue.
Returns: void
MessageQueue.shift()
If the queue is enabled, shift a message off the bottom of the queue.
Returns: the message being shifted off, or null if the queue is disabled.
MessageQueue.dump( separator="\n" )
Dump the whole queue as a string, using the given separator. Clear the queue.
Returns: the whole queue as a single string
MessageQueue.on( queue=[] )
If the queue is already enabled, to nothing. Otherwise enable the queue, filling it with the given array of strings. Returns: void
MessageQueue.off()
Disable and clear the queue. Returns: the contents of the queue before it was cleared.