FUNCTIONS AND SUB ROUTINES

    Functions and Sub Routines are blocks of code that can be executed any where in your program.

    The biggest difference between Functions and Sub Routines is that Functions can return a value.  Basically Functions and be used as a string or number value in an expression.  RCBASIC has several built-in functions to perform different task such as compute square roots, get the time, etc.  Functions are either numbers or strings just like variables and arrays.  As such, functions can be used anywhere a variable or array can be used.  Look at the following:

    Dim x[2]
    x[0] = Sqrt(25)
    x[1] = Sqrt(36)
    Print "THE SQUARE ROOT OF 25 IS "; x[0]
    Print "THE SQUARE ROOT OF 36 IS "; x[1]

    The above code creates a number array called X with 2 elements in it.  It stores the square root of 25 in the first index and stores the square root of 36 in the second index.  It then outputs both values to the console.  The output should look like this:

    THE SQUARE ROOT OF 25 IS 5
    THE SQUARE ROOT OF 36 IS 6

    String functions can be used in a string expression just like number functions can be used in a number expression.  Look at the following code:

    B$ = Mid$("HELLO WORLD", 0, 2)
    Print "THE FIRST TWO CHARACTERS IN HELLO WORLD ARE ";B$

    The above code creates a string variable called B and stores 2 characters starting from position 0 in the string HELLO WORLD.  It then outputs the value to the console.  The output should look like the following:

    THE FIRST  TWO CHARACTERS IN HELLO WORLD ARE HE

    Sub Routines can execute code in other parts of your program just like a function.  However Sub Routines cannot return values and cannot be used in expressions.  So why would you want to use a Sub Routine over a function?  Well Sub Routines have less over head since it does not have to internally push a value onto the stack like a function does.  So in cases where you do not need to return a value you should use a Sub Routine.  RC BASIC has several built-in Sub Routines to perform task where a return value is not necessary.  Look at the following:

    FPrint("test")

    FPrint is a Sub Routine that outputs text to the console.   Since FPrint doesn't perform calculations of any kind it did not need to be implemented as a Function.

    In addition to the built-in Functions and Sub Routines RCBASIC also allows programmers to build there own Functions and Sub Routines.  You do this using the FUNCTION or SUB keywords.

    Function  MyFunc(a, b)
        c = a + b
        Return c
    End Function

    The above code creates a function called MyFunc which takes in two arguments: a and b.  To use this function you would call it like this:

    MyFunc(3, 4)

    The code above will pass 3 and 4 to the variables A and B in MYFUNC respectively.  The function creates a variable called C and sets it equal to the sum of 3 + 4.  It then returns C.  So the function equals 7.  Since this is a number function you could store the value in a number variable or use PRINT to output the value to the console.


    To make a string function you simply add $ to the end of the function name when you create it just like with variables and arrays.

    Function MyString$ ( G$ )
        Return "YOU ENTERED " + G$
    End Function

    Print MyString("SOMETHING")

    The above code should output the following:

    YOU ENTERED SOMETHING

    Sub Routines are created using the SUB keyword.  Look at the following:

    Sub MySub ( )
        For i = 1 To 5
            Print i
        Next
    End Sub

    MySub ( )

    The code above creates a Sub Routine called MYSUB which uses a FOR loop to output the numbers 1 to 5 to the console.

    Functions and Sub Routines pass variables by value by default.  Look at the following:

    Sub  MySub ( a )
        a = 5
    End Sub