join!

join!(X, Y)

X is a vector/tuple/matrix/table.

Y is a scalar/vector/tuple/matrix/table.

If X is a vector, Y is a scalar/vector/tuple; if X is a matrix, Y is a vector/matrix; if X is a table, Y is a vector/table.

Merge X and Y, and assign the result to X. The resulting object has the same data type as X.

If X is a vector, Y must be a scalar, vector, or tuple whose elements all have the same data type as X. The result is a vector longer than X.

x=[1,2,3]
x.join!(4)
x;
// output
[1,2,3,4]

x.join!(5 6 7)
x;
// output
[1,2,3,4,5,6,7]

$ x.join!((8,9))
$ x;
[1,2,3,4,5,6,7,8,9]

If X is a tuple, Y can be a scalar, vector or tuple. The result is a tuple longer than X.

$ x = (1,"A")
$ x.join!(2)
$ x;
(1,"A",2)

$ x.join!([3,4,5])
$ x;
(1,"A",2,[3,4,5])

$ x.join!(("B","C"))
$ x;
// when appendTupleAsAWhole = true
(1,"A",2,[3,4,5],("B","C"))
// when appendTupleAsAWhole = false
(1,"A",2,[3,4,5],"B","C")

If X is a matrix, Y must be a vector/matrix with the same number of rows as X. The result is a matrix with the same number of rows as X.

x=1..6$2:3
join!(x, [7,8])
x;

x.join!(9..12$2:2)
x;

If X is a table, Y must be a table or a vector with the same number of rows as X. The result is a table with the same number of rows as X.

a=table(1..3 as x, 4.5 6.7 8.5 as y);
a;

b=table(700 500 800 as z);
b;

join!(a,b);
a;

a=table(1..3 as x, `IBM`C`AAPL as y);
b=table(172.3 25 106.5 as z);
a.join!(b);
a;