24.19 insertText

    procedure insertText(location : int, text : string)

    Parameter 	Type 	Description
    location 	int 	points to a position of the output stream
    text 	string 	sequence of characters to insert

    Inserts a sequence of characters passed to argument text, at the position of the output stream given by argument location. The position starts counting at 0. All floating locations that point to location, or after, are impacted by the insertion, and shift for an offset that is worth the size of the text to insert.

    If the position isn't valid, negative or bigger than the end of the output stream, an error is raised.

    In expansion mode, the position 0 points to the first character written for expansion and cannot exceed the last character written for expansion.

    Generally, the position is given by the function getFloatingLocation().

    Example:

    I'll drink a bottle of 'Margaux' year 1994@
    newFloatingLocation("You'll be drunk!");
    @ before smoking a cigar.@
    traceLine("My glass is empty, let's try another bottle, year 1996");
    insertText(getFloatingLocation("You'll be drunk!"), " and year 1996");
    traceLine("My glass is empty once again, let's try another bottle, year 2000");
    insertText(getFloatingLocation("You'll be drunk!"), " and year 2000");

    Output:

    My glass is empty, let's try another bottle, year 1996
    My glass is empty once again, let's try another bottle, year 2000

    Generated text:

    I'll drink a bottle of 'Margaux' year 1994 and year 1996 and year 2000 before smoking a cigar.

    See also:

    insertTextOnce insertTextOnce(), insertTextOnceToFloatingLocation insertTextOnceToFloatingLocation(), insertTextToFloatingLocation insertTextToFloatingLocation(), overwritePortion overwritePortion(), writeBytes writeBytes(), writeText writeText(), writeTextOnce writeTextOnce()