<?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-101A11B5-E9A2-4E6D-9D81-9BF76312521D" xml:lang="en"><title>WSP

Header Primitive Decoding</title><shortdesc><apiname>TWspPrimitiveDecoder</apiname> allows decoding the primitive

values of the header. This allows interpreting the encoded header.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<steps-unordered>

<step id="GUID-88138F7A-824B-422F-93CE-F3DA473624A1"><cmd/>

<info><p>Call <codeph>String()</codeph>, <codeph>Val7Bit()</codeph>, <codeph>LongInt()</codeph>, <codeph>Integer()</codeph>, <codeph>UIntVar()</codeph>, <codeph>LengthVal()</codeph>, <codeph>Date()</codeph> as appropriate to

get the required byte to which the buffer is currently pointing. Before calling

these functions, check if the data type that is passed to the functions is

one of the type supported by <xref href="GUID-2E4D864D-52DD-3B7A-9B4A-C9382CF2DACE.dita"><apiname>TWspHeaderType</apiname></xref>. To get the

type of the variable, call <codeph>VarType()</codeph>, which returns either <codeph>ELengthVal</codeph>, <codeph>EQuotedString</codeph>, <codeph>EString</codeph> or <codeph>E7BitVal</codeph> of <xref href="GUID-2E4D864D-52DD-3B7A-9B4A-C9382CF2DACE.dita"><apiname>TWspHeaderType</apiname></xref> as

appropriate. If no data type is set to the data it points, the function returns <codeph>ENotSet</codeph>. </p></info>

<stepxmp><codeblock xml:space="preserve">TPtrC8 aBuf;

TWspPrimitiveDecoder dec(aBuf);

TInt length;

// get length in bytes of data 

TInt int = dec.LengthVal(length);</codeblock></stepxmp>

<substeps id="GUID-2BBE7C92-553D-496A-982A-967370AF272F">

<substep id="GUID-C1C8DF08-EFCA-4185-83A4-4FEDDDE587AD"><cmd/>

<info><p>Decode the string value of the header using <codeph>String()</codeph>. </p></info>

<stepxmp><codeblock xml:space="preserve">TPtrC8 aBuf;

TWspPrimitiveDecoder dec(aBuf);

TPtrC8 str;

//get the string that the buffer is pointing to

TInt int = dec.String(str); </codeblock></stepxmp>

</substep>

<substep id="GUID-6F363AF0-AD00-4397-A7EE-ABCF3B0A0BD4"><cmd/>

<info><p>Decode the integer value of the header using <codeph>Integer()</codeph>. </p></info>

<stepxmp><codeblock xml:space="preserve">TPtrC8 aBuf;

TWspPrimitiveDecoder dec(aBuf);

TUint32 val;

// get the integer that the buffer is pointing to

TInt int = dec.Integer(val); </codeblock></stepxmp>

</substep>

<substep id="GUID-B8AB27CC-AE2C-400E-96AF-4030021883F1"><cmd/>

<info><p>Decode the integer value of the header using <codeph>UIntVar()</codeph>. </p></info>

<stepxmp><codeblock xml:space="preserve">TPtrC8 aBuf;

TWspPrimitiveDecoder dec(aBuf);

TUint32 val;

//get the TUint32 value of the header

TUint32 uInt =dec.UintVar(val);  </codeblock></stepxmp>

</substep>

</substeps>

</step>

</steps-unordered>

</taskbody></task>