-------------------------------------------------------------------
lines 51-96 of file: include/cppad/example/valvector/split_join.hpp
-------------------------------------------------------------------

{xrst_begin valvector_ad_join}
{xrst_spell
   ajoin
   valvectors
}

Join a Vector of AD valvectors
##############################
Join a vector of AD<valvector>, each with size one, into one AD<valvector>.

Syntax
******
| valvector_ad_join *ajoin*
| *ajoin( *ax_vec* , *ay* )


m
*
We use *m* to denote *ax_vec* .size() .

ax_vec
******
This is a :ref:`SimpleVector-name` with elements of type CppAD::AD<valvector> .
It is ``const`` and is passed by reference.
For *i* = 0 , ... , *m* - 1 ,
the size *ax* [ *i* ].size() is one.

ay
**
This CppAD::AD<valvector> is passed by reference and its input value
does not matter.
Upon return, its size in *m* and
for *i* = 0 , ... , *m* - 1 ::

   ay[i] = ax_vec[i][0]


{xrst_toc_hidden
   example/valvector/ad_join.cpp
}
Example
*******
The file :ref:`valvector_ad_join.cpp-name` is an example and test
of this operation.

{xrst_end valvector_ad_join}