Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

Array Functions

(aref <array> <n>)  GET THE NTH ELEMENT OF AN ARRAY
    <array>     the array
    <n>         the array index (integer)
    returns     the value of the array element
(make-array <size>)  MAKE A NEW ARRAY
    <size>      the size of the new array (integer)
    returns     the new array
(vector <expr>...)  MAKE AN INITIALIZED VECTOR
    <expr>      the vector elements
    returns     the new vector
(copy-array <src> <dest> [<dest-pos>])  COPY INTO A PREALLOC'd ARRAY
     <src>      the array to copy from
     <dest>     the array to copy to, preallocated by MAKE-ARRAY
     <dest-pos> the integer offset in <dest> for beginning the copy
                If <dest-pos> is omitted, this defaults to 0.
     returns    <dest>.
(array-insert-pos <array> <pos> <elt>)  INSERT A NEW ELEMENT IN ARRAY
    <array>     an array into which we want to insert a new element
    <pos>       the integer index in <array> for inserted element;
                <pos> < 0 will cause the new element to be appended.
    <elt>       any lisp value
    returns     a new array that is one element longer than <array>;
(array-delete-pos <array> <pos>)  DELETE AN ELEMENT FROM AN ARRAY
    <array>     an array into which we want to delete an element
    <pos>       the integer index for the element to delete in <array>;
                <pos> < 0 will delete the last element of the array.
    returns     a new array that is one element shorter than <array>

NOTE: copy-array, array-insert-pos, and array-delete-pos are new primitives added to XLISP by Niels Mayer for use with WINTERP.


Go to the first, previous, next, last section, table of contents.