RW_PUT_EX

Purpose

Outputs the contents of a string directly to the RealWeb buffer specified in the Control parameter.

Syntax

RW_PUT_EX(String, Control)

Parameters

String String to be output to the specified buffer.

Control A dynamic arrayClosed A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  where element 1 specifies the RealWeb output buffer as follows:

RWD_NORMAL or an empty string
Output to RWC.OUTBUF

RWD_HEAD
Output to RWC.HEADBUF

RWD_JAVASCRIPT
Output to RWC.JSBUF

RWD_ERROR
Output to RWC.ERRORBUF

If element 1 of the Control array is set to RWD_JAVASCRIPT, element 2 can be set to the name of a JavaScript function. If this is done, RW_PUT_EX checks whether the function specified in element 2 is already present on the current HTML page and only appends code if it is not already present.

Comments

If element 1 of the Control array is set to RWD_JAVASCRIPT, the contents of String are placed in the header of the HTML page, enclosed in <SCRIPT> tags.