[ library(viewable) | Reference Manual | Alphabetic Index ]
viewable_expand(++ViewableName, ++DimensionNumber, +ExtraElements, ++LocName)
Expand a dimension of a viewable by adding new elements, specifying the name of the new location.
- ViewableName
- A string or atom; the name of an existent viewable
- DimensionNumber
- An integer: the number of the dimension to be enlarged.
- ExtraElements
- A nested list or an array of the right size/dimensions, containing the new viewable elements.
- LocName
- A string: the name of the new location.
Description
        NOTE:When there are no registered visualisation clients,
        this predicate succeeds with any arguments, and has no effect.
        This predicate behaves exactly the same as viewable_expand/3 except that you have the added ability to name the new location of the expanded dimension. LocName is a string which becomes the name for the new location. 
        For more details on expanding viewables, see the documentation for viewable_expand/3. 
Fail Conditions
Fails if ViewableName is not the name of an existent viewable, or if the requested dimension of the viewable is not flexible.
Resatisfiable
no
Exceptions
- (4) instantiation fault 
- ViewableName is not a string or atom
- (5) type error 
- DimensionNumber is not a ground integer
- (6) out of range 
- DimensionNumber is not positive, or exceeds the viewable's number of dimensions
- (1) general error 
- ExtraElements is not a regular nested list or array of the correct size/dimensions
- (5) type error 
- ExtraElements contains elements which do not conform to the element type of the viewable
- (5) type error 
- LocName is not a string
Examples
[Assuming that at least one visualisation client is registered]
       viewable_create(v1, [[X, Y, Z], [A, B, C]], 
       	               array([flexible, fixed], any)), 
       viewable_expand(v1, 1, [R, S, T], "barg").
       This will add to the 2 x 3 viewable a third row, named "barg".
       viewable_create(v1, [[X, Y, Z], [A, B, C]], 
       	               array([fixed, flexible], any)), 
       viewable_expand(v1, 2, [Q, P], "zatch").
       This will add to the 2 x 3 viewable a fourth column, named "zatch".
See Also
viewable_expand / 3, viewable_create / 4, viewable_size / 2, viewable_type / 2