ScriptBasic:UsersGuide

From ScriptBasic

Jump to: navigation, search

ScriptBasic Users Guide

by Peter Verhas

Table of Contents

1. Introduction

2. Using ScriptBasic

2.1. Running from command line

2.2. Running CGI programs

2.3. Writing CGI programs

3. Installation Instructions

3.1. Installation under Windows

3.1.1. Installation under Windows from source

3.2. Installation under Linux

3.3. Installation under other Unices

3.4. Configuration

3.5. Configuration file location under Windows NT

3.6. Configuration file location under UNIX

3.7. Overriding the default configuration file

3.8. Trouble shooting installation

4. Code caching

4.1. How cache file name is calculated

4.2. Cache handling shortages

4.3. Cache security

5. Compiling BASIC programs

5.1. Binary format of the BASIC code

6. Compiling BASIC program to EXE

6.1. BASIC to EXE compilation technical details

7. Compiling BASIC programs to C

7.1. Compilation under Windows NT

7.2. Compilation under UNIX

8. Compiling ScriptBasic with modules

9. General Language Format

9.1. Hello World

9.6. Forcing Variable Declaration

9.7.1. Creating arrays

9.7.2. Array index limits

9.7.3. Deleting an array

9.8. Associative Arrays

9.8.1. Notes for using associative arrays

9.9. Using Array Mixed Mode

9.10. Expressions

9.10.1. Operators

9.10.1.1. Power operator (^)

9.10.1.2. Multiplication operator (*)

9.10.1.3. Division operator (/)

9.10.1.4. Integer division operator (\)

9.10.1.5. Modulus operator (%)

9.10.1.6. Addition and subtraction operators (+, -)

9.10.1.7. Bit-wise and logical NOT (NOT)

9.10.1.8. Equality operator (=)

9.10.1.9. Not equal operator (<>)

9.10.1.10. Compare operators (<, <=, >, >=)

9.10.1.11. Logical operators (and, or, xor)

9.10.1.12. Concatenation operator (&)

9.10.1.13. ByVal operator

9.10.1.14. LIKE operator

9.10.1.15. Extension operators

9.10.1.16. Planned, Future Operators

9.11. Assignments (LET)

9.12. Operator Assignments

9.14. Including Files

9.15. Internal preprocessors

9.16. Using external preprocessor

9.17. #! /usr/bin/scriba

9.18. @goto start

10. Interacting with the user

10.3. Handling command line arguments

11. Name spaces

12. File Handling

12.1. Opening and creating files

12.2. Text and binary files

12.3. Switching between binary and text mode

12.4. Getting a free file number

12.5. Positioning in a file

12.6. Reading and writing files

12.7. Getting and setting the current working directory

12.8. Locking a file

12.9. Locking file range

12.10. Truncating a file

12.11. Deleting a file or directory

12.12. Creating a directory

12.13. Setting file parameters

12.14. Listing files

12.14.1. Open directory

12.14.2. Function NextFile

12.14.3. Function EOD

12.14.4. Reset directory

12.14.5. Close directory

13.1. Opening a Socket

13.2. Getting the host name

14. String handling commands

14.1. Split and splita

15. Conditional Execution

16. The statement GOTO

17. Loop constructs

18. Functions and Subroutines

18.1. Declaration of subroutines and function

18.2. Calling functions and subroutines

18.3. Returning a value

18.4. Local and global variables

18.5. More on local and global variables

18.6. Parameters passed by value and by reference

18.7. ByVal command

18.8. Calling functions indirectly

18.9. GOSUB and RETURN

19. Reference Variables

20. Pattern matching

20.1. The operator LIKE

20.2. The function JOKER

20.3. Escaping wild cards

20.4. Ambiguous matching

20.5. Advanced matching

21. Handling run-time errors

21.1. On error goto

21.4. Levels of error handling

21.5. Error codes

22. Setting options

23. Other miscellaneous commands

24. Using External modules

25. Command reference

25.3. ACOSECANT

25.7. ADDMINUTE

25.9. ADDRESS( myFunc() )

25.10. ADDSECOND

25.13. ASC(string)

