<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-42F0F282-58D6-4878-B53D-EAEEF86A3D7D" xml:lang="en"><title>Parsing
Delimited Data</title><shortdesc>This tutorial describes the steps to parse delimited data. The
data in the URI that is delimited into segments can be parsed using the <codeph>TDelimitedXxxxParser8</codeph> classes. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<prereq>       <p>Parse the delimited data using the following functionalities
of <codeph>TDelimitedXxxxParser8</codeph>: <ul>
<li><p>Set the delimiter (before parsing the data) to a specific character
using <codeph>SetDelimiter()</codeph>. For example:</p><codeblock xml:space="preserve">//set the delimiter character to '/'
SetDelimiter(TChar('/'));</codeblock></li>
<li><p>Parse the data into segments from left to right using<codeph> Parse()</codeph>. </p></li>
<li><p>Parse the data into segments from right to left using <codeph>ParseReverse()</codeph>.</p><note> Parse
the data into segments before calling any of the functions described in the
following steps.</note></li>
<li><p>Parse to the next segment using <codeph>Inc()</codeph>. </p></li>
<li><p>Get the descriptor reference with the data using <codeph>Des()</codeph>. </p></li>
<li><p>Get the current segment and parse the data to the next segment using <codeph>GetNext()</codeph>. </p></li>
<li><p>Get the current segment using <codeph>Peek()</codeph>. </p></li>
<li><p>Get the remaining data from (and including) the current segment using <codeph>Remainder()</codeph>. </p></li>
</ul></p>     </prereq>
<context>       <p><codeph>TDelimitedXxxxParser8</codeph> classes provide
functionalities to parse delimited data, extract the current segment and parse
the string for the next segment. </p><p>Use the class derived from <xref href="GUID-B647B6DA-5FF1-3C11-9ACD-E4A5E70F3596.dita"><apiname>TDelimitedParserBase8</apiname></xref> for
implementing the function provided by <codeph>TDelimitedXxxxParser8</codeph>. </p><p>The
following three classes are used to parse the respective URI components: </p> 
   </context>
<steps-unordered>
<step id="GUID-7DE23814-1B2C-4B07-84EB-53D80D3EBBFE"><cmd/>
<info><p><xref href="GUID-CD78AD53-FD6C-397A-9930-12E8EDCF6040.dita"><apiname>TDelimitedPathParser8</apiname></xref> for parsing path into directories
separated by '/'. For example: <filepath>/doc_source/guide/N10047/index.html</filepath>.</p></info>
</step>
<step id="GUID-7DDA81B9-31D4-4DFA-A08D-5E42F10F4145"><cmd/>
<info><p><xref href="GUID-F55AF53B-662F-3682-9B6D-A3D14AED0D58.dita"><apiname>TDelimitedPathSegmentParser8</apiname></xref> for parsing parameters
that are separated by ';' For example: <codeph>postd=pp22;isub=1411@foo.com;user=phone</codeph>. </p></info>
</step>
<step id="GUID-84D83684-E711-4728-99A9-ED1EDD826F80"><cmd/>
<info><p><xref href="GUID-F76F2546-D3AC-341B-BED8-D3C88EA2C018.dita"><apiname>TDelimitedQueryParser8</apiname></xref> for parsing the query string
(after a '?') into name/value pairs that is separated by '&amp;'. For example: <codeph>sortcol=4&amp;table=1&amp;up=0&amp;view=details</codeph></p></info>
<info><p>The following table shows the delimiter to be used to separate each
of the URI components:</p><table id="GUID-9A8DAC25-B8B8-42D1-94E8-39DAEFA16DBF">
<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
<tbody>
<row>
<entry><p><b>URI Component</b></p></entry>
<entry><p><b>Delimiter</b></p></entry>
</row>
<row>
<entry><p>Path </p></entry>
<entry><p>/</p></entry>
</row>
<row>
<entry><p>Path segment </p></entry>
<entry><p>;</p></entry>
</row>
<row>
<entry><p>Query </p></entry>
<entry><p>&amp;</p></entry>
</row>
</tbody>
</tgroup>
</table></info>
</step>
</steps-unordered>
</taskbody><related-links>
<link href="GUID-795B41AF-FBEA-56CE-AE20-EF17BE754723.dita"><linktext>HTTP Utilities
Library Overview</linktext></link>
</related-links></task>