# RXS_ParseDomToText()

This subprocedure retrieves the text result of a specific XPath.

## Subprocedure Prototype

### IBM i 7.1+

| Field | Description |
|---|---|
| `     D RXS_ParseDomToText...      D                 PR                  Extproc('RXS_ParseDomToText') Opdesc      D                                     Like(RXS_Var16Mv_t)      D                                     Rtnparm` | Returns the text retrieved from the specified XPath. |
| `     D  pXPath                             Like(RXS_Var8Kv_t) Const      D                                     Options(*Varsize)` | XPath used to determine which nodes are retrieved into the RXS_ParseDomDS_t return data structure. |
| `     D  pDS                                LikeDS(RXS_ParseDomDS_t)      D                                     Options(*Varsize)` | RXS_ParseDomDS_t data structure, e.g. the "parent" structure. |


## Example Code

### IBM i 7.1+

#### Example 1
```rpgle
      *--------------------------------------------------------------
      * This example demonstrates retrieving a text value from a specified  
      *  XPath and storing it in a character field.
      * This example uses IBM i 7.1+ prototypes for most calls; refer to
      *  the individual documentation for these subprocedures for the 
      *  6.1 prototypes.
      *--------------------------------------------------------------
     H DFTACTGRP(*NO) BNDDIR('RXSBND') ACTGRP(*CALLER)

      /copy QRPGLECPY,RXSCB

     D gRootDomDS      DS                  LikeDS(RXS_OpenDomDS_t) 
     D gXml            S                   Like(RXS_Var8Kv_t)
     D gData           S                   Like(RXS_Var8Kv_t)
      /free
       RXS_ResetDS( gRootDomDS : RXS_DS_TYPE_OPENDOM );
       
       gXml = RXS_GetStdIn();
       gRootDomDS = RXS_OpenDom( gXml );

       gXPath = RXS_XPath( '/*:bookstore/*:book' );
       gData = RXS_ParseDomToText( gXPath : gRootDomDS );

       *INLR = *ON;
      /end-free
```

## Data Structures

### RXS_ParseDomDS_t

| Field | Description |
|---|---|
| `     D RXS_ParseDomDS_t...      D                 DS                  Qualified Template Inz` |  |
| `     D   ReturnedErrorInfo...      D                                     LikeDS(RXS_ReturnedErrorInfoDS_t) Inz` |  |
| `     D   DataStructureType...      D                                5I 0 Inz(RXS_DS_TYPE_PARSEDOM)` | **Internal use only** |
| `     D   OnErrorMessageType...      D                                5I 0` |  |
| `     D   InputCcsid...      D                               10I 0` | Specifies the CCSID of the XML being parsed. |
| `     D   OutputCcsid...      D                               10I 0` | Specifies the CCSID the parsed data will be converted to. |
| `     D   Stmf...      D                                     Like(RXS_Var1Kv_t)` | Specifies an IFS path to an XML file to parse instead of the Input parm. |
| `     D   NodeCount                   10U 0` | Contains the current count of XML nodes tracked by this data structure. |
| `     D   NodeType                    10I 0` |  |
| `     D   xmlPtr                        *` | **Internal use only** |
| `     D   docPtr                        *` | **Internal use only** |
| `     D   contextPtr                    *` | **Internal use only** |
| `     D   dictPtr                       *` | **Internal use only** |
| `     D   currentPtr                    *` | **Internal use only** |
| `     D   parentPtr                     *` | **Internal use only** |
| `     D   Reserved                  4096A` | **Internal use only** |