NAME

Syntax: NAME oldname as string, newname as string
Type: statement
Category: File

name "dsc001.jpg", "landscape.jpg"

Differences:
Between QB:
Name no longer uses the syntax "name oldname as newname" as that syntax is obscure only to this command. Now uses a more structured syntax "name oldname, newname".

Differences:
Between QB:
~~Multiple counters are not supported.~~

Version 0.05 Beta:
NEXT with multiple identifiers (NEXT a, b, ...), as many old sources seem to have that (v1ctor)

e.g.

NOT

returns true if the condition is false. This swaps the condition from true to false ahd false to true.

i.e.

OCT$

Returns a number in octal format (base 8) in a string. Octal digits range from 0 to 7, so 8 in decimal is 10 in octal (oct$(8) = "10").

See also bin$, hex$.

ON ERROR

on error goto errorhandler 'sets the error handler label
error 24 'simulate error 24
print "this message will not be seen"

errorhandler:
print "Error #"; err; "!" 'show the error number
end 'end the program execution

ON...GOSUB

Syntax: on expression gosub label1[, label2...]
Type: statement
Category: Keywords

Branches out to different labels depending on the value of an expression. 1 will branch to the first label, 2 to the second, etc. It will also remember where it branched from, and when 'return' is called it will return to where it was branched from.

However this command should be replaced with select case.

Anyway, here is a simple example:

choice = 3
on choice gosub labela, labelb, labelc
print "Good bye."
end

labela:
print "choice a"
return

labelb:
print "choice b"
return

labelc:
print "choice c"
return

ON...GOTO

Syntax: on expression goto label1[, label2...]
Type: statement
Category: Keywords

Branches out to different labels depending on the value of an expression. 1 will branch to the first label, 2 to the second, etc.

However this command should be replaced with select case.

Anyway, here is a simple example:

choice = 3
on choice gosub labela, labelb, labelc

labela:
print "choice a"
end

labelb:
print "choice b"
end

labelc:
print "choice c"
end

keyword to be used with $INCLUDE or #INCLUDE as in: '$include once: "includethisfileonlyonce.bi" (v1c)

OPEN

Opens a file on the system for reading/writing in the given file slot, with the given file mode.

more written here later, but the basics. This example will read a line of text from the file "file.ext" in the current folder, and print the text on the screen.

f = freefile
open "file.ext" for input as #f
line input #f, ln$
print ln$
close #f

OPTION BASE

option base 1
dim foo(10)

foo is now an array that ranges from foo(1) to foo(10). This is the same as dim foo(1 to 10). If option base 0 is used, foo would range from 0 to 10.

remove intrinsic routines/statements (v1c)

option private

Sets subs/functions to be private by default (instead of public by default). This means subs/functions are only accessible within the module and is hidden to other modules, unless they have 'public' before them. This means two subs/functions can have the same name, as long as they are private and are in seperate modules.

e.g.

option private

sub I_am_private()
end sub

public sub I_am_public()
end sub

A bitwise operator which compares each bit in the two numbers and returns true if either coresponding bits are true. Useful to return true if either conditions are true.

i.e.

OUT

Statement for VGA port output emulation.

Used for lowlevel VGA palette management emulation, this function only accepts port numbers &h3C7, &h3C8 and &h3C9. You do not normally need this function; use 8bit or higher color depth modes and PALETTE instead.

See also PALETTE, INP, WAIT.

Differences:
Between QB:
This is just a limited emulation, and only ports &h3C7, &h3C8 and &h3C9 are supported for DOS VGA palette DAC registers writing operations. A write to any other port will have no effect.

Reason: user mode apps can't access IO ports directly in windows.

OUTPUT

A file mode used with open to allow the file to be written to with lines of text.

See also input (file mode).