[ Term Manipulation | Reference Manual | Alphabetic Index ]
array_concat(+Front, +Back, -Concat)
Concatenate two arrays into one
- Front
- Array, i.e. structure with functor []/M
- Back
- Array, i.e. structure with functor []/N
- Concat
- Variable or array with functor []/(M+N)
Description
Succeeds if Concat is the concatenation of arrays Front and Back.
Modes and Determinism
- array_concat(+, +, -) is det
Exceptions
- (4) instantiation fault
- Front or Back is a variable (non-coroutining mode only)
- (5) type error
- Front, Back or Concat are neither variables nor arrays
Examples
?- array_concat([](a,b,c), [](d,e), L).
L = [](a,b,c,d,e)
?- array_concat([](a,b,c), [], L).
L = [](a,b,c)
?- array_concat([], [](d,e), L).
L = [](d,e)
?- array_concat([], [], L).
L = []
?- array_concat([]([](a,b),[](c)), [](d,[](e)), L).
L = []([](a,b), [](c), d, [](e))
See Also
dim / 2, subscript / 3, array_list / 2, is_array / 1, array_flat / 3, arg / 3