# AcosX Words ## Description This document lists all of the **ACOS Words** supported in the A2osX implementation of **ACOS**. Note that not all **Words** are implemented at this time, please check the *Status* and *Comment* Columns. Currently only an interpreter is available (*../bin/bbsd*) | | though a compiler is planned | ## Words | Word | Syntax | Status | Short | Description | Comment | |-|-|-|-|-|-| | ADDINT | ADDINT (*string1* [,*string2*...]) | Not Yet Implemented | Add keys to the interrupt table. | The ADDINT command will add more keys to the existing interrupt keys table. previous keys will not be cleared. The functions of the keys is the same as with the SETINT command. | | | APPEND | APPEND #*device* | Not Yet Implemented | Set write operations for specified device to append to the end. | The APPEND statement is generally used to add data to an existing file. If you issue an APPEND statement, the file pointer will be moved to the end of the file. You can also find out the length of a file by doing an APPEND and then using the MARK function. Mark will then return the length of the file in bytes. | | | BYTE | byte=*number*
byte=(*number*)
byte=(*number*)=*number*256 | Not Yet Implemented | Byte-level data manipulation function. | The BYTE function is similar to the FLAG function. It is a low overhead data storage unit. Just point to where in memory you want the data to be stored using the first syntax, and you can then access the data using the second or third syntax's. | | | CHR$ | string=CHR$(ascii code [,number chars]) | Not Yet Implemented | Return string representation of ASCII code. | Returns a string with the character represented by the ASCII code. If extra *numchars* is specified, then returned string will contain that many repetitions of the character instead of just one. | | | CLEAR | clear
clear #*device* | Not Yet Implemented | Clear device. | The forms to clears share only one thing in common; they both clear data in one form or another. In the first syntax (without an argument), CLEAR will reset all the variables to nil, clear all the addresses from the for-next and gosub-return stack, and close all open files. Suggested use is at beginning of program.

In its second syntax, CLEAR is used to clear out device buffers. The legal device channels are 8, 9, 10. CLEAR #8 will clear the editor so that any output into the editor will be appended to a clear editor. CLEAR #9 will clear the top of screen display. You must clear the top of screen display before you write any info into it. CLEAR #10 will clear the ram drive. any further writes will be appended on to the end. | | | CLOCK | CLOCK(0)
CLOCK(1)=*expression*
*expression*=CLOCK(2) | Not Yet Implemented | Session timer operations. | The CLOCK function/statement is used for setting a time limit. It can also be used to find out how long someone has been using the system (i.e. how long since CLOCK(0) was called). The following options are available:

| | | CLOSE | CLOSE
CLOSE #*device* | Not Yet Implemented | Close file I/O for specified dev ice. | The CLOSE command is used to close a disk file after you are done with it. If you give a device channel with the close command, only that file will be closed. If you CLOSE with no arguments, all open files will be closed. | | | COPY | COPY *filename* [,#*device*]
COPY #*device* [,#*device*] | Not Yet Implemented | Copy file or device contents to target device. | The COPY command is used for displaying and copying information from device to device. The first argument can be a filename, in which case, the file is opened and input is taken from that file, or it can be a device. The second device is optional. If present all output will be routed there, otherwise it will be displayed to the modem/console. The second argument may not be another filename. If you wish to copy to a file, open the file with the OPEN command, and copy to that device. | | | CREATE | CREATE *filename* | Not Yet Implemented | Create an empty file. | The CREATE statement is used to create an empty file on the disk. The new file can be opened and read and written to just as any other file would be. If you want to create a new file, you must use the CREATE statement first unlike some other languages which will create files by simply using the OPEN command on a file that does not already exist. If the file already exists, the file (contents or timestamp) will not be modified in any way. | | | CRUNCH | CRUNCH | Not Yet Implemented | Truncate specified message database. | The CRUNCH statement is used in conjunction with the MSG commands. It is used to "CRUNCH" together (truncate) a message file to reclaim space from deleted messages. | | | DATE$ | *string*=DATE$ | Not Yet Implemented | Return string with current date. | The DATE$ function returns the current date in MM/DD/YY format. The input will be taken from whatever device was configured as a clock. If 00/00/00 is returned, then there is no clock in the system and the date hasn't been set. | | | ECHO | ECHO=*string*
ECHO="" | Not Yet Implemented | Specify or clear characters to be echoed during user input. | The ECHO statement is used to set the echo character to be used with the INPUT statement (e.g ECHO="\*" will mask password entry with asterisks). Once the echo has been set, that character will be sent each time a user types a character when entering text. The ECHO statement in the second syntax (setting to an empty string) will reset the echo function to normal where user input will send the character that is being typed. | | | EDIT | EDIT(*number*) | Not Yet Implemented | Text editor operations. | The EDIT statement is the command used to interface ACOS with its editor. With the different EDIT statements, you can clear the editor, see how much space is free, etc. The following list gives all legal calls: