Input and Output Primitives

Console I/O¶

Primitive	Description
dialog	Creates a custom dialog box or HTML form for user input/output
say	Displays a message
asknumber	Asks the user to enter a number
askyesno	Asks the user a Yes/No question
asktext	Asks the user to enter a text string
askmultitext	Asks the user to enter a multiline text string
choose	Asks the user to choose an item from a list
redirect	Transfers the user to a Web page outside the active script
print	Appends text to the output buffer
flush	Displays the contents of the output buffer
watch	Displays intermediate values to help debug applications at runtime
writelog	Appends text to the session history buffer
showlog	Contents of the session log buffer in HTML format
selecteditem	Extracts the selected drop-down menu item from a dialog result list
dialogroot	Adds Back buttons to dialog input forms
getfile	Prompts for a filename using a dialog box
getnode	Prompts for a node name using a dialog box
getselect	Prompts the user to select one or more items from a list
options	Causes component input values to display as a drop-down list
units	Sets preferred units for a Web application's input
status	Displays a message on the Status Bar
beep	Produces an audible tone
getclipboard	Contents of the Windows text clipboard

Primitive	Description
dir	List of files matching a specification
componentdir	File directory where the component resides
programdir	File directory where the program resides
scriptdir	File directory where the executing script resides
docname	Full path and filename of the active model or script
read	Loads the contents of a text file
write	Writes to a text file
append	Appends to a text file
readobj	Loads the contents of a binary data file
writeobj	Writes to a binary data file
readbin	Loads the contents of a binary data file
writebin	Writes to a binary data file
readcsv	Loads the contents of a comma-delimited data file
writecsv	Writes to a comma-delimited data file
appendcsv	Appends to a comma-delimited data file
readtxt	Loads the contents of a tab-delimited data file
writetxt	Writes to a tab-delimited data file
appendtxt	Appends to a tab-delimited data file
copyfile	Copies a disk file
deletefile	Deletes a disk file
createdirectory	Creates a file directory or folder
removedirectory	Deletes a file directory or folder
file_create	Creates and opens a new file
file_open	Opens an existing file
file_read	Reads data from a file
file_write	Writes data to a file
file_close	Closes a file opened by file_open or file_create
buffer_append	Appends text to a named data storage buffer
buffer_read	Reads the contents of a named data storage buffer
buffer_write	Writes text to a named data storage buffer
filedate	Returns the Last Modified Date of the file
filesize	Returns the size of the file, in bytes
authorid	Returns the Author ID of the specified model file

Primitive	Description
readhttp	Reads a document from the Internet via the HTTP protocol
writecookie	Writes data to the user's Web browser as a persistent cookie
writecookienext	Writes a cookie to the user's browser when the next page is displayed
readcookie	Reads a persistent cookie from the user's Web browser
env	Gets HTML request header data from the Web server
socket_connect	Connects to a remote TCP/IP server
socket_send	Sends data on a TCP/IP socket connection
socket_receive	Receives data on a TCP/IP socket connection
socket_close	Closes a TCP/IP socket connection
socket_accept	Waits for a TCP/IP socket connection from a remote client
ExecQuery	Get parameter values passed to the script

Primitive	Description
sql	Performs a SQL query via ODBC with standard DSN data
sqlquery	Performs a SQL query via ODBC with extended DSN data
sqlgetsource	Prompts a local user for an ODBC data source

Primitive	Description
dde	Raw Dynamic Data Exchange link
ddelink	Evaluated Dynamic Data Exchange link

Primitive	Description
mail	Sends an email message

Primitive	Description
table	Creates a Table sheet

Primitive	Description
graph	Creates a Graph sheet containing a line, bar, or scatter plot
graph3	Creates a Surface Plot sheet containing a 3-D graph

Primitive	Description
winexec	Executes a Windows program