Program Structure¶

In this chapter we will learn about using many source code files in the same project.

Source Code File Sections¶

Each source code file may contains the next sections (in the same order).

Source Code File Sections
Load Files
Statements and Global Variables
Functions
Packages and Classes

The application maybe one or more of files.

To include another source file in the project, just use the load command.

Syntax:

Load  "filename.ring"

Note

The Load command is executed directly by the compiler in the parsing stage

Tip

if you don’t know the file name until the runtime, or you need to use functions to get the file path, just use eval().

Example:

# File : Start.ring

Load "sub.ring"

sayhello("Mahmoud")

# File : sub.ring

func sayhello cName
        see "Hello " + cName + nl

Using the ‘load’ command we can use many ring source files in the same project

But all of these files will share the same global scope

We have also the “Load Package” command

Using “Load Package” we can load a library (*.ring file) in new global scope

This is very useful to create libraries that avoid conflicts in global variables

Example:

File: loadpackage.ring

x = 100
? "Hello, World!"
load package "testloadpackage.ring"

? x
test()

File: testloadpackage.ring

? "Hello from testloadpackage.ring"

x = 1000

test()

func test
        ? x

Output:

Hello, World!
Hello from testloadpackage.ring
1000
100
1000