<?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>