.. _functx_wrap-values-in-elements:

==============================
functx:wrap-values-in-elements
============================== 

Põe cada valor atômico de uma sequência dentro de um elemento XML

Descrição
~~~~~~~~~
A função functx:wrap-values-in-elements recebe uma sequência de valores atômicos 
e põe cada um dentro de um elemento com o nome indicado em $elementName.

O nome precisa ser um valor xs:QName. QNames podem ser construídos com o 
construtor de tipo xs:QName ou com a função fn:QName, como nos exemplos.

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - **Parâmetros**
     - **Descrição**
   * - values:string()
     - os valores a pôr dentro de elementos
   * - elementName:string()
     - o nome dos elementos a construir

Exemplos
~~~~~~~~
Os exemplos abaixo usam este documento de entrada:

.. code-block:: xml

   <xsl:stylesheet xmlns:new="http://newns">...

.. list-table::
   :widths: 50 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
   * - functx:wrap-values-in-elements((1,2,3), xs:QName('num'))
     - <num>1</num> <num>2</num> <num>3</num>
   * - functx:wrap-values-in-elements((1,2,3), xs:QName('new:num'))
     - <new:num xmlns:new="http://newns">1</new:num> <new:num xmlns:new="http://newns">2</new:num> <new:num xmlns:new="http://newns">3</new:num>
   * - functx:wrap-values-in-elements((1,2,3), QName('http://newns','num'))
     - <num xmlns="http://newns">1</num> <num xmlns="http://newns">2</num> <num xmlns="http://newns">3</num>
   * - functx:wrap-values-in-elements((1,2,3), QName('http://newns','new:num'))
     - <new:num xmlns:new="http://newns">1</new:num> <new:num xmlns:new="http://newns">2</new:num> <new:num xmlns:new="http://newns">3</new:num>