Textutils (API)

From ComputerCraft Wiki
Jump to: navigation, search

The Textutils API is used to format and manipulate strings easily.

Grid disk.png  textutils (API)
Function Return values Description
textutils.slowWrite(string text, number rate) nil Writes string text at current cursor position, character-by-character. Number argument rate is optional and is defaulted to 20. The higher the value of rate, the faster text is written (passing a value of 1 writes one character per second).
textutils.slowPrint(string text, number rate) nil Prints string text at current cursor position, character-by-character. Number argument rate is optional and is defaulted to 20. The higher the value of rate, the faster text is printed (passing a value of 1 prints one character per second). This function also prints a newline.
textutils.formatTime(number time, boolean twentyFourHour) string formattedTime Takes input time and formats it in a more readable format. If the second value is true, returns time in twenty-four hour format; if the second value is false, returns time in twelve-hour format, with AM or PM. Default for twentyFourHour is false.
textutils.tabulate(table table/number color, table table2/number color2, ...) nil Prints tables in an ordered form. Each table is a row, the column width is auto-adjusted. If it encounters a number instead of a table then sets the text color to it.
textutils.pagedTabulate(table table/number color, table table2/number color2, ...) nil Prints tables in an ordered form, like textutils.tabulate. However, it waits for confirmation before scrolling down.
textutils.pagedPrint(string text [, number freeLines]) number linesPrinted Prints string text onto the screen, but waits for confirmation (after at least freeLines have been scrolled) before scrolling down further. Default for freeLines is 0.
textutils.serialize(table/string/number/boolean/nil data) string serializedData Returns a string representation of the data data for storage or transmission. Also exists as textutils.serialise under CC 1.6 or later.
textutils.unserialize(string serializedData) any unserializedData Returns the data reassembled from string serializedData. Used mainly together with textutils.serialize(). Also exists as textutils.unserialise under CC 1.6 or later.
textutils.serializeJSON(table/string/number/boolean data) string serializedData Returns a JSON representation of the data data in a form of a string, mainly for command usage. Also exists as textutils.serialiseJSON. Requires CC 1.7 or later.
textutils.urlEncode(string urlUnsafeString) string urlSafeString Makes a string safe to encode into a url. Spaces are replaced with +s. Unsafe characters such as '\', '£' and '}' are translated into ASCII code and preceded with a % for transmission. For reference visit: [1].