Manipulating URI Data

Introduction

InetProtTextUtils provides various text parsing utilities for manipulating the data in HTTP headers. This includes:

• removing the white space

• converting the data.

Removing white spaces

InetProtTextUtils::RemoveWhiteSpace() removes any contiguous white spaces at either or both the ends of the data, as specified by the mode (right, left, or both). A white space includes blank spaces, tabs and separators. For example, new line.

The following code removes the white spaces on the left side of the URI.

_LIT( KFullUriPath," P:\\DV3\\gothere\\moveon.htm" ); // URI 
TPtrC uriName(KFullUriPath);                          //pointer to the URI
//Remove the white space on the left side of URI
Tint consumedWhiteSpacesLeft = InetProtTextUtils::RemoveWhiteSpace( uriName, InetProtTextUtils::ERemoveLeft );

If the white space is removed, it returns KErrNone, else it returns KErrNotFound. ERemoveRight or ERemoveBoth is used to remove white spaces on right side or both sides of the URI, respectively.

Note: The white spaces within the URI cannot be removed using RemoveWhiteSpace().

Converting the data

InetProtTextUtils class provides various data conversion methods. The methods can be used to convert decimal and hex descriptors into its integer representations and vice versa. The following are the methods:

Converting data from an integer to a string

Call InetProtTextUtils::ConvertIntToDescriptorL() or InetProtTextUtils::ConvertHexToDescriptorL() to convert an integer into a decimal or hexademial number respectively. The following code converts the integer value of the data to a string:

// Convert the integer value of the data to a string
TInt intVal = 489;
HBufC8* abuf = HBufC8::NewL( 32 );//a descriptor is allocated on the heap to hold the data.
InetProtTextUtils::ConvertIntToDescriptorL( intVal,abuf );// abuf contains "489", the extracted value.

where, intVal stores the data to be converted. The converted abuf contains the extracted descriptor.

TInt intVal=489;
HBufC8* abuf = HBufC8::NewL( 32 );
InetProtTextUtils::ConvertHexToDescriptorL( intVal,abuf );//abuf contains 1E9

where, intVal stores the data to be converted. The converted value will be stored in the buffer abuf.

Converting data from a string to a number

Call InetProtTextUtils::ConvertDescriptorToIntL() to convert the character representation of an integer into its numeric value. Preceding white space is ignored and the integer is delimited by either the end of the data, whitespace or any character other than 0 to 9.

//Convert the string to an integer
TInt intVal = 0;
_LIT8( KNumber,"489" );
InetProtTextUtils::ConvertDescriptorToInt( KNumber,intVal ); // the intVal now holds the integer 489

Call InetProtTextUtils::ConvertDescriptorToHex() to convert the character representation of an integer to its hexadecimal value.

TInt intVal = 0;
_LIT8( KNumber,"64" );
InetProtTextUtils::ConvertDescriptorToHex( KNumber,intVal ); //intVal = 100

This function extracts the value contained in the buffer intVal and considers a hexadecimal number.

Extracting the quoted string

InetProtTextUtils::ExtractQuotedStringL() extracts the quoted string within an URI.

_LIT8( KQuotedBuffer0,    "this is the \"inside quotes\" outside quotes" ); // the string to be manipulated
TBuf8<64>  quotedString;
TPtrC8 ptr( KQuotedBuffer0() ); //pointer to the string
TPtrC8 ptr1( quotedString );
//ptr contains "outside quotes" and ptr1 contains "inside quotes"
InetProtTextUtils::ExtractQuotedStringL( ptr, ptr1 ); 

where, ptr1 is a pointer that points to the quoted string "inside quotes "

See also

HTTP Utilities Library Overview