Gambas Documentation
Como se hace...
Compilación e instalación
Componentes
Controls pictures
Descripciones del Lenguaje
Developer Documentation
Documentacion y Recetas
Documentación del Entorno de Desarrollo
Fragmentos de código
Glosario
Índice del Lenguaje
Abs
Access
ACos
ACosh
Alloc
AND
Ang
APPEND
Array
AS
Asc
Asignación
ASin
ASinh
ATan
ATan2
ATanh
BChg
BClr
BEGINS
Bin$
BREAK
BSet
BTst
BYREF
CASE
CATCH
CBool
Cbr
CByte
CDate
CFloat
Choose
Chr$
CInt
CLASS
CLong
CLOSE
Comp
CONST
Constantes del Lenguaje
CONTINUE
Conv$
COPY
Cos
Cosh
CREATE
CREATE STATIC
CShort
CSng
CStr
Date
DateAdd
DateDiff
Day
DConv$
DEBUG
DEC
Declaracion de Arreglos
Declaración de Constantes
Declaración de Eventos
Declaración de Funciones Externas
Declaración de Métodos
Declaración de Propiedades
Declaración de Variables
Declaración de Variables Locales
DEFAULT
Deg
DFree
DIM
Dir
DIV
DO
ELSE
END
ENDIF
ENDS
END SELECT
END WITH
ENUM
Enumeration declaration
Eof
ERROR
Etiquetas
EVENT
EXEC
Exp
Exp2
Exp10
Expm
EXPORT
Expresión Constante
EXTERN
FALSE
FINALLY
FLUSH
FOR
FOR EACH
Format$
Frac
Free
FUNCTION
GOTO
Hex$
Hour
Html$
Hyp
IF
IN
INC
INPUT
INPUT FROM
InStr
Int
IsAscii
IsBlank
IsBoolean
IsByte
IsDate
IsDigit
IsDir
IsFloat
IsHexa
IsInteger
IsLCase
IsLetter
IsLong
IsNull
IsNumber
IsObject
IsPunct
IsShort
IsSingle
IsSpace
IsString
IsUCase
KILL
LAST
LCase$
Left$
Len
LIBRARY
LIKE
LINE INPUT
LINK
LOCK
Lof
Log
Log2
Log10
Logp
LOOP
LTrim$
Max
ME
Métodos especiales
Mid$
Min
Minute
MKDIR
MOD
Month
MOVE
New
NEXT
NOT
Now
NULL
OPEN
Operadores Aritméticos
Operadores de Asignación
Operadores de Cadena
Operadores Lógicos
OPTIONAL
OR
OUTPUT
OUTPUT TO
Pi
PRINT
PRIVATE
PROCEDURE
PROPERTY
PUBLIC
QUIT
Quote$
Rad
RAISE
Randomize
READ[../../def/stream] _\Stream_
Realloc
REPEAT
Replace$
RETURN
Right$
RInStr
RMDIR
Rnd
Rol
Ror
Round
RTrim$
SConv$
Second
Seek
SELECT
Sgn
Shell$
Shl
Shr
Sin
Sinh
SLEEP
Space$
Split
Sqr
Stat
STATIC
STEP
STOP
STOP EVENT
Str$
String$
StrPtr
SUB
Subst$
SUPER
SWAP
Tan
Tanh
Temp$
THEN
Time
Timer
Tipos de Datos
TO
Trim$
TRUE
TRY
TypeOf
UCase$
UNLOCK
UNTIL
Val
WAIT
WATCH
Week
WeekDay
WEND
WHILE
WITH
WRITE
XOR
Year
LÉEME
Licencia del Wiki
Manual del Wiki
Mensajes de Error
Pendiente de traducción
Registrarse
Repositorio de Aplicaciones
Tutoriales
Últimos cambios

USE

Desde 3.7

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

Only for Gambas Scripting with gbs3.

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.

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:

  gbs3 -e "print component.path"

In Most Cases this will be
  /usr/lib/gambas3/<component_name>

Example

use "gb.args","gb.eval"...

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 list 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