25.18. BINMODE [ # fn ] | input | output

25.19. CALL subroutine

25.20. CHDIR directory

25.22. CHR(code)

25.23. CLOSE [ # ] fn

25.24. CLOSE DIRECTORY [#] dn

25.25. COMMAND()

25.26. Concatenate operator &

25.27. CONF("conf.key")

25.29. COSECANT

25.32. CRYPT(string,salt)

25.33. CURDIR()

25.35. DECLARE COMMAND function ALIAS cfun LIB library

25.35.1. DECLARECOMMAND Details

25.36. DECLARE SUB function ALIAS cfun LIB library

25.36.1. DECLARESUB Details

25.37. DELETE file/directory_name

25.38. DELTREE file/directory_name

25.40. DO UNTIL condition

25.41. DO WHILE condition

25.43. ENVIRON("envsymbol") or ENVIRON(n)

25.43.1. ENVIRON Details

25.46. ERROR() or ERROR n

25.47. ERROR$() or ERROR$(n)

25.49. EXECUTE("executable_program", time_out,pid_v)

25.49.1. EXECUTE Details

25.50. EXIT FUNCTION

25.51. EXIT SUB

25.54. FILEACCESSTIME(file_name)

25.55. FILECOPY filename,filename

25.56. FILECREATETIME(file_name)

25.57. FILEEXISTS(file_name)

25.58. FILELEN(file_name)

25.59. FILEMODIFYTIME(file_name)

25.61. LOCK # fn, mode

25.62. FOR var=exp_start TO exp_stop [ STEP exp_step ]

25.64. FORMAT()

25.65. FORMATDATE

25.65.1. FORMATDATE Details

25.66. FILEOWNER(FileName)

25.68. FREEFILE()

25.69. FUNCTION fun()

25.69.1. FUNCTION Details

25.71. GMTOLOCALTIME

25.72. GOSUB label

25.73. GOTO label

25.75. HCOSECANT

25.78. HOSTNAME()

25.83. ICALL n,v1,v2, ... ,vn

25.83.1. ICALL Details

25.84. IF condition THEN

25.85. INPUT(n,fn)

25.86. INSTR(base_string,search_string [ ,position ] )

25.87. INSTRREV(base_string,search_string [ ,position ] )

25.91. ISDIRECTORY(file_name)

25.93. ISINTEGER

25.94. ISNUMERIC

25.96. ISFILE(file_name)

25.97. ISSTRING

25.99. JOIN(joiner,str1,str2,...)

25.99.1. JOIN Details

25.100. JOKER(n)

25.100.1. JOKER Details

25.101. KILL(pid)

25.103. LCASE()

25.104. LEFT(string,len)

25.104.1. LEFT Details

25.106. v = expression

25.107. v &= expression

25.108. v /= expression

25.109. v \= expression

25.110. v -= expression

25.111. v += expression

25.112. v *= expression

25.113. string LIKE pattern

25.113.1. LIKE Details

25.114. LINE INPUT

25.116. LOCATLTOGMTIME

25.117. LOCK REGION # fn FROM start TO end FOR mode

25.121. LTRIM()

25.122. MID(string,start [ ,len ])]

25.122.1. MID Details

25.124. MKDIR directory_name

25.126. NAME filename,filename

25.127. NEXTFILE(dn)

25.131. ON ERROR GOTO [ label | NULL ]

25.132. ON ERROR RESUME [ label | next ]

25.133. OPEN file_name FOR mode AS [ # ] i [ LEN=record_length ]

25.134. OPEN DIRECTORY dir_name PATTERN pattern OPTION option AS dn

25.135. OPTION symbol value

25.136. OPTION("symbol")

25.137. pack("format",v1,v2,...,vn)

25.140. PRINT [ # fn , ] print_list

25.141. RANDOMIZE

25.142. ref v1 = v2

25.144. REPLACE(base_string,search_string,replace_string [,number_of_replaces] [,position])

25.146. RESET DIRECTORY [#] dn

25.147. RESUME [ label | next ]

25.149. REWIND [ # ]fn

25.150. RIGHT(string,len)

25.150.1. RIGHT Details

25.153. RTRIM()

25.156. SEEK fn,position

25.157. SET FILE filename parameter=value

25.158. SET JOKER "c" TO "abcdefgh..."

25.159. SET WILD "c" TO "abcdefgh..."

25.161. SLEEP(n)

25.162. SPACE(n)

25.163. SPLIT string BY string TO var_1,var_2,var_3,...,var_n

25.164. SPLITA string BY string TO array

25.167.1. STR Details

25.168. STRING(n,code)

25.169. STRREVERSE(string)

25.170. SUB fun()

25.171. SYSTEM(executable_program)

25.174. TEXTMODE [ # fn] | input | output

25.175. TIMEVALUE

25.178. TRUNCATE fn,new_length

25.181. UCASE()

25.182. UNDEF variable

25.182.1. UNDEF Details

25.183. UNPACK string BY format TO v1,v2,...,vn

25.185. WEEKDAY

25.186. WHILE condition

25.188. YEARDAY

Retrieved from "http://www.scriptbasic.org/wiki/index.php?title=ScriptBasic:UsersGuide"

Personal tools

Log in

Toolbox