USE

USE "Component or Library" [ , "Component or Library" ... ]

Since 3.7

Declares that a class or script will use one or several components or libraries.

This declaration must be written in the class or script header.

The components and Libraries are specified by strings. They will be loaded the first time the class or module is used.

Both Component and Libraries may be mixed in the same USE statement.

This keyword was initially used only for Gambas Scripting with gbs3 but can now also be used in a normal project like Component.Load() to load components.

Example

Use "gb.args", "vendor.mylib:0.0.1", "gb.eval"

How Components are referenced

Components are referenced by the complete name as listed under Components

The components are looked for in the Gambas default Component location. You will find this location on your system by entering: 

$ gbx3 -e 'Component.Path'

In most cases the result will be: 

/usr/lib/gambas3/<component_name>

It is possible to find which libraries and components are available on your system using the gbs3 --list command.
Since 3.18

$ gbs3 --list library   <- generates a list of all available libraries and their paths<br>
$ gbs3 --list component <- generates a list of all components installed on your system

How Libraries are referenced and located

Libraries may be located in a number of locations specific to Gambas3 or by any explicitly defined Path.
These are listed in order of search: 

 $XDG_DATA_HOME/gambas3/lib"                                   if XDG_DATA_HOME is defined


 /usr/lib/gambas3/<vendor>/<name>:<Version>.gambas


 ~/.local/share/gambas3/lib/<vendor>/<name>:<Version>.gambas


 /usr/lib[/multiarch]/gambas3/<vendor>/<name>:<version>.gambas

For each of the paths found in: 

 $LD_LIBRARY_PATH/gambas3/<vendor>/<name>:<Version>.gambas

For each of the locations in: 

 $XDG_DATA_DIRS/gambas3/lib/<vendor>/<name>:<Version>.gambas

And for all executable directories listed in: 

 $PATH/<vendor>/<name>.gambas

or explicitly in the absolute path format: 

 /<user_defined_path>/<name>:<version>.gambas
Or 

 /<user_defined_path>/<vendor>.<name>:<version>.gambas

How version numbers are used

Version numbers may be defined and are used as part of the search criteria
may be specified in one of the following ways.
MyBiz is the vendor name for these examples.

MyBiz.mylib: - This will use the highest located version of the library
MyBiz.mylib:1 - This will use the highest located version of version 1 library found
MyBiz.mylib:1.1 - This will use the highest located version of version 1.1 library found
MyBiz.mylib:1.1.3- This will use only the explicitly request library or create and error

Note: Vendor name is not required when specifying absolute paths.

Example

use "myBiz.MyLib:","/home/mylibs/libTest:1","MyLib:","MyBiz.MyLib:1.0","MyBiz.MyLib:1.0.1" ...

Finding Your Library Search Paths

The Following gambas script will display your library search paths 

dim gbsver as string = "gambas"&system.version
dim adatapaths as string[]
dim i as integer
Print user.home &/ ".local/share" &/ gbsver &/ "lib"
print "/usr/lib" &/ gbsver
If Env["XDG_DATA_HOME"] <> "" Then
   print  Env["XDG_DATA_HOME"] &/ gbsver &/ "lib"
Endif
If Exist("usr/lib/" &/ System.Architecture) Then
    print "usr/lib/" &/ System.Architecture &/ gbsver
Endif
If Env["LD_LIBRARY_PATH"] <> "" Then
    aDataPaths = Split(Env["LD_LIBRARY_PATH"], ":", "", True)
    For i= 0 To aDataPaths.Max
      print aDataPaths[i] & "/" & gbsver
    Next
Endif
If Env["XDG_DATA_DIRS"] <> "" Then
    aDataPaths = Split(Env["XDG_DATA_DIRS"], ":", "", True)
    For i = 0 To aDataPaths.Max
      print aDataPaths[i] & "/" & gbsver &/ "lib"
    Next
Endif
If Env["PATH"] <> "" Then
    aDataPaths = Split(Env["PATH"], ":", "", True)
    For i = 0 To aDataPaths.Max
      print aDataPaths[i]
    Next
Endif

See also