.. _data:

====
data
==== 

O valor atômico de um nó

Descrição
~~~~~~~~~
A função fn:data recebe uma sequência de itens e devolve os valores tipados 
deles. Para valores atômicos, isso significa devolver o próprio valor, sem 
mudança. Para nós, significa extrair o valor tipado do nó.

Muitas vezes não é preciso chamar esta função, porque o valor tipado de um nó é 
extraído automaticamente (um processo chamado atomização) em muitas expressões 
XPath 2.0, como comparações, operações aritméticas e chamadas de função. O uso 
mais comum de fn:data é nos construtores de elemento do XQuery.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:string()
     - o item do qual pegar o valor

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

.. code-block:: xml

   <xsl:variable name="cat" select="doc('http://www.functx.com/input/catalog.xml')"/>
   
   <!-- content of catalog.xml -->
   <catalog>
    <product dept="WMN">
     <number>557</number>
     <name language="en">Fleece Pullover</name>
     <colorChoices>navy black</colorChoices>
    </product>
    <product dept="ACC">
     <number>563</number>
     <name language="en">Floppy Sun Hat</name>
    </product>
    <product dept="ACC">
     <number>443</number>
     <name language="en">Deluxe Travel Bag</name>
    </product>
    <product dept="MEN">
     <number>784</number>
     <name language="en">Cotton Dress Shirt</name>
     <colorChoices>white gray</colorChoices>
     <desc>Our <i>favorite</i> shirt!</desc>
    </product>
   </catalog>

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

   * - **XPath**
     - **Resultado**
   * - data($cat//product[1]/number)
     - 557
   * - data($cat//number)
     - (557, 563, 443, 784)
   * - data($cat//product[1]/@dept)
     - WMN
   * - data($cat//product[1]/colorChoices)
     - navy black
   * - data($cat//product[1])
     - 557 Fleece Pullover navy black
   * - data($cat//product[4]/desc)
     - Our favorite shirt!

Os exemplos abaixo dão resultados diferentes se o documento de entrada tiver sido validado com este schema. Os geradores não validam contra um schema, então no Mapper Idea o data() devolve os valores sem tipo, como na tabela de cima.

.. code-block:: xml

   <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
     <xs:element name="catalog" type="CatalogType"/>
     <xs:complexType name="CatalogType">
       <xs:sequence>
         <xs:element name="product" type="ProductType" maxOccurs="unbounded"/>
       </xs:sequence>
     </xs:complexType>
     <xs:complexType name="ProductType">
       <xs:sequence>
         <xs:element name="number" type="xs:integer"/>
         <xs:element name="name" type="NameType"/>
         <xs:element name="colorChoices" type="ColorListType" minOccurs="0"/>
         <xs:element name="desc" minOccurs="0"/>
       </xs:sequence>
       <xs:attribute name="dept" type="xs:string"/>
     </xs:complexType>
     <xs:simpleType name="ColorListType">
       <xs:list itemType="xs:string"/>
     </xs:simpleType>
     <xs:complexType name="NameType">
       <xs:simpleContent>
         <xs:extension base="xs:string">
           <xs:attribute name="language" type="LangType"/>
         </xs:extension>
       </xs:simpleContent>
     </xs:complexType>
     <xs:simpleType name="LangType">
       <xs:restriction base="xs:string">
         <xs:enumeration value="en"/>
         <xs:enumeration value="fr"/>
       </xs:restriction>
     </xs:simpleType>
   </xs:schema>

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

   * - **XPath**
     - **Resultado**
   * - data($cat//product[1]/colorChoices)
     - ('navy', 'black')
   * - data($cat//product[1])
     - Error FOTY0012