Document Outline

• Changes in this Version
• About the Title, De Re BASIC!
• About the Cover Art
• Credits
• Technical Editor
• Getting BASIC!
• BASIC! Forum
• BASIC! Tutorial
• BASIC! Operation
  • Permissions
  • Editor
    • Editing the Program
    • Multiple Commands on a Line
    • Line Continuation
    • # - Format Line
    • Menus
      • Run
      • Load
      • Save
      • Clear
      • Search
        • Next Button
        • Replace Button
        • Replace All Button
        • Done Button
        • BACK Key
      • Load and Run
      • Save and Run
      • Format
      • Delete
      • Preferences
        • Screen Colors
        • Color Scheme
        • Custom Colors
        • Console Settings
        • Font Size
        • Typeface
        • Console Menu
        • Console Lines
        • Empty Console Color
        • Editor Settings
        • Editor Lines
        • Editor Line Wrap
        • Editor AutoIndent
        • Menu Items on Action Bar
        • RUN on action bar
        • LOAD on action bar
        • SAVE on action bar
        • EXIT on action bar
        • Screen Orientation
        • Graphic Acceleration
        • Base Drive
      • Commands
      • About
        • BASIC! Home Page
        • BASIC! User Forum
        • þÿ
        • BASIC! on Bintray
        • BASIC! on GitHub
        • BASIC! Open-Source License
        • BASIC! Privacy Policy
      • Exit
  • Run
    • Menu
      • Stop
      • Editor
  • Crashes
• A BASIC! Program
• Command Description Syntax
  • Upper and Lower Case
  • , and
  • , and
  • Array[] and Array$[]
  • Array[{,}] and Array$[{,}]
  • {something}
  • { A | B |C }
  • X, ...
  • {,n} ...
  • Optional Parameters
• Numbers
• Strings
• Variables
  • Variable Names
  • Variable Types
  • Scalar and Array Variables
  • Scalars
  • Arrays
    • Array Segments
    • Array Commands
      • Dim Array[{, } ... ] {, Array[{, } ... ] } ...
      • UnDim Array[]{, Array[] } ...
      • Array.average , Array[{,}]
      • Array.copy SourceArray[{,}], DestinationArray[{{-}}]
      • Array.delete Array[]{, Array[]} ...
      • Array.dims Source[]{, {Dims[]}{, NumDims}}
      • Array.fill Array[{,}],
      • Array.length , Array[{,}]
      • Array.load Array[], , ...
      • Array.max Array[{,}]
      • Array.min , Array[{,}]
      • Array.reverse Array[{,}]
      • Array.search Array[{,}], , {,}
      • Array.shuffle Array[{,}]}
      • Array.sort Array[{,}]}
      • Array.std_dev , Array[{,}]}
      • Array.sum , Array[{,}]
      • Array.variance , Array[{,}]
• Data Structures and Pointers in BASIC!
  • What is a Pointer
  • Lists
    • List Commands
      • List.create N|S,
      • List.add {, }...
      • List.add.list ,
      • List.add.array , Array[{,}]
      • List.replace , , |
      • List.insert , , |
      • List.remove ,
      • List.get , ,
      • List.type ,
      • List.size ,
      • List.clear
      • List.search , value|value$, {,}
      • List.toArray , Array$[] | Array[]
  • Bundles
    • Bundle Auto-Create
    • Bundle Commands
      • Bundle.create
      • Bundle.put , , |
      • Bundle.get , , |
      • Bundle.keys ,
      • Bundle.contain , ,
      • Bundle.type , ,
      • Bundle.remove ,
      • Bundle.clear
  • Stacks
    • Stack Commands
      • Stack.create N|S,
      • Stack.push , |
      • Stack.pop , |
      • Stack.peek , |
      • Stack.type ,
      • Stack.isEmpty ,
      • Stack.clear
  • Queues
• Comments
  • ! - Single Line Comment
  • Rem - Single Line Comment (legacy)
  • !! - Block Comment
  • % - Middle of Line Comment
• Expressions
  • Numeric Expression
    • Numeric Operators
    • Numeric Expression Examples
    • Pre- and Post-Increment Operators
  • String Expression
  • Logical Expression
    • Logical Operators
    • Examples of Logical Expressions
  • Parentheses
• Assignment Operations
  • Let
  • OpEqual Assignment Operations
