----------------------------------------------------------------
lines 806-839 of file: include/cppad/example/valvector/class.hpp
----------------------------------------------------------------

   {xrst_begin valvector_pow}

   The valvector Pow Function
   ##########################

   Syntax
   ******
   | *z* = ``CppAD::pow`` ( *x* , *y* )

   x
   *
   The argument *x* is a ``const`` valvector that is passed by reference.

   y
   *
   The argument *y* is a ``const`` valvector that is passed by reference.
   If the size of *x* is not one,
   and the size of *y* is not one,
   the size of *x* and *y* must be equal.

   z
   *
   The result *z* is a valvector with size equal to the maximum of the
   size of *x* and the size of *y* .

   {xrst_toc_hidden
      example/valvector/pow.cpp
   }
   Example
   =======
   The file :ref:`valvector_pow.cpp-name` is an example and test of the
   valvector pow function.

   {xrst_end valvector_pow}