ChipMaster's bwBASIC This also includes history going back to v2.10. *WARN* some binary files might have been corrupted by CRLF.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

1789 lines
77 KiB

  1. ============================================================
  2. GENERAL
  3. ============================================================
  4. OPTION VERSION "HAARDT"
  5. REM INTERNAL ID: H14
  6. REM DESCRIPTION: bas 2.4 by Michael Haardt
  7. REM REFERENCE: BAS
  8. REM by by Michael Haardt
  9. REM (c) 2014, by Michael Haardt
  10. REM http://www.moria.de/~michael/bas/
  11. REM bas-2.4.tar.gz
  12. REM
  13. OPTION STRICT OFF
  14. OPTION ANGLE RADIANS
  15. OPTION BUGS ON
  16. OPTION LABELS OFF
  17. OPTION COMPARE BINARY
  18. OPTION COVERAGE OFF
  19. OPTION TRACE OFF
  20. OPTION ERROR GOTO
  21. OPTION IMPLICIT
  22. OPTION BASE 0
  23. OPTION RECLEN 1
  24. OPTION DATE "%m/%d/%Y"
  25. OPTION TIME "%H:%M:%S"
  26. OPTION PUNCT STRING "$"
  27. OPTION PUNCT DOUBLE "#"
  28. OPTION PUNCT SINGLE "!"
  29. OPTION PUNCT CURRENCY " "
  30. OPTION PUNCT LONG " "
  31. OPTION PUNCT INTEGER "%"
  32. OPTION PUNCT BYTE " "
  33. OPTION PUNCT QUOTE """
  34. OPTION PUNCT COMMENT "'"
  35. OPTION PUNCT STATEMENT ":"
  36. OPTION PUNCT PRINT "?"
  37. OPTION PUNCT INPUT " "
  38. OPTION PUNCT IMAGE " "
  39. OPTION PUNCT LPAREN "("
  40. OPTION PUNCT RPAREN ")"
  41. OPTION PUNCT FILENUM "#"
  42. OPTION PUNCT AT " "
  43. OPTION USING DIGIT "#"
  44. OPTION USING COMMA ","
  45. OPTION USING PERIOD "."
  46. OPTION USING PLUS "+"
  47. OPTION USING MINUS "-"
  48. OPTION USING EXRAD "^"
  49. OPTION USING DOLLAR "$"
  50. OPTION USING FILLER "*"
  51. OPTION USING LITERAL "_"
  52. OPTION USING FIRST "!"
  53. OPTION USING ALL "&"
  54. OPTION USING LENGTH "\"
  55. ============================================================
  56. COMMANDS
  57. ============================================================
  58. ------------------------------------------------------------
  59. SYNTAX: AS
  60. DESCRIPTION: Syntax Error.
  61. ------------------------------------------------------------
  62. SYNTAX: BYE
  63. DESCRIPTION: Exits to the operating system.
  64. ------------------------------------------------------------
  65. SYNTAX: CALL subname( [parameter [, ...] ] )
  66. DESCRIPTION: Calls a subroutine that was defined by SUB and
  67. END SUB.
  68. ------------------------------------------------------------
  69. SYNTAX: CASE constant [TO constant]
  70. DESCRIPTION: Introduces an element of a SELECT CASE
  71. statement. Multiple tests must be seperated
  72. a comma. For example: CASE 1, 2 TO 3, IS >
  73. 4, IF < 5
  74. ------------------------------------------------------------
  75. SYNTAX: CASE IF operator constant
  76. DESCRIPTION: Introduces an element of a SELECT CASE
  77. statement. Multiple tests must be seperated
  78. a comma. For example: CASE 1, 2 TO 3, IS >
  79. 4, IF < 5
  80. ------------------------------------------------------------
  81. SYNTAX: CASE IS operator constant
  82. DESCRIPTION: Introduces an element of a SELECT CASE
  83. statement. Multiple tests must be seperated
  84. a comma. For example: CASE 1, 2 TO 3, IS >
  85. 4, IF < 5
  86. ------------------------------------------------------------
  87. SYNTAX: CASE ELSE
  88. DESCRIPTION: Introduces a default SELECT CASE element.
  89. ------------------------------------------------------------
  90. SYNTAX: CLEAR
  91. DESCRIPTION: Sets all numeric variables to 0, and all
  92. string variables to empty strings.
  93. ------------------------------------------------------------
  94. SYNTAX: COPY source$ TO target$
  95. DESCRIPTION: Copy an exisitng file.
  96. ------------------------------------------------------------
  97. SYNTAX: DATA constant [, ...]
  98. DESCRIPTION: Stores numeric and string constants to be
  99. accessed by READ.
  100. ------------------------------------------------------------
  101. SYNTAX: DEC variable [,...]
  102. DESCRIPTION: Decrement a numeric variable.
  103. ------------------------------------------------------------
  104. SYNTAX: DEFDBL letter[-letter] [, ...]
  105. DESCRIPTION: Declares variables with single-letter names as
  106. numeric variables.
  107. ------------------------------------------------------------
  108. SYNTAX: DEFINT letter[-letter] [, ...]
  109. DESCRIPTION: Declares variables with single-letter names as
  110. numeric variables.
  111. ------------------------------------------------------------
  112. SYNTAX: DEFSTR letter[-letter] [, ...]
  113. DESCRIPTION: Declares variables with single-letter names as
  114. string variables.
  115. ------------------------------------------------------------
  116. SYNTAX: DELETE line [- line]
  117. DESCRIPTION: Deletes program lines indicated by the
  118. argument(s). All program lines have a
  119. number, which is visible with the LIST
  120. command. If line numbers are not provided,
  121. they are assigned beginning with 1. Deleting
  122. a non-existing line does not cause an error.
  123. ------------------------------------------------------------
  124. SYNTAX: DIM [# filenum,] variable([ lower TO ] upper)
  125. DESCRIPTION: Declares variables and specifies the
  126. dimensions of array variables. For array
  127. variables, if the lower bound is not
  128. provided, then the OPTION BASE value is used.
  129. If filenum is provided, then the variable is
  130. virtual.
  131. ------------------------------------------------------------
  132. SYNTAX: DISPLAY source$
  133. DESCRIPTION: Display an exisitng text file.
  134. ------------------------------------------------------------
  135. SYNTAX: DO UNTIL value
  136. DESCRIPTION: Top of a DO - LOOP structure. Exits when
  137. value is non-zero.
  138. ------------------------------------------------------------
  139. SYNTAX: DO
  140. DESCRIPTION: Top of a DO - LOOP structure. If the loop is
  141. not terminated by EXIT DO or LOOP UNTIL or
  142. LOOP WHILE, then it will loop forever.
  143. ------------------------------------------------------------
  144. SYNTAX: DO WHILE value
  145. DESCRIPTION: Top of a DO - LOOP structure. Exits when
  146. value is zero.
  147. ------------------------------------------------------------
  148. SYNTAX: ELSE
  149. DESCRIPTION: Introduces a default condition in a multi-line
  150. IF statement.
  151. ------------------------------------------------------------
  152. SYNTAX: ELSEIF
  153. DESCRIPTION: Introduces a secondary condition in a
  154. multi-line IF statement.
  155. ------------------------------------------------------------
  156. SYNTAX: END
  157. DESCRIPTION: Terminates program execution. If the BASIC
  158. program was executed from the operating
  159. system level, then control returns to the
  160. operating system, oterwise control reuturns
  161. to the BASIC prompt.
  162. ------------------------------------------------------------
  163. SYNTAX: END FUNCTION
  164. DESCRIPTION: Specifies the last line of a multi-line
  165. FUNCTION definition.
  166. ------------------------------------------------------------
  167. SYNTAX: END IF
  168. DESCRIPTION: Specifies the last line of a multi-line IF
  169. definition.
  170. ------------------------------------------------------------
  171. SYNTAX: END SELECT
  172. DESCRIPTION: Specifies the last line of a multi-line SELECT
  173. CASE definition.
  174. ------------------------------------------------------------
  175. SYNTAX: END SUB
  176. DESCRIPTION: Specifies the last line of a multi-line SUB
  177. definition.
  178. ------------------------------------------------------------
  179. SYNTAX: ERASE variable [, ...]
  180. DESCRIPTION: Eliminates arrayed variables from a program.
  181. ------------------------------------------------------------
  182. SYNTAX: EXIT
  183. DESCRIPTION: Syntax Error.
  184. ------------------------------------------------------------
  185. SYNTAX: EXIT DO
  186. DESCRIPTION: Immediately exits the inner-most DO-LOOP
  187. strucure.
  188. ------------------------------------------------------------
  189. SYNTAX: EXIT FOR
  190. DESCRIPTION: Immediately exits the inner-most FOR-NEXT
  191. strucure.
  192. ------------------------------------------------------------
  193. SYNTAX: EXIT FUNCTION
  194. DESCRIPTION: Immediately exits the inner-most multi-line
  195. FUNCTION strucure.
  196. ------------------------------------------------------------
  197. SYNTAX: EXIT REPEAT
  198. DESCRIPTION: Exit a REPEAT - UNTIL structure.
  199. ------------------------------------------------------------
  200. SYNTAX: EXIT SUB
  201. DESCRIPTION: Immediately exits the inner-most multi-line
  202. SUB strucure.
  203. ------------------------------------------------------------
  204. SYNTAX: FIELD [#] filenum, number AS variable$ [, ...]
  205. DESCRIPTION: Assigns number bytes in the buffer of random
  206. file filenum to the variable variable$. GET
  207. will automatically update the variable, and
  208. PUT will automatically use the variable.
  209. ------------------------------------------------------------
  210. SYNTAX: FOR variable = start TO finish [STEP
  211. increment]
  212. DESCRIPTION: Top of a FOR - NEXT structure. The loop will
  213. continue a fixed number of times, which is
  214. determined by the values of start, finish,
  215. and increment.
  216. ------------------------------------------------------------
  217. SYNTAX: FUNCTION [ ( parameter [, ... ] ) ]
  218. DESCRIPTION: Top line of a multi-line FUNCTION definition.
  219. The variable names specified are local to the
  220. FUNCTION definition, and are initialized
  221. BYVAL when the function is invoked by another
  222. routine.
  223. ------------------------------------------------------------
  224. SYNTAX: GET # file_number , [ byte_number ] , scalar
  225. [,...]
  226. DESCRIPTION: Gets one (or more) values from a BINARY file.
  227. ------------------------------------------------------------
  228. SYNTAX: GET # file_number [ , record_number ]
  229. DESCRIPTION: Gets one (or more) values from a RANDOM file.
  230. ------------------------------------------------------------
  231. SYNTAX: GO
  232. DESCRIPTION: Syntax Error.
  233. ------------------------------------------------------------
  234. SYNTAX: GO SUB line
  235. DESCRIPTION: Initiates a subroutine call to the line
  236. specified. The subroutine must end with
  237. RETURN. The line may be a number or a label.
  238. ------------------------------------------------------------
  239. SYNTAX: GO TO line
  240. DESCRIPTION: Branches program execution to the specified
  241. line. The line may be a number or a label.
  242. ------------------------------------------------------------
  243. SYNTAX: GOSUB line
  244. DESCRIPTION: Initiates a subroutine call to the line
  245. specified. The subroutine must end with
  246. RETURN. The line may be a number or a label.
  247. ------------------------------------------------------------
  248. SYNTAX: GOTO line
  249. DESCRIPTION: Branches program execution to the specified
  250. line. The line may be a number or a label.
  251. ------------------------------------------------------------
  252. SYNTAX: IF value THEN line1 [ELSE line2]
  253. DESCRIPTION: Single line standard IF command. If the value
  254. is non-zero, then branh to line1. If the
  255. value is zero and ELSE is provided, then
  256. branch to line2. Otherwise continue to the
  257. next line. LABELS are not allowed.
  258. ------------------------------------------------------------
  259. SYNTAX: IF value THEN
  260. DESCRIPTION: Top of a multi-line IF - END IF structure. If
  261. the value is non-zero, then the program lines
  262. upto the next ELSE or ELSE IF command are
  263. executed, otherwise the program branches to
  264. the next ELSE or ELSE IF command.
  265. ------------------------------------------------------------
  266. SYNTAX: IMAGE "format string"
  267. DESCRIPTION: Provides format string for PRINT USING
  268. linenum.
  269. ------------------------------------------------------------
  270. SYNTAX: INC variable [,...]
  271. DESCRIPTION: Increment a numeric variable.
  272. ------------------------------------------------------------
  273. SYNTAX: INPUT "prompt string" , variable [, ...]
  274. DESCRIPTION: Reads input from the terminal after displaying
  275. a prompt.
  276. ------------------------------------------------------------
  277. SYNTAX: INPUT # filenum , variable [, ...]s
  278. DESCRIPTION: Reads input from the file specified by
  279. filenum.
  280. ------------------------------------------------------------
  281. SYNTAX: INPUT variable [, ...]
  282. DESCRIPTION: Reads input from the terminal.
  283. ------------------------------------------------------------
  284. SYNTAX: [LET] variable [, ...] = value
  285. DESCRIPTION: Assigns the value to the variable. The LET
  286. keyword is optional.
  287. ------------------------------------------------------------
  288. SYNTAX: LINE
  289. DESCRIPTION: Syntax Error.
  290. ------------------------------------------------------------
  291. SYNTAX: LINE INPUT [[#] filenum,]["prompt string";]
  292. variable$
  293. DESCRIPTION: Reads entire line from the keyboard or a file
  294. into variable$.
  295. ------------------------------------------------------------
  296. SYNTAX: LIST line1 [- line2]
  297. DESCRIPTION: Lists BASIC program lines from line1 to line2
  298. to the console on stdout.
  299. ------------------------------------------------------------
  300. SYNTAX: LLIST line1 [- line2]
  301. DESCRIPTION: Lists BASIC program lines from line1 to line2
  302. to the printer on stderr.
  303. ------------------------------------------------------------
  304. SYNTAX: LOAD [filename$]
  305. DESCRIPTION: Loads an ASCII BASIC program into memory.
  306. ------------------------------------------------------------
  307. SYNTAX: LOCAL [# filenum,] variable([ lower TO ]
  308. upper)
  309. DESCRIPTION: Declares variables and specifies the
  310. dimensions of array variables. For array
  311. variables, if the lower bound is not
  312. provided, then the OPTION BASE value is used.
  313. If filenum is provided, then the variable is
  314. virtual. Only supported inside a FUNCTION or
  315. SUB.
  316. ------------------------------------------------------------
  317. SYNTAX: LOOP UNTIL value
  318. DESCRIPTION: Bottom of a DO - LOOP structure. Exits when
  319. value is nonz-zero.
  320. ------------------------------------------------------------
  321. SYNTAX: LOOP WHILE value
  322. DESCRIPTION: Bottom of a DO - LOOP structure. Exits when
  323. value is zero.
  324. ------------------------------------------------------------
  325. SYNTAX: LOOP
  326. DESCRIPTION: Bottom of a DO - LOOP structure. If the loop
  327. is not terminated by EXIT DO or DO UNTIL or
  328. DO WHILE, then it will loop forever.
  329. ------------------------------------------------------------
  330. SYNTAX: LPRINT [USING format-string$;] value ...
  331. DESCRIPTION: Send output to the printer (stderr).
  332. ------------------------------------------------------------
  333. SYNTAX: LSET variable$ = value
  334. DESCRIPTION: Left-aligns the value into variable$. If the
  335. length of the value is too short, then it is
  336. padded on the right with spaces. If the
  337. length of the value is too long, then it is
  338. truncated on the right. This is only for use
  339. with variables assigned to a random access
  340. buffer with FIELD command.
  341. ------------------------------------------------------------
  342. SYNTAX: MAINTAINER
  343. DESCRIPTION: This command is reserved for use by the
  344. Bywater BASIC maintainer. It is not for the
  345. BASIC programmer.
  346. ------------------------------------------------------------
  347. SYNTAX: MAINTAINER CMDS
  348. DESCRIPTION: Syntax Error.
  349. ------------------------------------------------------------
  350. SYNTAX: MAINTAINER CMDS HTML
  351. DESCRIPTION: Dump COMMAND vs VERSION as HTML table
  352. ------------------------------------------------------------
  353. SYNTAX: MAINTAINER CMDS ID
  354. DESCRIPTION: Dump COMMAND #define.
  355. ------------------------------------------------------------
  356. SYNTAX: MAINTAINER CMDS MANUAL
  357. DESCRIPTION: Dump COMMAND manual.
  358. ------------------------------------------------------------
  359. SYNTAX: MAINTAINER CMDS_SWITCH
  360. DESCRIPTION: Dump COMMAND switch.
  361. ------------------------------------------------------------
  362. SYNTAX: MAINTAINER CMDS TABLE
  363. DESCRIPTION: Dump COMMAND table.
  364. ------------------------------------------------------------
  365. SYNTAX: MAINTAINER DEBUG
  366. DESCRIPTION: Syntax Error.
  367. ------------------------------------------------------------
  368. SYNTAX: MAINTAINER DEBUG OFF
  369. DESCRIPTION: Disable degug tracing.
  370. ------------------------------------------------------------
  371. SYNTAX: MAINTAINER DEBUG ON
  372. DESCRIPTION: Enable degug tracing.
  373. ------------------------------------------------------------
  374. SYNTAX: MAINTAINER FNCS
  375. DESCRIPTION: Syntax Error.
  376. ------------------------------------------------------------
  377. SYNTAX: MAINTAINER FNCS HTML
  378. DESCRIPTION: Dump FUNCTION vs VERSION as HTML table.
  379. ------------------------------------------------------------
  380. SYNTAX: MAINTAINER FNCS ID
  381. DESCRIPTION: Dump FUNCTION #define.
  382. ------------------------------------------------------------
  383. SYNTAX: MAINTAINER FNCS MANUAL
  384. DESCRIPTION: Dump FUNCTION manual.
  385. ------------------------------------------------------------
  386. SYNTAX: MAINTAINER FNCS SWITCH
  387. DESCRIPTION: Dump FUNCTION switch.
  388. ------------------------------------------------------------
  389. SYNTAX: MAINTAINER FNCS TABLE
  390. DESCRIPTION: Dump FUNCTION table.
  391. ------------------------------------------------------------
  392. SYNTAX: MAINTAINER MANUAL
  393. DESCRIPTION: Dump manual for the currently selected OPTION
  394. VERSION.
  395. ------------------------------------------------------------
  396. SYNTAX: MAINTAINER STACK
  397. DESCRIPTION: Dump the BASIC stack.
  398. ------------------------------------------------------------
  399. SYNTAX: MAT arrayname = value
  400. DESCRIPTION: Matrix operations:
  401. MAT A = CON
  402. MAT A = IDN
  403. MAT A = ZER
  404. MAT A = INV B
  405. MAT A = TRN B
  406. MAT A = (k) * B
  407. MAT A = B
  408. MAT A = B + C
  409. MAT A = B - C
  410. MAT A = B * C
  411. ------------------------------------------------------------
  412. SYNTAX: MAT INPUT arrayname
  413. DESCRIPTION: Matrix input.
  414. ------------------------------------------------------------
  415. SYNTAX: MAT PRINT arrayname
  416. DESCRIPTION: Matrix print.
  417. ------------------------------------------------------------
  418. SYNTAX: MAT READ arrayname
  419. DESCRIPTION: Matrix read.
  420. ------------------------------------------------------------
  421. SYNTAX: MAT WRITE arrayname
  422. DESCRIPTION: Matrix write.
  423. ------------------------------------------------------------
  424. SYNTAX: MID$( variable$, start [, count ] ) = value
  425. DESCRIPTION: Replaces a subtring of variable$ with value.
  426. ------------------------------------------------------------
  427. SYNTAX: NAME old$ AS new$
  428. DESCRIPTION: Changes the name of an existing file.
  429. ------------------------------------------------------------
  430. SYNTAX: NEW
  431. DESCRIPTION: Deletes the program in memory and clears all
  432. variables.
  433. ------------------------------------------------------------
  434. SYNTAX: NEXT [variable]
  435. DESCRIPTION: The bottom line of a FOR - NEXT structure.
  436. ------------------------------------------------------------
  437. SYNTAX: ON value GOSUB line [, ...]
  438. DESCRIPTION: Calls based on the rounded value.
  439. ------------------------------------------------------------
  440. SYNTAX: ON value GOTO line [, ...]
  441. DESCRIPTION: Branches based on the rounded value.
  442. ------------------------------------------------------------
  443. SYNTAX: ON ERROR
  444. DESCRIPTION: Syntax Error.
  445. ------------------------------------------------------------
  446. SYNTAX: ON ERROR GOTO errline
  447. DESCRIPTION: When a trappable error occurs, execute GOTO
  448. errline. The error handler must terminate
  449. with a RESUME command. If the line number is
  450. 0 (zerp), then use the default error handler.
  451. Valid when OPTION ERROR GOTO.
  452. ------------------------------------------------------------
  453. SYNTAX: ON ERROR RESUME
  454. DESCRIPTION: Syntax Error.
  455. ------------------------------------------------------------
  456. SYNTAX: ON ERROR RESUME NEXT
  457. DESCRIPTION: When a trappable error occurs, execution
  458. continues with the next line. Valid when
  459. OPTION ERROR GOTO.
  460. ------------------------------------------------------------
  461. SYNTAX: OPEN filename$
  462. FOR INPUT|OUTPUT|APPEND|BINARY|RANDOM|VIRTUAL
  463. AS [#] fileenumber
  464. [LEN [=] record-length]
  465. DESCRIPTION: Opens a file for use.
  466. RANDOM requires LEN.
  467. ------------------------------------------------------------
  468. SYNTAX: OPTION
  469. DESCRIPTION: Syntax Error.
  470. ------------------------------------------------------------
  471. SYNTAX: OPTION ANGLE
  472. DESCRIPTION: Syntax Error.
  473. ------------------------------------------------------------
  474. SYNTAX: OPTION ANGLE DEGREES
  475. DESCRIPTION: Configures these math functions to accept and
  476. return angles in degrees: ACOS, ACS, ANGLE,
  477. ARCSIN, ASIN, ASN, ARCTAN, ATN, ATAN, COS,
  478. COT, CSC, SEC, SIN and TAN.
  479. ------------------------------------------------------------
  480. SYNTAX: OPTION ANGLE GRADIANS
  481. DESCRIPTION: Configures these math functions to accept and
  482. return angles in gradians: ACOS, ANGLE,
  483. ASIN, ASN, ATN, ATAN, COS, COT, CSC, SEC, SIN
  484. and TAN.
  485. ------------------------------------------------------------
  486. SYNTAX: OPTION ANGLE RADIANS
  487. DESCRIPTION: Configures these math functions to accept and
  488. return angles in radians: ACOS, ANGLE, ASIN,
  489. ASN, ATN, ATAN, COS, COT, CSC, SEC, SIN and
  490. TAN.
  491. ------------------------------------------------------------
  492. SYNTAX: OPTION ARITHMETIC
  493. DESCRIPTION: Syntax Error.
  494. ------------------------------------------------------------
  495. SYNTAX: OPTION ARITHMETIC DECIMAL
  496. DESCRIPTION: Currently has no effect.
  497. ------------------------------------------------------------
  498. SYNTAX: OPTION ARITHMETIC FIXED
  499. DESCRIPTION: Currently has no effect.
  500. ------------------------------------------------------------
  501. SYNTAX: OPTION ARITHMETIC NATIVE
  502. DESCRIPTION: Currently has no effect.
  503. ------------------------------------------------------------
  504. SYNTAX: OPTION BASE integer
  505. DESCRIPTION: Sets the default lowest array subscript.
  506. ------------------------------------------------------------
  507. SYNTAX: OPTION BUGS
  508. DESCRIPTION: Syntax Error.
  509. ------------------------------------------------------------
  510. SYNTAX: OPTION BUGS BOOLEAN
  511. DESCRIPTION: Boolean results are 1 or 0 instead of bitwise.
  512. ------------------------------------------------------------
  513. SYNTAX: OPTION BUGS OFF
  514. DESCRIPTION: Disables bugs commonly found in many BASIC
  515. dialects.
  516. ------------------------------------------------------------
  517. SYNTAX: OPTION BUGS ON
  518. DESCRIPTION: Enables bugs commonly found in many BASIC
  519. dialects.
  520. ------------------------------------------------------------
  521. SYNTAX: OPTION COMPARE
  522. DESCRIPTION: Syntax Error.
  523. ------------------------------------------------------------
  524. SYNTAX: OPTION COMPARE BINARY
  525. DESCRIPTION: Causes string comparisons to be
  526. case-sensitive.
  527. ------------------------------------------------------------
  528. SYNTAX: OPTION COMPARE DATABASE
  529. DESCRIPTION: Causes string comparisons to be
  530. case-insensitive.
  531. ------------------------------------------------------------
  532. SYNTAX: OPTION COMPARE TEXT
  533. DESCRIPTION: Causes string comparisons to be
  534. case-insensitive.
  535. ------------------------------------------------------------
  536. SYNTAX: OPTION COVERAGE
  537. DESCRIPTION: Syntax Error.
  538. ------------------------------------------------------------
  539. SYNTAX: OPTION COVERAGE OFF
  540. DESCRIPTION: Disables BASIC code coverage recording,
  541. displayed using the LIST command.
  542. ------------------------------------------------------------
  543. SYNTAX: OPTION COVERAGE ON
  544. DESCRIPTION: Enables BASIC code coverage recording,
  545. displayed using the LIST command.
  546. ------------------------------------------------------------
  547. SYNTAX: OPTION DATE format$
  548. DESCRIPTION: Sets the date format string used by C
  549. strftime() for DATE$.
  550. ------------------------------------------------------------
  551. SYNTAX: OPTION DIGITS integer
  552. DESCRIPTION: Sets the number of significant digits for
  553. PRINT. Setting the value to zero restores
  554. the default.
  555. ------------------------------------------------------------
  556. SYNTAX: OPTION DISABLE
  557. DESCRIPTION: Syntax Error.
  558. ------------------------------------------------------------
  559. SYNTAX: OPTION DISABLE COMMAND name$
  560. DESCRIPTION: Disables the specified BASIC command.
  561. ------------------------------------------------------------
  562. SYNTAX: OPTION DISABLE FUNCTION name$
  563. DESCRIPTION: Disables the specified BASIC function.
  564. ------------------------------------------------------------
  565. SYNTAX: OPTION DISABLE OPERATOR name$
  566. DESCRIPTION: Disables the specified BASIC operator.
  567. ------------------------------------------------------------
  568. SYNTAX: OPTION EDIT string$
  569. DESCRIPTION: Sets the program name used by the EDIT
  570. command.
  571. ------------------------------------------------------------
  572. SYNTAX: OPTION ENABLE
  573. DESCRIPTION: Syntax Error.
  574. ------------------------------------------------------------
  575. SYNTAX: OPTION ENABLE COMMAND name$
  576. DESCRIPTION: Enables the specified BASIC command.
  577. ------------------------------------------------------------
  578. SYNTAX: OPTION ENABLE FUNCTION name$
  579. DESCRIPTION: Enables the specified BASIC function.
  580. ------------------------------------------------------------
  581. SYNTAX: OPTION ENABLE OPERATOR name$
  582. DESCRIPTION: Enables the specified BASIC operator.
  583. ------------------------------------------------------------
  584. SYNTAX: OPTION ERROR
  585. DESCRIPTION: Syntax Error.
  586. ------------------------------------------------------------
  587. SYNTAX: OPTION ERROR GOSUB
  588. DESCRIPTION: When an error occurs, GOSUB to the error
  589. handler. The error handler exits with
  590. RETURN.
  591. ------------------------------------------------------------
  592. SYNTAX: OPTION ERROR GOTO
  593. DESCRIPTION: When an error occurs, GOTO to the error
  594. handler. The error handler exits with
  595. RESUME.
  596. ------------------------------------------------------------
  597. SYNTAX: OPTION EXPLICIT
  598. DESCRIPTION: All variables must be declared using DIM.
  599. ------------------------------------------------------------
  600. SYNTAX: OPTION EXTENSION string$
  601. DESCRIPTION: Sets the BASIC filename extension, commonly
  602. ".bas".
  603. ------------------------------------------------------------
  604. SYNTAX: OPTION FILES string$
  605. DESCRIPTION: Sets the program name used by the FILES
  606. command.
  607. ------------------------------------------------------------
  608. SYNTAX: OPTION IMPLICIT
  609. DESCRIPTION: Variables need not be declared using DIM,
  610. provided arrays have no more that 10
  611. elements. This is the opposite of OPTION
  612. EXPLICIT, and is the default for all versions
  613. of BASIC.
  614. ------------------------------------------------------------
  615. SYNTAX: OPTION INDENT integer
  616. DESCRIPTION: Sets indention level for LIST. Zero means no
  617. indention. Default is 2.
  618. ------------------------------------------------------------
  619. SYNTAX: OPTION LABELS
  620. DESCRIPTION: Syntax Error.
  621. ------------------------------------------------------------
  622. SYNTAX: OPTION LABELS OFF
  623. DESCRIPTION: Disables text labels.
  624. ------------------------------------------------------------
  625. SYNTAX: OPTION LABELS ON
  626. DESCRIPTION: Enables text labels.
  627. ------------------------------------------------------------
  628. SYNTAX: OPTION PROMPT string$
  629. DESCRIPTION: Sets the BASIC prompt.
  630. ------------------------------------------------------------
  631. SYNTAX: OPTION PUNCT
  632. DESCRIPTION: Syntax Error.
  633. ------------------------------------------------------------
  634. SYNTAX: OPTION PUNCT AT char$
  635. DESCRIPTION: Sets the PRINT AT character, commonly "@".
  636. ------------------------------------------------------------
  637. SYNTAX: OPTION PUNCT BYTE char$
  638. DESCRIPTION: Sets the suffix character that indicates a
  639. variable is of type BYTE, commonly "~".
  640. ------------------------------------------------------------
  641. SYNTAX: OPTION PUNCT COMMENT char$
  642. DESCRIPTION: Sets the shortcut COMMENT character.
  643. ------------------------------------------------------------
  644. SYNTAX: OPTION PUNCT CURRENCY char$
  645. DESCRIPTION: Sets the suffix character that indicates a
  646. variable is of type CURRENCY, commonly "@".
  647. ------------------------------------------------------------
  648. SYNTAX: OPTION PUNCT DOUBLE char$
  649. DESCRIPTION: Sets the suffix character that indicates a
  650. variable is of type DOUBLE, commonly "#".
  651. ------------------------------------------------------------
  652. SYNTAX: OPTION PUNCT FILENUM char$
  653. DESCRIPTION: Sets the FILE NUMBER prefix character,
  654. commonly "#".
  655. ------------------------------------------------------------
  656. SYNTAX: OPTION PUNCT IMAGE char$
  657. DESCRIPTION: Sets the shortcut IMAGE character, commonly
  658. ":".
  659. ------------------------------------------------------------
  660. SYNTAX: OPTION PUNCT INPUT char$
  661. DESCRIPTION: Sets the shortcut INPUT character, commonly
  662. "!".
  663. ------------------------------------------------------------
  664. SYNTAX: OPTION PUNCT INTEGER char$
  665. DESCRIPTION: Sets the suffix character that indicates a
  666. variable is of type INTEGER, commonly "%".
  667. ------------------------------------------------------------
  668. SYNTAX: OPTION PUNCT LONG char$
  669. DESCRIPTION: Sets the suffix character that indicates a
  670. variable is of type LONG, commonly "&".
  671. ------------------------------------------------------------
  672. SYNTAX: OPTION PUNCT LPAREN char$
  673. DESCRIPTION: Sets the LEFT PARENTHESIS character, commonly
  674. "(".
  675. ------------------------------------------------------------
  676. SYNTAX: OPTION PUNCT_PRINT char$
  677. DESCRIPTION: Sets the shortcut PRINT character, commonly
  678. "?".
  679. ------------------------------------------------------------
  680. SYNTAX: OPTION PUNCT QUOTE char$
  681. DESCRIPTION: Sets the QUOTE character, commonly """
  682. ------------------------------------------------------------
  683. SYNTAX: OPTION PUNCT RPAREN char$
  684. DESCRIPTION: Sets the RIGHT PARENTHESIS character, commonly
  685. ")".
  686. ------------------------------------------------------------
  687. SYNTAX: OPTION PUNCT SINGLE char$
  688. DESCRIPTION: Sets the suffix character that indicates a
  689. variable is of type SINGLE, commonly "!".
  690. ------------------------------------------------------------
  691. SYNTAX: OPTION PUNCT STATEMENT char$
  692. DESCRIPTION: Sets the statement seperator character,
  693. commonly ":".
  694. ------------------------------------------------------------
  695. SYNTAX: OPTION PUNCT STRING char$
  696. DESCRIPTION: Sets the suffix character that indicates a
  697. variable is of type STRING, commonly "$".
  698. ------------------------------------------------------------
  699. SYNTAX: OPTION RECLEN integer
  700. DESCRIPTION: Sets the default RANDOM record length.
  701. ------------------------------------------------------------
  702. SYNTAX: OPTION RENUM string$
  703. DESCRIPTION: Sets the program name used by the RENUM
  704. command.
  705. ------------------------------------------------------------
  706. SYNTAX: OPTION ROUND
  707. DESCRIPTION: Syntax Error.
  708. ------------------------------------------------------------
  709. SYNTAX: OPTION ROUND BANK
  710. DESCRIPTION: Round using the Banker rule.
  711. ------------------------------------------------------------
  712. SYNTAX: OPTION ROUND MATH
  713. DESCRIPTION: Round using mathematical rules.
  714. ------------------------------------------------------------
  715. SYNTAX: OPTION ROUND TRUNCATE
  716. DESCRIPTION: Round using truncation.
  717. ------------------------------------------------------------
  718. SYNTAX: OPTION SCALE integer
  719. DESCRIPTION: Sets the number of digits to round after the
  720. decimal point for PRINT. Setting the value
  721. to zero disables rounding.
  722. ------------------------------------------------------------
  723. SYNTAX: OPTION SLEEP double
  724. DESCRIPTION: Sets multiplier for SLEEP and WAIT. Zero
  725. means no waiting. Default is 1.
  726. ------------------------------------------------------------
  727. SYNTAX: OPTION STDERR filename$
  728. DESCRIPTION: Sets the file used for STDERR, which is used
  729. by LPRINT commands.
  730. ------------------------------------------------------------
  731. SYNTAX: OPTION STDIN filename$
  732. DESCRIPTION: Sets the file used for STDIN, which is used by
  733. INPUT commands.
  734. ------------------------------------------------------------
  735. SYNTAX: OPTION STDOUT filename$
  736. DESCRIPTION: Sets the file used for STDOUT, which is used
  737. by PRINT commands.
  738. ------------------------------------------------------------
  739. SYNTAX: OPTION STRICT
  740. DESCRIPTION: Syntax Error.
  741. ------------------------------------------------------------
  742. SYNTAX: OPTION STRICT OFF
  743. DESCRIPTION: Disables checking for implicit array creation
  744. without using the DIM command.
  745. ------------------------------------------------------------
  746. SYNTAX: OPTION STRICT ON
  747. DESCRIPTION: Enables checking for implicit array creation
  748. without using the DIM command.
  749. ------------------------------------------------------------
  750. SYNTAX: OPTION TERMINAL
  751. DESCRIPTION: Syntax Error.
  752. ------------------------------------------------------------
  753. SYNTAX: OPTION TERMINAL ADM
  754. DESCRIPTION: Enables ADM-3A terminal control codes for CLS,
  755. COLOR, and LOCATE.
  756. ------------------------------------------------------------
  757. SYNTAX: OPTION TERMINAL ANSI
  758. DESCRIPTION: Enables ANSI terminal control codes for CLS,
  759. COLOR, and LOCATE.
  760. ------------------------------------------------------------
  761. SYNTAX: OPTION TERMINAL NONE
  762. DESCRIPTION: Disables terminal control codes for CLS,
  763. COLOR, and LOCATE.
  764. ------------------------------------------------------------
  765. SYNTAX: OPTION TIME format$
  766. DESCRIPTION: Sets the time format string used by C
  767. strftime() for TIME$.
  768. ------------------------------------------------------------
  769. SYNTAX: OPTION TRACE
  770. DESCRIPTION: Syntax Error.
  771. ------------------------------------------------------------
  772. SYNTAX: OPTION TRACE OFF
  773. DESCRIPTION: Disables displaying a stack trace when an
  774. ERROR occurs.
  775. ------------------------------------------------------------
  776. SYNTAX: OPTION TRACE ON
  777. DESCRIPTION: Enables displaying a stack trace when an ERROR
  778. occurs.
  779. ------------------------------------------------------------
  780. SYNTAX: OPTION USING
  781. DESCRIPTION: Syntax Error.
  782. ------------------------------------------------------------
  783. SYNTAX: OPTION USING ALL char$
  784. DESCRIPTION: Specifies the magic ALL character for the
  785. PRINT USING command. A common value is "&".
  786. ------------------------------------------------------------
  787. SYNTAX: OPTION USING COMMA char$
  788. DESCRIPTION: Specifies the magic COMMA character for the
  789. PRINT USING command. A common value is ",".
  790. ------------------------------------------------------------
  791. SYNTAX: OPTION USING DIGIT char$
  792. DESCRIPTION: Specifies the magic DIGIT character for the
  793. PRINT USING command. A common value is "#".
  794. ------------------------------------------------------------
  795. SYNTAX: OPTION USING DOLLAR char$
  796. DESCRIPTION: Specifies the magic DOLLAR character for the
  797. PRINT USING command. A common value is "$".
  798. ------------------------------------------------------------
  799. SYNTAX: OPTION USING EXRAD char$
  800. DESCRIPTION: Specifies the magic EXRAD character for the
  801. PRINT USING command. A common value is "^".
  802. ------------------------------------------------------------
  803. SYNTAX: OPTION USING FILLER char$
  804. DESCRIPTION: Specifies the magic FILLER character for the
  805. PRINT USING command. A common value is "*".
  806. ------------------------------------------------------------
  807. SYNTAX: OPTION USING FIRST char$
  808. DESCRIPTION: Specifies the magic FIRST character for the
  809. PRINT USING command. A common value is "!".
  810. ------------------------------------------------------------
  811. SYNTAX: OPTION USING LENGTH char$
  812. DESCRIPTION: Specifies the magic LENGTH character for the
  813. PRINT USING command. A common value is "\".
  814. ------------------------------------------------------------
  815. SYNTAX: OPTION USING LITERAL char$
  816. DESCRIPTION: Specifies the magic LITERAL character for the
  817. PRINT USING command. A common value is "_".
  818. ------------------------------------------------------------
  819. SYNTAX: OPTION USING MINUS char$
  820. DESCRIPTION: Specifies the magic MINUS character for the
  821. PRINT USING command. A common value is "-".
  822. ------------------------------------------------------------
  823. SYNTAX: OPTION USING PERIOD char$
  824. DESCRIPTION: Specifies the magic PERIOD character for the
  825. PRINT USING command. A common value is ".".
  826. ------------------------------------------------------------
  827. SYNTAX: OPTION USING PLUS char$
  828. DESCRIPTION: Specifies the magic PLUS character for the
  829. PRINT USING command. A common value is "+".
  830. ------------------------------------------------------------
  831. SYNTAX: OPTION VERSION version$
  832. DESCRIPTION: Selects a specific BASIC version, which is a
  833. combination of OPTION settings, commands,
  834. functions and operators. If no version is
  835. specified, displays a list of the available
  836. versions.
  837. ------------------------------------------------------------
  838. SYNTAX: OPTION ZONE integer
  839. DESCRIPTION: Sets the PRINT zone width. Setting the value
  840. to zero restores the default.
  841. ------------------------------------------------------------
  842. SYNTAX: PRINT # filenum , [USING format$;] value ...
  843. DESCRIPTION: Sends output to a file.
  844. ------------------------------------------------------------
  845. SYNTAX: PRINT [USING format$;] value ...
  846. DESCRIPTION: Sends output to the screen.
  847. ------------------------------------------------------------
  848. SYNTAX: PUT # file_number , [ byte_number ] , scalar
  849. [,...]
  850. DESCRIPTION: Puts one (or more) values into a BINARY file.
  851. ------------------------------------------------------------
  852. SYNTAX: PUT # file_number [ , record_number ]
  853. DESCRIPTION: Puts one (or more) values into a RANDOM file.
  854. ------------------------------------------------------------
  855. SYNTAX: READ variable [, ...]
  856. DESCRIPTION: Reads values from DATA statements.
  857. ------------------------------------------------------------
  858. SYNTAX: REM ...
  859. DESCRIPTION: Remark.
  860. ------------------------------------------------------------
  861. SYNTAX: RENAME from$ TO to$
  862. DESCRIPTION: Rename a file.
  863. ------------------------------------------------------------
  864. SYNTAX: RENUM
  865. DESCRIPTION: Implementation defined.
  866. ------------------------------------------------------------
  867. SYNTAX: REPEAT
  868. DESCRIPTION: Top of a REPEAT - UNTIL structure.
  869. ------------------------------------------------------------
  870. SYNTAX: RESTORE [line]
  871. DESCRIPTION: Resets the line used for the next READ
  872. statement. line may be either a number or a
  873. label.
  874. ------------------------------------------------------------
  875. SYNTAX: RESUME
  876. DESCRIPTION: Used in an error handler to specify the next
  877. line to execute. Branch to ERL.
  878. ------------------------------------------------------------
  879. SYNTAX: RESUME line
  880. DESCRIPTION: Used in an error handler to specify the next
  881. line to execute. Branch to the specified
  882. line.
  883. ------------------------------------------------------------
  884. SYNTAX: RESUME NEXT
  885. DESCRIPTION: Used in an error handler to specify the next
  886. line to execute. Branch to the line after
  887. ERL.
  888. ------------------------------------------------------------
  889. SYNTAX: RESUME 0
  890. DESCRIPTION: Used in an error handler to specify the next
  891. line to execute. Branch to ERL.
  892. ------------------------------------------------------------
  893. SYNTAX: RETURN
  894. DESCRIPTION: Concludes a subroutine called by GOSUB.
  895. ------------------------------------------------------------
  896. SYNTAX: RSET variable$ = value
  897. DESCRIPTION: Right-aligns the value into variable$. If the
  898. length of the value is too short, then it is
  899. padded on the left with spaces. If the
  900. length of the value is too long, then it is
  901. truncated on the right. This is only for use
  902. with variables assigned to a random access
  903. buffer with FIELD command.
  904. ------------------------------------------------------------
  905. SYNTAX: RUN filename$
  906. DESCRIPTION: Loads a new BAASIC program and executes the
  907. program from the start.
  908. ------------------------------------------------------------
  909. SYNTAX: RUN line
  910. DESCRIPTION: Executes the program in memory beginning at
  911. line.
  912. ------------------------------------------------------------
  913. SYNTAX: RUN
  914. DESCRIPTION: Executes the program in memory from the start.
  915. ------------------------------------------------------------
  916. SYNTAX: SAVE [filename$]
  917. DESCRIPTION: Saves the current program into the file
  918. filename$ in ASCII format.
  919. ------------------------------------------------------------
  920. SYNTAX: SELECT
  921. DESCRIPTION: Syntax Error.
  922. ------------------------------------------------------------
  923. SYNTAX: SELECT CASE value
  924. DESCRIPTION: Introduces a multi-line conditional selection
  925. statement.
  926. ------------------------------------------------------------
  927. SYNTAX: STEP
  928. DESCRIPTION: Syntax Error.
  929. ------------------------------------------------------------
  930. SYNTAX: STOP
  931. DESCRIPTION: Interrupts program execution and displays the
  932. line number of the STOP command. For use
  933. when debugging BASIC programs. Whether STOP
  934. issues a SIGINT signal is implementation
  935. defined.
  936. ------------------------------------------------------------
  937. SYNTAX: SUB name [ ( parameter [,...] ) ]
  938. DESCRIPTION: Top line of a multi-line SUB definition. The
  939. variable names specified are local to the SUB
  940. definition, and are initialized BYVAL when
  941. the subroutine is invoked by another routine.
  942. ------------------------------------------------------------
  943. SYNTAX: SUB END
  944. DESCRIPTION: Specifies the last line of a multi-line SUB
  945. definition. Same as END SUB.
  946. ------------------------------------------------------------
  947. SYNTAX: SUB EXIT
  948. DESCRIPTION: Immediately exits the inner-most multi-line
  949. SUB strucure. Same as EXIT SUB.
  950. ------------------------------------------------------------
  951. SYNTAX: SUBEND
  952. DESCRIPTION: Specifies the last line of a multi-line SUB
  953. definition. Same as END SUB.
  954. ------------------------------------------------------------
  955. SYNTAX: SUBEXIT
  956. DESCRIPTION: Immediately exits the inner-most multi-line
  957. SUB strucure. Same as EXIT SUB.
  958. ------------------------------------------------------------
  959. SYNTAX: SWAP variable, variable
  960. DESCRIPTION: Swaps the values of two variables. Both
  961. variables must be of the same type.
  962. ------------------------------------------------------------
  963. SYNTAX: SYSTEM
  964. DESCRIPTION: Exits to the operating system.
  965. ------------------------------------------------------------
  966. SYNTAX: THEN
  967. DESCRIPTION: Syntax Error.
  968. ------------------------------------------------------------
  969. SYNTAX: TO
  970. DESCRIPTION: Syntax Error.
  971. ------------------------------------------------------------
  972. SYNTAX: UNTIL value
  973. DESCRIPTION: Bottom of a REPEAT - UNTIL. If the value is
  974. non-zero, then the loop is terminated.
  975. ------------------------------------------------------------
  976. SYNTAX: WEND
  977. DESCRIPTION: Bottom of a WHILE - WEND structure.
  978. ------------------------------------------------------------
  979. SYNTAX: WHILE value
  980. DESCRIPTION: Top of a WHILE - WEND structure. If the value
  981. is non-zero, then the loop is terminated.
  982. ------------------------------------------------------------
  983. SYNTAX: WRITE # filenum, value [, .... ]
  984. DESCRIPTION: Outputs value to a file. Strings are quoted
  985. and each value is seperated by a omma.
  986. ------------------------------------------------------------
  987. SYNTAX: WRITE value [, .... ]
  988. DESCRIPTION: Outputs value to the screen. Strings are
  989. quoted and each value is seperated by a
  990. comma.
  991. ------------------------------------------------------------
  992. ============================================================
  993. FUNCTIONS
  994. ============================================================
  995. ------------------------------------------------------------
  996. SYNTAX: N = ABS( X )
  997. PARAMETER: X is a number
  998. DESCRIPTION: The absolute value of X.
  999. ------------------------------------------------------------
  1000. SYNTAX: N = ASC( A$ )
  1001. PARAMETER: A$ is a string, LEN >= 1
  1002. DESCRIPTION: The numeric code for the first letter in A$.
  1003. For example, ASC("ABC") returns 65 on ASCII
  1004. systems.
  1005. ------------------------------------------------------------
  1006. SYNTAX: N = ATN( X )
  1007. PARAMETER: X is a number
  1008. DESCRIPTION: The arctangent of X in radians, i.e. the angle
  1009. whose tangent is X, where -PI/2 < ATN(X) <
  1010. PI/2.
  1011. ------------------------------------------------------------
  1012. SYNTAX: S$ = BIN$( X )
  1013. PARAMETER: X is a number, [MININT,MAXINT]
  1014. DESCRIPTION: The the binary (base 2) representation of X.
  1015. ------------------------------------------------------------
  1016. SYNTAX: S$ = BIN$( X, Y )
  1017. PARAMETER: X is a number, [MININT,MAXINT]
  1018. PARAMETER: Y is a number, [0,255]
  1019. DESCRIPTION: The the binary (base 2) representation of X.
  1020. The result will be at least Y digits long.
  1021. ------------------------------------------------------------
  1022. SYNTAX: N = CHDIR( A$ )
  1023. PARAMETER: A$ is a string, LEN >= 1
  1024. DESCRIPTION: Changes to the directory named to A$.
  1025. ------------------------------------------------------------
  1026. SYNTAX: S$ = CHR$( X )
  1027. PARAMETER: X is a number, [0,255]
  1028. DESCRIPTION: The one-character string with the character
  1029. corresponding to the numeric code X. On
  1030. ASCII systems, CHR$(65) returns "A".
  1031. ------------------------------------------------------------
  1032. SYNTAX: N = CINT( X )
  1033. PARAMETER: X is a number, [MININT,MAXINT]
  1034. DESCRIPTION: The short (16-bit) integer value of X.
  1035. ------------------------------------------------------------
  1036. SYNTAX: N = CLOSE
  1037. DESCRIPTION: Close all open files.
  1038. ------------------------------------------------------------
  1039. SYNTAX: N = CLOSE( X )
  1040. PARAMETER: X is a number, [MININT,MAXINT]
  1041. DESCRIPTION: Close file number X.
  1042. ------------------------------------------------------------
  1043. SYNTAX: N = CLS
  1044. DESCRIPTION: Clears the screen. Cursor is positioned at row
  1045. 1, column 1.
  1046. ------------------------------------------------------------
  1047. SYNTAX: N = CODE( A$ )
  1048. PARAMETER: A$ is a string, LEN >= 1
  1049. DESCRIPTION: The numeric code for the first letter in A$.
  1050. For example, CODE("ABC") returns 65 on ASCII
  1051. systems.
  1052. ------------------------------------------------------------
  1053. SYNTAX: N = COLOR( X, Y )
  1054. PARAMETER: X is a number, [0,255]
  1055. PARAMETER: Y is a number, [0,255]
  1056. DESCRIPTION: Sets the foreground text color to X, and the
  1057. background text color to Y.
  1058. ------------------------------------------------------------
  1059. SYNTAX: S$ = COMMAND$
  1060. DESCRIPTION: All command line parameters, concatenated with
  1061. one space between each. Support for
  1062. parameters varies by operating system,
  1063. compiler, and so on.
  1064. ------------------------------------------------------------
  1065. SYNTAX: S$ = COMMAND$( X )
  1066. PARAMETER: X is a number, [0,255]
  1067. DESCRIPTION: The command line parameters. COMMAND$(0) is
  1068. the BASIC program name. COMMAND$(1) is the
  1069. first parameter after the BASIC program name,
  1070. and so on. Support for parameters varies by
  1071. operating system, compiler, and so on. X in
  1072. [0..9]
  1073. ------------------------------------------------------------
  1074. SYNTAX: N = COS( X )
  1075. PARAMETER: X is a number
  1076. DESCRIPTION: The cosine of X, where X is in radians.
  1077. ------------------------------------------------------------
  1078. SYNTAX: N = CVD( A$ )
  1079. PARAMETER: A$ is a string, LEN >= sizeof(DBL)
  1080. DESCRIPTION: The double-precision value in A$, which was
  1081. created by MKD$.
  1082. ------------------------------------------------------------
  1083. SYNTAX: N = CVI( A$ )
  1084. PARAMETER: A$ is a string, LEN >= sizeof(INT)
  1085. DESCRIPTION: The short (16-bit) integer value in A$, which
  1086. was created by MKI$.
  1087. ------------------------------------------------------------
  1088. SYNTAX: N = CVS( A$ )
  1089. PARAMETER: A$ is a string, LEN >= sizeof(FLT)
  1090. DESCRIPTION: The single-precision value in A$, which was
  1091. created by MKS$.
  1092. ------------------------------------------------------------
  1093. SYNTAX: S$ = DATE$
  1094. DESCRIPTION: The current date based on the internal clock
  1095. as a string in the format set by OPTION DATE.
  1096. ------------------------------------------------------------
  1097. SYNTAX: N = DEG( X )
  1098. PARAMETER: X is a number
  1099. DESCRIPTION: The number of degrees in X radians.
  1100. ------------------------------------------------------------
  1101. SYNTAX: N = DET
  1102. DESCRIPTION: The determinant of the last MAT INV. Zero
  1103. means error.
  1104. ------------------------------------------------------------
  1105. SYNTAX: S$ = EDIT$( A$, X )
  1106. PARAMETER: A$ is a string, LEN >= 0
  1107. PARAMETER: X is a number, [MININT,MAXINT]
  1108. DESCRIPTION: Edits the characters of A$, according to the
  1109. bits set in X.
  1110. 1 = discard parity bit.
  1111. 2 = discard all spaces.
  1112. 4 = discard all carriage returns, line feeds,
  1113. form feeds, deletes, escapes and nulls.
  1114. 8 = discard leading spaces.
  1115. 16 = replace multiple spaces with one space.
  1116. 32 = change lower case to upper case.
  1117. 64 = change [ to ( and change ] to ).
  1118. 128 = discard trailing spacess.
  1119. 256 = suppress editing within quotes.
  1120. The order in which edits occur is
  1121. implementation defined.
  1122. ------------------------------------------------------------
  1123. SYNTAX: N = ENVIRON( A$ )
  1124. PARAMETER: A$ is a string, LEN >= 1
  1125. DESCRIPTION: Sends the environment variable expression
  1126. contained in A$ to the host operating system.
  1127. A$ must contain the "=" character.
  1128. ------------------------------------------------------------
  1129. SYNTAX: S$ = ENVIRON$( A$ )
  1130. PARAMETER: A$ is a string, LEN >= 1
  1131. DESCRIPTION: The value of the environment variable named
  1132. A$.
  1133. ------------------------------------------------------------
  1134. SYNTAX: N = EOF( X )
  1135. PARAMETER: X is a number, [MININT,MAXINT]
  1136. DESCRIPTION: If device number X is at the end-of-file, then
  1137. -1, otherwise 0.
  1138. ------------------------------------------------------------
  1139. SYNTAX: N = ERL
  1140. DESCRIPTION: The line number of the most recent error.
  1141. ------------------------------------------------------------
  1142. SYNTAX: N = ERR
  1143. DESCRIPTION: The error number of the most recent error.
  1144. ------------------------------------------------------------
  1145. SYNTAX: N = EXP( X )
  1146. PARAMETER: X is a number
  1147. DESCRIPTION: The exponential value of X, i.e., the value of
  1148. the base of natural logarithms (e = 2.71828)
  1149. raised to the power of X; if EXP(X) is less
  1150. that machine infinitesimal, then its value
  1151. shall be replaced with zero.
  1152. ------------------------------------------------------------
  1153. SYNTAX: N = FALSE
  1154. DESCRIPTION: The value of FALSE.
  1155. ------------------------------------------------------------
  1156. SYNTAX: N = FIX( X )
  1157. PARAMETER: X is a number
  1158. DESCRIPTION: The truncated integer, part of X. FIX (X) is
  1159. equivalent to SGN(X)*INT(ABS(X)). The major
  1160. difference between FIX and INT is that FIX
  1161. does not return the next lower number for
  1162. negative X.
  1163. ------------------------------------------------------------
  1164. SYNTAX: N = FP( X )
  1165. PARAMETER: X is a number
  1166. DESCRIPTION: The fractional part of X, i.e. X - IP(X).
  1167. ------------------------------------------------------------
  1168. SYNTAX: N = FRAC( X )
  1169. PARAMETER: X is a number
  1170. DESCRIPTION: The fractional part of X, i.e. X - IP(X).
  1171. ------------------------------------------------------------
  1172. SYNTAX: N = FREEFILE
  1173. DESCRIPTION: The next available file number.
  1174. ------------------------------------------------------------
  1175. SYNTAX: N = GET( X )
  1176. PARAMETER: X is a number, [MININT,MAXINT]
  1177. DESCRIPTION: For file X, gets the next available record.
  1178. ------------------------------------------------------------
  1179. SYNTAX: N = GET( X, Y )
  1180. PARAMETER: X is a number, [MININT,MAXINT]
  1181. PARAMETER: Y is a number, [MININT,MAXINT]
  1182. DESCRIPTION: For file X, gets record number Y. The first
  1183. record number is 1.
  1184. ------------------------------------------------------------
  1185. SYNTAX: S$ = HEX$( X )
  1186. PARAMETER: X is a number, [MININT,MAXINT]
  1187. DESCRIPTION: The the hexadecimal (base 16) representation
  1188. of X.
  1189. ------------------------------------------------------------
  1190. SYNTAX: S$ = HEX$( X, Y )
  1191. PARAMETER: X is a number, [MININT,MAXINT]
  1192. PARAMETER: Y is a number, [0,255]
  1193. DESCRIPTION: The the hexadecimal (base 16) representation
  1194. of X. The result will be at least Y digits
  1195. long.
  1196. ------------------------------------------------------------
  1197. SYNTAX: N = HOME
  1198. DESCRIPTION: Clears the screen. Cursor is positioned at row
  1199. 1, column 1.
  1200. ------------------------------------------------------------
  1201. SYNTAX: S$ = INKEY$
  1202. DESCRIPTION: The keypress, if available. If a keypress is
  1203. not available, then immediately returns an
  1204. empty string. If not supported by the
  1205. platform, then always returns an empty
  1206. string, so use INPUT$(1) instead.
  1207. ------------------------------------------------------------
  1208. SYNTAX: N = INP( X )
  1209. PARAMETER: X is a number, [0,255]
  1210. DESCRIPTION: The value read from machine port X. Causes
  1211. ERROR 73.
  1212. ------------------------------------------------------------
  1213. SYNTAX: S$ = INPUT$( X )
  1214. PARAMETER: X is a number, [0,MAXLEN]
  1215. DESCRIPTION: The string of X characters, read from the
  1216. terminal.
  1217. ------------------------------------------------------------
  1218. SYNTAX: S$ = INPUT$( X, Y )
  1219. PARAMETER: X is a number, [0,MAXLEN]
  1220. PARAMETER: Y is a number, [MININT,MAXINT]
  1221. DESCRIPTION: The string of X characters, read from file Y.
  1222. ------------------------------------------------------------
  1223. SYNTAX: N = INSTR( A$, B$ )
  1224. PARAMETER: A$ is a string, LEN >= 0
  1225. PARAMETER: B$ is a string, LEN >= 0
  1226. DESCRIPTION: The position at which B$ occurs in A$,
  1227. beginning at position 1.
  1228. ------------------------------------------------------------
  1229. SYNTAX: N = INSTR( A$, B$, X )
  1230. PARAMETER: A$ is a string, LEN >= 0
  1231. PARAMETER: B$ is a string, LEN >= 0
  1232. PARAMETER: X is a number, [1,MAXLEN]
  1233. DESCRIPTION: The position at which B$ occurs in A$,
  1234. beginning at position X.
  1235. ------------------------------------------------------------
  1236. SYNTAX: N = INSTR( X, A$, B$ )
  1237. PARAMETER: X is a number, [1,MAXLEN]
  1238. PARAMETER: A$ is a string, LEN >= 0
  1239. PARAMETER: B$ is a string, LEN >= 0
  1240. DESCRIPTION: The position at which B$ occurs in A$,
  1241. beginning at position X.
  1242. ------------------------------------------------------------
  1243. SYNTAX: N = INT( X )
  1244. PARAMETER: X is a number
  1245. DESCRIPTION: The largest integer not greater than X; e.g.
  1246. INT(1.3) = 1 and INT(-1.3) = 2.
  1247. ------------------------------------------------------------
  1248. SYNTAX: N = INT%( X )
  1249. PARAMETER: X is a number
  1250. DESCRIPTION: The rounded integer valuet of X.
  1251. ------------------------------------------------------------
  1252. SYNTAX: N = IP( X )
  1253. PARAMETER: X is a number
  1254. DESCRIPTION: The integer part of X, i.e.,
  1255. SGN(X)*INT(ABS(X)).
  1256. ------------------------------------------------------------
  1257. SYNTAX: N = KILL( A$ )
  1258. PARAMETER: A$ is a string, LEN >= 1
  1259. DESCRIPTION: Removes the file named in A$.
  1260. ------------------------------------------------------------
  1261. SYNTAX: S$ = LCASE$( A$ )
  1262. PARAMETER: A$ is a string, LEN >= 0
  1263. DESCRIPTION: The string of characters from the value
  1264. associatedwith A$ by replacing each
  1265. upper-case-letter in the string by its
  1266. lower-case version.
  1267. ------------------------------------------------------------
  1268. SYNTAX: S$ = LEFT$( A$, X )
  1269. PARAMETER: A$ is a string, LEN >= 0
  1270. PARAMETER: X is a number, [0,MAXLEN]
  1271. DESCRIPTION: The X left-most characters of A$, beginning
  1272. from postion 1.
  1273. ------------------------------------------------------------
  1274. SYNTAX: N = LEN( A$ )
  1275. PARAMETER: A$ is a string, LEN >= 0
  1276. DESCRIPTION: The length of A$.
  1277. ------------------------------------------------------------
  1278. SYNTAX: N = LOC( X )
  1279. PARAMETER: X is a number, [MININT,MAXINT]
  1280. DESCRIPTION: The location of file X; the next record that
  1281. GET or PUT statements will use.
  1282. ------------------------------------------------------------
  1283. SYNTAX: N = LOCATE( X, Y )
  1284. PARAMETER: X is a number, [0,255]
  1285. PARAMETER: Y is a number, [0,255]
  1286. DESCRIPTION: Locates the cursor to row X, column Y.
  1287. ------------------------------------------------------------
  1288. SYNTAX: N = LOCK( X )
  1289. PARAMETER: X is a number, [MININT,MAXINT]
  1290. DESCRIPTION: Lock file number X. Causes ERROR 73.
  1291. ------------------------------------------------------------
  1292. SYNTAX: N = LOF( X )
  1293. PARAMETER: X is a number, [MININT,MAXINT]
  1294. DESCRIPTION: The length of file X.
  1295. ------------------------------------------------------------
  1296. SYNTAX: N = LOG( X )
  1297. PARAMETER: X is a number, > 0
  1298. DESCRIPTION: The natural logarithm of X; X shall be greater
  1299. than zero.
  1300. ------------------------------------------------------------
  1301. SYNTAX: N = LOG10( X )
  1302. PARAMETER: X is a number, > 0
  1303. DESCRIPTION: The common logarithm of X; X shall be greater
  1304. than zero.
  1305. ------------------------------------------------------------
  1306. SYNTAX: N = LOG2( X )
  1307. PARAMETER: X is a number, > 0
  1308. DESCRIPTION: The base 2 logarithm of X; X shall be greater
  1309. than zero.
  1310. ------------------------------------------------------------
  1311. SYNTAX: S$ = LOWER$( A$ )
  1312. PARAMETER: A$ is a string, LEN >= 0
  1313. DESCRIPTION: The string of characters from the value
  1314. associatedwith A$ by replacing each
  1315. upper-case-letter in the string by its
  1316. lower-case version.
  1317. ------------------------------------------------------------
  1318. SYNTAX: S$ = LTRIM$( A$ )
  1319. PARAMETER: A$ is a string, LEN >= 0
  1320. DESCRIPTION: The string of characters resulting from the
  1321. value associated with A$ by deleting all
  1322. leading space characters.
  1323. ------------------------------------------------------------
  1324. SYNTAX: N = MATCH( A$, B$, X )
  1325. PARAMETER: A$ is a string, LEN >= 0
  1326. PARAMETER: B$ is a string, LEN >= 0
  1327. PARAMETER: X is a number, [1,MAXLEN]
  1328. DESCRIPTION: The character position, within the value
  1329. assocated with A$, of the first character of
  1330. the first occurence of the value associated
  1331. with B$, starting at the Xth character of A$.
  1332. If there is not such occurence, then the
  1333. value returned is zero.
  1334. ------------------------------------------------------------
  1335. SYNTAX: N = MAX( X, Y )
  1336. PARAMETER: X is a number
  1337. PARAMETER: Y is a number
  1338. DESCRIPTION: The larger of the parameters.
  1339. ------------------------------------------------------------
  1340. SYNTAX: S$ = MID$( A$, X )
  1341. PARAMETER: A$ is a string, LEN >= 0
  1342. PARAMETER: X is a number, [1,MAXLEN]
  1343. DESCRIPTION: The characters of A$, starting from postion X.
  1344. ------------------------------------------------------------
  1345. SYNTAX: S$ = MID$( A$, X, Y )
  1346. PARAMETER: A$ is a string, LEN >= 0
  1347. PARAMETER: X is a number, [1,MAXLEN]
  1348. PARAMETER: Y is a number, [0,MAXLEN]
  1349. DESCRIPTION: The Y characters of A$, starting from postion
  1350. X.
  1351. ------------------------------------------------------------
  1352. SYNTAX: N = MIN( X, Y )
  1353. PARAMETER: X is a number
  1354. PARAMETER: Y is a number
  1355. DESCRIPTION: The smaller of the parameters.
  1356. ------------------------------------------------------------
  1357. SYNTAX: S$ = MKD$( X )
  1358. PARAMETER: X is a number, [MINDBL,MAXDBL]
  1359. DESCRIPTION: The internal representation of X as a string.
  1360. ------------------------------------------------------------
  1361. SYNTAX: N = MKDIR( A$ )
  1362. PARAMETER: A$ is a string, LEN >= 1
  1363. DESCRIPTION: Makes the directory named in A$.
  1364. ------------------------------------------------------------
  1365. SYNTAX: S$ = MKI$( X )
  1366. PARAMETER: X is a number, [MININT,MAXINT]
  1367. DESCRIPTION: The internal representation of the short
  1368. (16-bit) integer X as a string.
  1369. ------------------------------------------------------------
  1370. SYNTAX: S$ = MKS$( X )
  1371. PARAMETER: X is a number, [MINFLT,MAXFLT]
  1372. DESCRIPTION: The internal representation of X as a string.
  1373. ------------------------------------------------------------
  1374. SYNTAX: S$ = OCT$( X )
  1375. PARAMETER: X is a number, [MININT,MAXINT]
  1376. DESCRIPTION: The the octal (base 8) representation of X.
  1377. ------------------------------------------------------------
  1378. SYNTAX: S$ = OCT$( X, Y )
  1379. PARAMETER: X is a number, [MININT,MAXINT]
  1380. PARAMETER: Y is a number, [0,255]
  1381. DESCRIPTION: The the octal (base 8) representation of X.
  1382. The result will be at least Y digits long.
  1383. ------------------------------------------------------------
  1384. SYNTAX: N = OPEN( A$, X, B$ )
  1385. PARAMETER: A$ is a string, LEN >= 1
  1386. PARAMETER: X is a number, [MININT,MAXINT]
  1387. PARAMETER: B$ is a string, LEN >= 1
  1388. DESCRIPTION: Open file number X. A$ is the mode: "I", "O",
  1389. "A", "R". B$ is the file name. Default the
  1390. record length.
  1391. ------------------------------------------------------------
  1392. SYNTAX: N = OPEN( A$, X, B$, Y )
  1393. PARAMETER: A$ is a string, LEN >= 1
  1394. PARAMETER: X is a number, [MININT,MAXINT]
  1395. PARAMETER: B$ is a string, LEN >= 1
  1396. PARAMETER: Y is a number, [MININT,MAXINT]
  1397. DESCRIPTION: Open file number X. A$ is the mode: "I", "O",
  1398. "A", "R". B$ is the file name. Y is the
  1399. record length.
  1400. ------------------------------------------------------------
  1401. SYNTAX: N = OUT( X, Y )
  1402. PARAMETER: X is a number, [MININT,MAXINT]
  1403. PARAMETER: Y is a number, [0,255]
  1404. DESCRIPTION: Sends Y to hardware port X. Causes ERROR 73.
  1405. ------------------------------------------------------------
  1406. SYNTAX: N = PEEK( X )
  1407. PARAMETER: X is a number, [MINLNG,MAXLNG]
  1408. DESCRIPTION: The value read from hardware address X.
  1409. Causes ERROR 73.
  1410. ------------------------------------------------------------
  1411. SYNTAX: N = PI
  1412. DESCRIPTION: The constant 3.14159 which is the ratio of the
  1413. circumference of a circle to its diameter.
  1414. ------------------------------------------------------------
  1415. SYNTAX: N = POKE( X, Y )
  1416. PARAMETER: X is a number, [MINLNG,MAXLNG]
  1417. PARAMETER: Y is a number, [0,255]
  1418. DESCRIPTION: Sends Y to hardware address X. Causes ERROR
  1419. 73.
  1420. ------------------------------------------------------------
  1421. SYNTAX: N = POS
  1422. DESCRIPTION: The current cursor position in the line.
  1423. ------------------------------------------------------------
  1424. SYNTAX: N = POS( X )
  1425. PARAMETER: X is a number, [MININT,MAXINT]
  1426. DESCRIPTION: The current cursor position in the line for
  1427. file X.
  1428. ------------------------------------------------------------
  1429. SYNTAX: N = POS( A$, B$ )
  1430. PARAMETER: A$ is a string, LEN >= 0
  1431. PARAMETER: B$ is a string, LEN >= 0
  1432. DESCRIPTION: The character position, within the value
  1433. assocated with A$, of the first character of
  1434. the first occurence of the value associated
  1435. with B$, starting at the first character of
  1436. A$. If there is not such occurence, then the
  1437. value returned is zero.
  1438. ------------------------------------------------------------
  1439. SYNTAX: N = POS( A$, B$, X )
  1440. PARAMETER: A$ is a string, LEN >= 0
  1441. PARAMETER: B$ is a string, LEN >= 0
  1442. PARAMETER: X is a number, [1,MAXLEN]
  1443. DESCRIPTION: The character position, within the value
  1444. assocated with A$, of the first character of
  1445. the first occurence of the value associated
  1446. with B$, starting at the Xth character of A$.
  1447. If there is not such occurence, then the
  1448. value returned is zero.
  1449. ------------------------------------------------------------
  1450. SYNTAX: N = PUT( X )
  1451. PARAMETER: X is a number, [MININT,MAXINT]
  1452. DESCRIPTION: For file X, puts the next available record.
  1453. ------------------------------------------------------------
  1454. SYNTAX: N = PUT( X, Y )
  1455. PARAMETER: X is a number, [MININT,MAXINT]
  1456. PARAMETER: Y is a number, [MININT,MAXINT]
  1457. DESCRIPTION: For file X, puts record number Y. The first
  1458. record number is 1.
  1459. ------------------------------------------------------------
  1460. SYNTAX: N = RAD( X )
  1461. PARAMETER: X is a number
  1462. DESCRIPTION: The number of radians in X degrees.
  1463. ------------------------------------------------------------
  1464. SYNTAX: N = RANDOMIZE
  1465. DESCRIPTION: Seeds the pseudo-random number generator with
  1466. TIME.
  1467. ------------------------------------------------------------
  1468. SYNTAX: N = RANDOMIZE( X )
  1469. PARAMETER: X is a number
  1470. DESCRIPTION: Seeds the pseudo-random number generator with
  1471. X.
  1472. ------------------------------------------------------------
  1473. SYNTAX: S$ = RIGHT$( A$, X )
  1474. PARAMETER: A$ is a string, LEN >= 0
  1475. PARAMETER: X is a number, [0,MAXLEN]
  1476. DESCRIPTION: The right-most X characters of A$.
  1477. ------------------------------------------------------------
  1478. SYNTAX: N = RND
  1479. DESCRIPTION: The next pseudo-random number in an
  1480. implementation-defined sequence of
  1481. pseudo-random numbers uniformly distributed
  1482. in the range 0 <= RND < 1.
  1483. ------------------------------------------------------------
  1484. SYNTAX: N = RND( X )
  1485. PARAMETER: X is a number
  1486. DESCRIPTION: Returns a pseudorandom number in the range
  1487. [0,1]. The value of X is ignored.
  1488. ------------------------------------------------------------
  1489. SYNTAX: S$ = RTRIM$( A$ )
  1490. PARAMETER: A$ is a string, LEN >= 0
  1491. DESCRIPTION: The string of characters resulting from the
  1492. value associated with A$ by deleting all
  1493. trailing space characters.
  1494. ------------------------------------------------------------
  1495. SYNTAX: S$ = SEG$( A$, X, Y )
  1496. PARAMETER: A$ is a string, LEN >= 0
  1497. PARAMETER: X is a number, [1,MAXLEN]
  1498. PARAMETER: Y is a number, [0,MAXLEN]
  1499. DESCRIPTION: The Y characters of A$, starting from postion
  1500. X.
  1501. ------------------------------------------------------------
  1502. SYNTAX: N = SGN( X )
  1503. PARAMETER: X is a number
  1504. DESCRIPTION: The sign of X: -1 if X < 0, 0 if X = 0, and +1
  1505. if X > 0.
  1506. ------------------------------------------------------------
  1507. SYNTAX: N = SHELL( A$ )
  1508. PARAMETER: A$ is a string, LEN >= 1
  1509. DESCRIPTION: The exit code resulting from the execution of
  1510. an operating system command.
  1511. ------------------------------------------------------------
  1512. SYNTAX: N = SIN( X )
  1513. PARAMETER: X is a number
  1514. DESCRIPTION: The sine of X, where X is in radians.
  1515. ------------------------------------------------------------
  1516. SYNTAX: N = SLEEP( X )
  1517. PARAMETER: X is a number
  1518. DESCRIPTION: The program pauses for X times the value of
  1519. OPTION SLEEP seconds. If the result is zero,
  1520. negative, or more than INT_MAX then SLEEP
  1521. does nothing. The resolution is
  1522. implementation defined.
  1523. ------------------------------------------------------------
  1524. SYNTAX: S$ = SPACE$( X )
  1525. PARAMETER: X is a number, [0,MAXLEN]
  1526. DESCRIPTION: The string of X blank spaces.
  1527. ------------------------------------------------------------
  1528. SYNTAX: S$ = SPC( X )
  1529. PARAMETER: X is a number
  1530. DESCRIPTION: The string of X spaces. Only for use within
  1531. the PRINT command.
  1532. ------------------------------------------------------------
  1533. SYNTAX: N = SQR( X )
  1534. PARAMETER: X is a number, >= 0
  1535. DESCRIPTION: The non-negative square root of X; X shall be
  1536. non-negative.
  1537. ------------------------------------------------------------
  1538. SYNTAX: S$ = STR$( X )
  1539. PARAMETER: X is a number
  1540. DESCRIPTION: The string generated by the print-statement as
  1541. the numeric-representation of the value
  1542. associated with X.
  1543. ------------------------------------------------------------
  1544. SYNTAX: S$ = STRING$( X, A$ )
  1545. PARAMETER: X is a number, [0,MAXLEN]
  1546. PARAMETER: A$ is a string, LEN >= 1
  1547. DESCRIPTION: The string X bytes long consisting of the
  1548. first character of A$.
  1549. ------------------------------------------------------------
  1550. SYNTAX: S$ = STRING$( X, Y )
  1551. PARAMETER: X is a number, [0,MAXLEN]
  1552. PARAMETER: Y is a number, [0,255]
  1553. DESCRIPTION: The string X bytes long consisting of CHR$(Y).
  1554. ------------------------------------------------------------
  1555. SYNTAX: S$ = STRIP$( A$ )
  1556. PARAMETER: A$ is a string, LEN >= 0
  1557. DESCRIPTION: Return the string with the eighth bit of each
  1558. character cleared.
  1559. ------------------------------------------------------------
  1560. SYNTAX: S$ = TAB( X )
  1561. PARAMETER: X is a number
  1562. DESCRIPTION: The string required to advance to column X.
  1563. Only for use within the PRINT command.
  1564. ------------------------------------------------------------
  1565. SYNTAX: N = TAN( X )
  1566. PARAMETER: X is a number
  1567. DESCRIPTION: The tangent of X, where X is in radians.
  1568. ------------------------------------------------------------
  1569. SYNTAX: N = TIME
  1570. DESCRIPTION: The time elapsed since the previous midnight,
  1571. expressed in seconds; e.g., the value of TIME
  1572. at 11:15 AM is 40500. If there is no clock
  1573. available, then the value of TIME shall be
  1574. -1. The value of TIME at midnight shall be
  1575. zero (not 86400).
  1576. ------------------------------------------------------------
  1577. SYNTAX: S$ = TIME$
  1578. DESCRIPTION: The time of day in 24-hour notation according
  1579. to ISO 3307. For example, the value of TIME$
  1580. at 11:15 AM is "11:15:00". If there is no
  1581. clock available, then the value of TIME$
  1582. shall be "99:99:99". The value of TIME$ at
  1583. midnight is "00:00:00".
  1584. ------------------------------------------------------------
  1585. SYNTAX: N = TIMER
  1586. DESCRIPTION: The time in the system clock in seconds
  1587. elapsed since midnight.
  1588. ------------------------------------------------------------
  1589. SYNTAX: N = TROFF
  1590. DESCRIPTION: Turn tracing OFF
  1591. ------------------------------------------------------------
  1592. SYNTAX: N = TRON
  1593. DESCRIPTION: Turn tracing ON
  1594. ------------------------------------------------------------
  1595. SYNTAX: N = TRUE
  1596. DESCRIPTION: The value of TRUE.
  1597. ------------------------------------------------------------
  1598. SYNTAX: S$ = UCASE$( A$ )
  1599. PARAMETER: A$ is a string, LEN >= 0
  1600. DESCRIPTION: The string of characters resulting from the
  1601. value associated with A$ by replacing each
  1602. lower-case-letter in the string by its
  1603. upper-case version.
  1604. ------------------------------------------------------------
  1605. SYNTAX: N = UNLOCK( X )
  1606. PARAMETER: X is a number, [MININT,MAXINT]
  1607. DESCRIPTION: Unlock file number X. Causes ERROR 73.
  1608. ------------------------------------------------------------
  1609. SYNTAX: S$ = UPPER$( A$ )
  1610. PARAMETER: A$ is a string, LEN >= 0
  1611. DESCRIPTION: The string of characters resulting from the
  1612. value associated with A$ by replacing each
  1613. lower-case-letter in the string by its
  1614. upper-case version.
  1615. ------------------------------------------------------------
  1616. SYNTAX: N = VAL( A$ )
  1617. PARAMETER: A$ is a string, LEN >= 1
  1618. DESCRIPTION: The value of the numeric-constant associated
  1619. with A$, if the string associated with A$ is
  1620. a numeric-constant. Leading and trailing
  1621. spaces in the string are ignored. If the
  1622. evaluation of the numeric-constant would
  1623. result in a value which causes an underflow,
  1624. then the value returned shall be zero. For
  1625. example, VAL( " 123.5 " ) = 123.5, VAL(
  1626. "2.E-99" ) could be zero, and VAL( "MCMXVII"
  1627. ) causes an exception.
  1628. ------------------------------------------------------------
  1629. SYNTAX: N = WAIT( X, Y )
  1630. PARAMETER: X is a number, [MININT,MAXINT]
  1631. PARAMETER: Y is a number, [0,255]
  1632. DESCRIPTION: Waits for the value of (INP(X) AND Y) to
  1633. become nonzero. Causes ERROR 73.
  1634. ------------------------------------------------------------
  1635. SYNTAX: N = WAIT( X, Y, Z )
  1636. PARAMETER: X is a number, [MININT,MAXINT]
  1637. PARAMETER: Y is a number, [0,255]
  1638. PARAMETER: Z is a number, [0,255]
  1639. DESCRIPTION: Waits for the value of ((INP(X) XOR Z) AND Y)
  1640. to become nonzero. Causes ERROR 73.
  1641. ------------------------------------------------------------
  1642. SYNTAX: N = WIDTH( X )
  1643. PARAMETER: X is a number, [0,255]
  1644. DESCRIPTION: For console, sets the line width to X. Zero
  1645. means no wrapping will occur.
  1646. ------------------------------------------------------------
  1647. SYNTAX: N = WIDTH( X, Y )
  1648. PARAMETER: X is a number, [MININT,MAXINT]
  1649. PARAMETER: Y is a number, [0,255]
  1650. DESCRIPTION: If X = 0, sets the console width to Y.
  1651. If X < 0, sets the printer width to Y.
  1652. If X is an open file number, sets the file
  1653. line width to Y.
  1654. Otherwise sets the console rows to X and the
  1655. line width to Y.
  1656. A value of zero for Y means no wrapping will
  1657. occur.
  1658. ------------------------------------------------------------
  1659. SYNTAX: N = ZONE( X )
  1660. PARAMETER: X is a number, [MININT,MAXINT]
  1661. DESCRIPTION: Sets the width of the print zones.
  1662. ------------------------------------------------------------
  1663. SYNTAX: N = ZONE( X, Y )
  1664. PARAMETER: X is a number, [MININT,MAXINT]
  1665. PARAMETER: Y is a number, [MININT,MAXINT]
  1666. DESCRIPTION: X is ignored. Y sets the width of the print
  1667. zones.
  1668. ------------------------------------------------------------
  1669. ============================================================
  1670. OPERATORS
  1671. ============================================================
  1672. ------------------------------------------------------------
  1673. SYNTAX: X ^ Y
  1674. DESCRIPTION: Exponential
  1675. PRECEDENCE: 14
  1676. ------------------------------------------------------------
  1677. SYNTAX: # X
  1678. DESCRIPTION: Posation
  1679. PRECEDENCE: 13
  1680. ------------------------------------------------------------
  1681. SYNTAX: + X
  1682. DESCRIPTION: Posation
  1683. PRECEDENCE: 13
  1684. ------------------------------------------------------------
  1685. SYNTAX: - X
  1686. DESCRIPTION: Negation
  1687. PRECEDENCE: 13
  1688. ------------------------------------------------------------
  1689. SYNTAX: X * Y
  1690. DESCRIPTION: Multiplication
  1691. PRECEDENCE: 12
  1692. ------------------------------------------------------------
  1693. SYNTAX: X / Y
  1694. DESCRIPTION: Division
  1695. PRECEDENCE: 12
  1696. ------------------------------------------------------------
  1697. SYNTAX: X \ Y
  1698. DESCRIPTION: Integer Division
  1699. PRECEDENCE: 11
  1700. ------------------------------------------------------------
  1701. SYNTAX: X MOD Y
  1702. DESCRIPTION: Integer Modulus
  1703. PRECEDENCE: 10
  1704. ------------------------------------------------------------
  1705. SYNTAX: X + Y
  1706. DESCRIPTION: Addition
  1707. PRECEDENCE: 9
  1708. ------------------------------------------------------------
  1709. SYNTAX: X - Y
  1710. DESCRIPTION: Subtraction
  1711. PRECEDENCE: 9
  1712. ------------------------------------------------------------
  1713. SYNTAX: X < Y
  1714. DESCRIPTION: Less than
  1715. PRECEDENCE: 7
  1716. ------------------------------------------------------------
  1717. SYNTAX: X <= Y
  1718. DESCRIPTION: Less than or Equal
  1719. PRECEDENCE: 7
  1720. ------------------------------------------------------------
  1721. SYNTAX: X <> Y
  1722. DESCRIPTION: Not Equal
  1723. PRECEDENCE: 7
  1724. ------------------------------------------------------------
  1725. SYNTAX: X = Y
  1726. DESCRIPTION: Equal
  1727. PRECEDENCE: 7
  1728. ------------------------------------------------------------
  1729. SYNTAX: X =< Y
  1730. DESCRIPTION: Less than or Equal
  1731. PRECEDENCE: 7
  1732. ------------------------------------------------------------
  1733. SYNTAX: X => Y
  1734. DESCRIPTION: Greater than or Equal
  1735. PRECEDENCE: 7
  1736. ------------------------------------------------------------
  1737. SYNTAX: X > Y
  1738. DESCRIPTION: Greater than
  1739. PRECEDENCE: 7
  1740. ------------------------------------------------------------
  1741. SYNTAX: X >< Y
  1742. DESCRIPTION: Not Equal
  1743. PRECEDENCE: 7
  1744. ------------------------------------------------------------
  1745. SYNTAX: X >= Y
  1746. DESCRIPTION: Greater than or Equal
  1747. PRECEDENCE: 7
  1748. ------------------------------------------------------------
  1749. SYNTAX: NOT X
  1750. DESCRIPTION: Bitwise NOT
  1751. PRECEDENCE: 6
  1752. ------------------------------------------------------------
  1753. SYNTAX: X AND Y
  1754. DESCRIPTION: Bitwise AND
  1755. PRECEDENCE: 5
  1756. ------------------------------------------------------------
  1757. SYNTAX: X OR Y
  1758. DESCRIPTION: Bitwise OR
  1759. PRECEDENCE: 4
  1760. ------------------------------------------------------------
  1761. SYNTAX: X XOR Y
  1762. DESCRIPTION: Bitwise Exclusive OR
  1763. PRECEDENCE: 3
  1764. ------------------------------------------------------------
  1765. SYNTAX: X EQV Y
  1766. DESCRIPTION: Bitwise EQV
  1767. PRECEDENCE: 2
  1768. ------------------------------------------------------------
  1769. SYNTAX: X IMP Y
  1770. DESCRIPTION: Bitwise IMP
  1771. PRECEDENCE: 1
  1772. ------------------------------------------------------------