.. _concat:

======
concat
====== 

Concatena duas ou mais strings

Descrição
~~~~~~~~~
A função fn:concat exige pelo menos dois argumentos (que podem ser a sequência 
vazia) e aceita quantos argumentos a mais você quiser. É a única função do XPath 
2.0 com número variável de argumentos, por compatibilidade com o XPath 1.0. 
Argumentos que não são xs:string são convertidos em xs:string.

A função não aceita uma sequência de valores, só valores atômicos avulsos, 
passados como argumentos separados. Para concatenar uma sequência de strings, 
use fn:string-join.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg1:string()
     - o primeiro valor a concatenar
   * - arg2:string()
     - o segundo valor a concatenar
   * - arg3:string()
     - o terceiro valor a concatenar (opcional)
   * - argN:string()
     - qualquer número de argumentos é permitido

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

   * - **XPath**
     - **Resultado**
   * - concat('a')
     - Error XPST0017
   * - concat('a', 'b')
     - ab
   * - concat('a', 'b', 'c')
     - abc
   * - concat('a', (), 'b', '', 'c')
     - abc
   * - concat( ('a', 'b', 'c') )
     - Error XPST0017
   * - concat('a', <x>b</x>, 'c')
     - abc

Veja também
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`string-join`.