Function: Textln
Function: Textln

Function: Textln

Textln ( MESSAGE )

Adds a TEXT cue to the response, which contains text to output, with a newline appended to end of the message.

Parameters

Parameter Type Description
MESSAGE VALUE(STRING) The message to output (plus a newline).

Returns

Returns nothing. Cannot be used in expressions.

What It Does

Prints a message to the screen with a newline appended to it.

Specifically, this adds a TEXT cue to the response with the provided message as the content, plus a newline added to the end of the message. Processing a TEXT and TEXTF cue is meant to print something to the screen in all TAME Shells. The input parameter is transformed to a string, no matter what value type it originally is.

This is a convenience function, and is functionally equivalent to:


	addCue("text", message + "\n");

It is up to the TAME shell to determine how to render the text. Authors should not use the text functions to meticulously lay out text, for example: adding whitespace in order to get text to appear in a specific location on the screen. If a TAME shells has a method for doing this sort of thing, that should be employed rather than relying on the behavior of a specific medium. Authors should also be aware about shells that employ use of different fonts or other textual effects.

All TAME shells accumulate TEXT and TEXTF cue output as through it were printed in one block. Other cues like WAIT and PAUSE do not interrupt this behavior, unless the handling of a cue requires output to the same place that text will also be output to, but for the most part, you can rely on behavior like newlines terminating a paragraph or line.

Example

Textln Example


world
{
	start()
	{
		textln("apple");
		textln("orange");
		textln("pear");
		textln("grape");
		
		// not just text
		textln(5);
		textln(3.0);
		textln(Infinity);
		textln(8 + 3 * 15);
		
		quit;
	}
}

See Also

AddCue() — Adds cues to the Response.

Additional Technical Notes

Strings in TAME are Unicode, so most characters should output how the author intends, but that may also depend on locale, encoding, or the Shell used for displaying. The Java and Browser JS implementations contain ways to easily parse formatted text.

×

Modal Header