• Math Functions
  • BOR(, )
  • BAND(, )
  • BXOR(, )
  • BNOT()
  • ABS()
  • SGN()
  • RANDOMIZE({})
  • RND()
  • MAX(, )
  • MIN(, )
  • CEIL()
  • FLOOR()
  • INT()
  • FRAC()
  • MOD(, )
  • ROUND({, {, }})
  • SQR()
  • CBRT()
  • LOG()
  • LOG10()
  • EXP()
  • POW(, )
  • HYPOT(,
  • PI()
  • SIN()
  • COS()
  • TAN()
  • SINH()
  • COSH()
  • ASIN()
  • ACOS()
  • ATAN()
  • ATAN2(, )
  • TODEGREES()
  • TORADIANS()
  • VAL()
  • IS_NUMBER()
  • LEN()
  • HEX()
  • OCT()
  • BIN()
  • SHIFT(, )
  • ASCII({, })
  • UCODE({, })
  • IS_IN(, {, })
  • STARTS_WITH(, {, })
  • ENDS_WITH(, )
  • GR_COLLISION(, )
  • BACKGROUND()
• Time Functions
  • CLOCK()
  • TIME()
  • TIME(, , , , , )
• String Functions
  • GETERROR$()
  • CHR$(, ...)
  • LEFT$(, )
  • MID$(, {, })
  • RIGHT$(, )
  • REPLACE$(, , )
  • TRIM$({, })
  • LTRIM$({, })
  • RTRIM$({, })
  • WORD$(, {, })
  • ENCODE$(, {}, )
  • DECODE$(, {}, )
  • ENCODE$(, )
  • DECODE$(, )
  • STR$()
  • LOWER$()
  • UPPER$()
  • VERSION$()
  • INT$()
  • HEX$()
  • OCT$()
  • BIN$()
  • USING$({} , { , }...)
    • Locale expression
    • Format expression
      • Format Specifiers
      • Optional Modifiers
      • Index
      • Flags
      • Width
      • Precision
    • Integer values
  • FORMAT_USING$(, { , }...)
  • FORMAT$(, )
    • Notes
    • Examples
• User-Defined Functions
  • Variable Scope
  • Data Structures in User-Defined Functions
  • Commands
    • Fn.def name|name$( {nvar}|{svar}|Array[]|Array$[], ... {nvar}|{svar}|Array[]|Array$[])
    • Fn.rtn |
    • Fn.end
    • Call
• Program Control Commands
  • If / Then / Else / Elseif / Endif
  • If / Then / Else
  • For - To - Step / Next
  • F_N.continue
  • F_N.break
  • While / Repeat
  • W_R.continue
  • W_R.break
  • Do / Until
  • D_U.continue
  • D_U.break
  • Labels, GOTO, GOSUB, and RETURN: Traditional BASIC
    • Label
    • GoTo
    • GoTo , ...
    • GoSub / Return
    • GoSub , ... / Return
  • Using Source Code from Multiple Files
    • Include FilePath
    • Run {, }
    • Program.info |
  • Switch Commands
    • Nesting Switch Operations
    • Sw.begin
    • Sw.case , ...
    • Sw.case
    • Sw.break
    • Sw.default
    • Sw.end
  • Interrupt Labels (Event Handlers)
    • All Interrupt Labels
    • OnError:
    • OnConsoleTouch:
    • ConsoleTouch.resume
    • OnBackKey:
    • Back.resume
    • OnMenuKey:
    • MenuKey.resume
    • OnKeyPress:
    • Key.resume
    • OnLowMemory:
    • LowMemory.resume
  • End{ }
  • Exit
• þÿ
  • Read.data |{,|...,|}
  • Read.next , ...
  • Read.from
• Debug Commands
  • Debug.on
  • Debug.off
  • Debug.echo.on
  • Echo.on
  • Debug.echo.off
  • Echo.off
  • Debug.print
  • Debug.dump.scalars
  • Debug.dump.array Array[]
  • Debug.dump.bundle
  • Debug.dump.list
  • Debug.dump.stack
  • Debug.show.scalars
  • Debug.show.array Array[]
  • Debug.show.bundle
  • Debug.show.list
  • Debug.show.stack
  • Debug.watch var, ...
  • Debug.show.watch
  • Debug.show.program
  • Debug.show
• Fonts
  • Font.load ,
  • Font.delete {}
  • Font.clear
• Console I/O
  • Output Console
    • Print { {,|;}} ...
    • ? { {,|;}} ...
    • Print with User-Defined Functions
    • Cls
    • Console.front
    • Console.line.count
    • Console.line.text ,
    • Console.line.touched {, }
    • Console.save
    • Console.title { }
  • User Input and Interaction
    • Dialog.message {}, {}, {, {, {, }}}
    • Dialog.select , | {,}
    • Input {}, {, {}{, }}
    • Inkey$
    • Popup {{, }{, }{, }}
    • Select , | {, {, } } {, }
    • Text.input {, { } , }
    • TGet , {, }
    • Kb.hide
    • Kb.show
    • Kb.toggle
    • Kb.showing
    • OnKbChange:
    • Kb.resume
    • The Soft Keyboard and the BACK Key
• Working with Files
  • þÿ
  • Paths in BASIC!
  • Paths Outside of BASIC!
  • Paths and Case-sensitivity
  • Mark and Mark Limit
• File Commands
  • File.delete ,
  • File.dir , Array$[] {,}
  • File.exists ,
  • File.mkdir
  • File.rename ,
  • File.root
  • File.size ,
  • File.type ,
• Text File I/O
  • Text.open {r|w|a}, ,
  • Text.close
  • Text.readln {,}...
  • Text.writeln ,
  • Text.eof ,
  • Text.position.get ,
  • Text.position.set ,
  • Text.position.mark {{}{, }}
  • GrabURL , {, }
  • GrabFile , {, }
• Byte File I/O
  • Byte.open {r|w|a}, ,
  • Byte.close
  • Byte.read.byte {,}...
  • Byte.write.byte {{,}...{,}}
  • Byte.read.number {,...}
  • Byte.write.number {,}...
  • Byte.read.buffer , ,
  • Byte.write.buffer ,
  • Byte.eof ,
  • Byte.position.get ,
  • Byte.position.set ,
  • Byte.position.mark {{}{, }}
  • Byte.truncate ,
  • Byte.copy ,
• ZIP File I/O
  • Zip.count ,
  • Zip.dir , Array$[] {,}
  • Zip.open {r|w|a}, ,
  • Zip.close
  • Zip.read ,,
  • Zip.write ,,
• HTML
  • Introduction
  • HTML Commands
    • Html.open { {, }}
    • Html.orientation
    • Html.load.url
    • Html.load.string
    • Html.post ,
    • Html.get.datalink
    • Html.go.back
    • Html.go.forward
    • Html.close
    • Html.clear.cache
    • Html.clear.history
  • Related Commands
    • Browse
    • Http.post , ,
• TCP/IP Sockets
  • TCP/IP Client Socket Commands
    • Socket.client.connect , { , }
    • Socket.client.status
    • Socket.client.server.ip
    • Socket.client.read.line
    • Socket.client.read.ready
    • Socket.client.read.file
    • Socket.client.write.line
    • Socket.client.write.bytes
    • Socket.client.write.file
    • Socket.client.close
  • TCP/IP Server Socket Commands
    • Socket.myIP
    • Socket.myIP {, }
    • Socket.server.create
    • Socket.server.connect {}
    • Socket.server.status
    • Socket.server.read.line
    • Socket.server.read.ready
    • Socket.server.write.line
    • Socket.server.write.bytes
    • Socket.server.write.file
    • Socket.server.read.file
    • Socket.server.disconnect
    • Socket.server.close
    • Socket.server.client.ip
• FTP Client
  • Ftp.open , , ,
  • Ftp.close
  • Ftp.put ,
  • Ftp.get ,
  • Ftp.dir {,}
  • Ftp.cd
  • Ftp.rename ,
  • Ftp.delete
  • Ftp.rmdir
  • Ftp.mkdir
• Bluetooth
  • Bt.open {0|1}
  • Bt.close
  • Bt.connect {0|1}
  • Bt.disconnect
  • Bt.reconnect
  • Bt.status {{}{, }{, }}
  • Bt.write { {,|;}} ...
  • Bt.read.ready
  • OnBtReadReady:
    • Bt.onReadReady.resume
  • Bt.read.bytes
  • Bt.device.name
  • Bt.set.UUID
• Communication: Phone and Text
  • Email.send , ,
  • MyPhoneNumber
  • Phone.call
  • Phone.dial
  • Phone.rcv.init
  • Phone.rcv.next ,
  • Sms.send ,
  • Sms.rcv.init
  • Sms.rcv.next
• Time and Timers
  • Time and TimeZone Commands
    • Time {,} Year$, Month$, Day$, Hour$, Minute$, Second$, WeekDay, isDST
    • TimeZone.set { }
    • TimeZone.get
    • TimeZone.list
  • Timer Interrupt and Commands
    • Timer.set
    • OnTimer:
    • Timer.resume
    • Timer.clear
    • Sample Code
• Clipboard
  • Clipboard.get
  • Clipboard.put
• Encryption
  • Encrypt {}, ,
  • Decrypt , ,
• Ringer
  • Ringer.get.mode
  • Ringer.set.mode
  • Ringer.get.volume { , }
  • Ringer.set.volume
• String Operations
  • Join , {, {,
  • Join.all , {, {,
  • Split , {, }
  • Split.all , {, }
• Speech Conversion
  • Text To Speech
    • TTS.init
    • TTS.speak {, }
    • TTS.speak.toFile {, }
    • TTS.stop
  • Speech To Text (Voice Recognition)
    • STT.listen {}
      • Console Mode
      • Graphics Mode
      • HTML Mode
• Information About Your Android Device
  • Device Command Overview
    • Device
    • Device |
    • Device.Language
    • Device. Locale
  • Phone.info |
  • Screen rotation, size[], realsize[], density
  • Screen.rotation
  • Screen.size, size[], realsize[], density
  • WiFi.info {{}{, }{, }{, }{, }}
• Running in the Background
  • Home
  • OnBackground:
    • Background.resume
  • WakeLock {, }
  • WifiLock
• Miscellaneous Commands
  • Headset , ,
  • Notify , , ,
  • Pause
  • Swap |, |
  • Tone , {,
  • Vibrate ,}]>,
  • VolKeys
    • VolKeys.off
    • VolKeys.on
• SQLITE
  • Overview
  • SQLITE Commands
    • Sql.open ,
    • Sql.close
    • Sql.new_table , , C1$, C2$, ...,CN$
    • Sql.drop_table ,
    • Sql.insert , , C1$, V1$, C2$, V2$, ..., CN$, VN$
    • Sql.query , , , {, {, } }
    • Sql.query.length ,
    • Sql.query.position ,
    • Sql.next , {, }
    • Sql.delete , {,{,} }
    • Sql.update , , C1$, V1$, C2$, V2$,...,CN$, VN${: }
    • Sql.exec ,
    • Sql.raw_query , ,
• Graphics
  • Introduction
    • The Graphics Screen and Graphics Mode
    • Display Lists
    • Drawing Coordinates
    • Drawing into Bitmaps
    • Colors
    • Paints
      • Basic usage
      • Advanced usage
    • Style
      • STROKE
      • FILL
      • STROKE and FILL
    • Hardware-accelerated Graphics
  • Graphics Setup Commands
    • Gr.open {{alpha}{, red}{, green}{, blue}{, }{, }}
    • Gr.color {{alpha}{, red}{, green}{, blue}{, style}{, paint}}
    • Gr.set.antialias {{}{,}}
    • Gr.set.stroke {{}{,}}
    • Gr.orientation
    • Gr.statusbar {} {, showing_lvar}
    • Gr.statusbar.show
    • Gr.render
    • Gr.screen width, height{, density }
    • Gr.scale x_factor, y_factor
    • Gr.cls
    • Gr.close
    • Gr.front flag
    • Gr.brightness
  • Graphical Object Creation Commands
    • Gr.point , x, y
    • Gr.line , x1, y1, x2, y2
    • Gr.rect , left, top, right, bottom
    • Gr.oval , left, top, right, bottom
    • Gr.arc , left, top, right, bottom, start_angle, sweep_angle, fill_mode
    • Gr.circle , x, y, radius
    • Gr.set.pixels , pixels[{,}] {,x,y}
    • Gr.poly , list_pointer {,x, y}
  • Groups
    • Gr.group {, }...
    • Gr.group.list ,
    • Gr.group.getDL
    • Gr.group.newDL
  • Hide and Show Commands
    • Gr.hide
    • Gr.show
    • Gr.show.toggle
  • Touch Query Commands
    • Gr.touch touched, x, y
    • Gr.bounded.touch touched, left, top, right, bottom
    • Gr.touch2 touched, x, y
    • Gr.bounded.touch2 touched, left, top, right, bottom
    • OnGrTouch:
    • Gr.onGrTouch.resume
  • Text Commands
    • Overview
    • Gr.text.align {{}{,}}
    • Gr.text.bold {{}{,}}
    • Gr.text.size {{}{,}}
    • Gr.text.skew {{}{,}}
    • Gr.text.strike {{}{,}}
    • Gr.text.underline {{}{,}}
    • Gr.text.setfont {{|} {, } {,}}
    • Gr.text.typeface {{} {, } {,}}
    • Gr.text.height {} {, } {, }
    • Gr.text.width ,
    • Gr.get.textbounds , left, top, right, bottom
    • Gr.text.draw , , ,
  • Bitmap Commands
    • Overview
    • Gr.bitmap.create , width, height
    • Gr.bitmap.load ,
    • Gr.bitmap.size , width, height
    • Gr.bitmap.scale , , width, height {, }
    • Gr.bitmap.delete
    • Gr.bitmap.crop , , , , ,
    • Gr.bitmap.save , {, }
    • Gr.bitmap.draw , , x , y
    • Gr.get.bmpixel , x, y, alpha, red, green, blue
    • Gr.bitmap.fill , ,
    • Gr.bitmap.drawinto.start
    • Gr.bitmap.drawinto.end
  • Paint Commands
    • Gr.paint.copy {{}{, }}
    • Gr.paint.get
    • Gr.paint.reset {}
  • Rotate Commands
    • Gr.rotate.start angle, x, y{,}
    • Gr.rotate.end {}
  • Camera Commands
    • Gr.camera.select 1|2
    • Gr.camera.shoot
    • Gr.camera.autoshoot {, {, focus_mode_nexp} }
    • Gr.camera.manualShoot {, {, focus_mode_nexp} }
  • Other Graphics Commands
    • Gr.screen.to_bitmap
    • Gr.get.pixel x, y, alpha, red, green, blue
    • Gr.save {,}
    • Gr.get.type ,
    • Gr.get.params ,
    • Gr.get.position , x, y
    • Gr.move {{, dx}{, dy}}
    • Gr.get.value {, , }...
    • Gr.modify {, , }...
      • General Purpose Parameters
    • GR_COLLISION(, )
    • Gr.clip , , , , {, }
    • Gr.newDL ,}]>
    • Gr.getDL {, }
• Audio Interface
  • Introduction
    • The Audio Interface
    • Audio File Types
  • Commands
    • Audio.load ,
    • Audio.play
    • Audio.stop
    • Audio.pause
    • Audio.loop
    • Audio.volume ,
    • Audio.position.current
    • Audio.position.seek
    • Audio.length ,
    • Audio.release
    • Audio.isdone
    • Audio.record.start
    • Audio.record.stop
• SoundPool
  • Introduction
  • Commands
    • Soundpool.open
    • Soundpool.load ,
    • Soundpool.unload
    • Soundpool.play , , , , , ,
    • Soundpool.setvolume , ,
    • Soundpool.setrate ,
    • Soundpool.setpriority ,
    • Soundpool.pause
    • Soundpool.resume
    • Soundpool.stop
    • Soundpool.release
• GPS
  • GPS Control commands
    • Gps.open {{},{},{}}
    • Gps.close
    • Gps.status {{}, {},{inview_nvar}, {}}
  • GPS Location commands
    • Gps.location {{}, {}, {}, {}, {}, {}, {}, {}}
    • Gps.time
    • Gps.provider
    • Gps.satellites {{}, {}}
    • Gps.accuracy
    • Gps.latitude
    • Gps.longitude
    • Gps.altitude
    • Gps.bearing
    • Gps.speed
• Sensors
  • Introduction
  • Sensor Commands
    • Sensors.list
    • Sensors.open {:}{, {:}, ...}
    • Sensors.read sensor_type_nexp, p1_nvar, p2_nvar, p3_nvar
    • Sensors.close
• System
  • System Commands
    • System.open
    • System.write
    • System.read.ready
    • System.read.line
    • System.close
  • Superuser Commands
    • Su.open
    • Su.write
    • Su.read.ready
    • Su.read.line
    • Su.close
  • App Commands
    • App.broadcast , , , , , , ,
    • App.start , , , , , , ,
• þÿ
• þÿ
• þÿ
  • Introduction
  • þÿ
  • þÿ
  • What you need to know
• þÿ
  • Introduction
  • License Information
  • Before You Start
  • Setting Up the Development Environment
  • Download the BASIC! Source Code from the GitHub Repository
  • Download the BASIC! Source Code from the Legacy Archive
  • Create a New Project in Eclipse
  • Rename the Package
    • In Eclipse
    • Other IDEs
    • Renaming complete
  • Modifications to setup.xml
  • Advanced Customization with setup.xml
  • Files and Resources
  • Testing the APK
  • Installing a BASIC! Program into the Application
  • Application Icons
  • Modifications to the AndroidManifest.xml File
    • Setting the Version Number and Version Name
    • Permissions
    • Disable the Shortcut Launcher
    • Launch at device boot
  • Preferences
  • Finished
• þÿ
  • Apache Commons