# load

Load a saved variable or a serie of variables

## Calling Sequence

    load(filename [,x1,...,xn])

    load(fd [,x1,...,xn])

## Arguments

filename

  character string containing the path of the file

fd

  a file descriptor given by a call to mopen

xi

  arbitrary Scilab variable name(s) given as strings.

## Description

The `load` command can be used to reload in the Scilab session variables previously saved in a file with the `save` command. If the file contains graphic handle variables, the corresponding graphics_entities are drawn.

`load(filename)` loads the variables saved in file given by its path `filename`.

`load(fd)` loads the variables saved in file given by its descriptor `fd`. This prototype is obsolete and will be removed in Scilab 6.

`load(filename,'x','y')` loads only variables `x,y`.

`load(fd,'x','y')` loads only variables `x,y`. This prototype is obsolete and will be removed in Scilab 6..

The change of format between the family 5 and 6 of Scilab has been decided because the 5 format is undocumented, not specified and hard to read. SOD (Scilab 6 default format) is fully documented and easy to read through HDF5 libraries or applications.

Note that the written file is portable to other operating systems and architectures (little and big endian).

## Examples

    // Binary format readable up to Scilab 5 family
    a=eye(2,2);b=ones(a);
    save('vals.dat',a,b);
    clear a
    clear b
    load('vals.dat','a','b');

    // Binary format readable by Scilab 5.4.X and Scilab 6 family
    a=eye(2,2);b=ones(a);
    save("val.sod", "a", "b");
    clear a
    clear b
    load("val.sod", "a", "b");

## See Also

- save
- read
- listvarinfile
- save_format
- exec
- mopen

## History

5.0.0
All uimenu or uicontrol handles are also loaded by this function.
5.4.0

- The load function is able to handle both Scilab 5 and SOD (Scilab 6 format) by default.
- The Scilab 5.X format is deprecated and will be removed with Scilab 6.
- Using load with a file descriptor as first input argument is deprecated and will be removed with Scilab 6.