genlib

build library from functions in given directory

Calling Sequence

genlib(lib_name [[,dir_name, [ Force [,verb [,Names]]]])
genlib(lib_name [,path=dir_name] [,verbose=verb] [,force=Force] [,names=Names])

Arguments

lib_name:Scilab string. The variable name of the library to (re)create.

: :dir_name: Scilab string. The name of the directory to look for

.sci-files.

: :Force boolean value (default value is %f). Set it to %t to

force the sci-files recompilation.

: :verb boolean values (default value is %f). Set it to %t to get

information.

: :Names a vector of strings, the names of function to include in the

library. By default all the sci-files are taken into account

:

Description

For each .sci file in dir_name (or only those specified by the Names argument), genlib executes a exec and saves the functions to the corresponding .bin file. The .sci file must not contain anything but Scilab functions. If a .bin file is newer than the associated .sci file, genlib does not translate and save the file.

This default behaviour can be changed if force is given and set to %t. In this latter case the recompilation is always performed for each .sci file.

When all .sci files have been processed, genlib creates a library variable named lib_name and saves it in the file lib in dir_name. If the Scilab variable lib_name is not protected (see predef) this variable is updated.

If verbose is et to %t information are displayed during the build process.

If dir_name argument is not given and if lib_name Scilab variable exists and it is a library dir_name is taken equal to the lib_name library path (update mode).

Restrictions

Scilab tacitly assumes that file foo.sci defines at least a function named foo. If subsidiary functions are included, they are made known to Scilab only after the function foo had been referenced.

See Also

• getd getting all functions defined in a directory
• exec script file execution
• save Save a variable or a serie of variables in a binary file
• lib library definition