Extracting URI Components

Introduction

URI components can be extracted from an URI using TUriC8::Extract() and passing a TUriComponent flag. For example, EUriQuery or EUriPath .

Extracting a scheme component

The following code fragment illustrates how to extract a scheme component. Parse the URI before the component is extracted calling TUriParser8::Parse() .

       
        
       
       _LIT8( KUri,"http://web.intra/Dev/Sysdoc/devlib.htm" );
TUriParser8 parser;                      // URI parser object
TInt result = parser.Parse( KUri );      // parse the URI descriptor     

//Extract the scheme component from the parsed URI
const TDesC8& des = parser.Extract( EUriScheme );
      

where des is a descriptor that contains the extracted scheme component. Other components such as userinfo, host, port and so on defined in TUriComponent can be extracted in a similar way.

Extracting an authority component

To retrieve a specific authority component from the URI, call TAuthority8::Extract() . The following code fragment illustrates how to extract a authority component.

       
        
       
       _LIT8( KAuthorityDesc,    "http://user:pass@www.mypage.com" );
TAuthorityParser8 authorityParser;        //Authority parser object 

authorityParser.Parse( KAuthorityDesc );  //Parse the authority descriptor    
//extract the user infomation from the authority component
const TDesC8& des = authorityParser.Extract( EAuthorityUserinfo );
      

where, des contains the user info that is extracted from the authority component. EAuthorityUserinfo is an enum value of TAuthorityComponent . Similarly, host and port can be extracted using EAuthorityHost and EAuthorityPort respectively, which are defined in TAuthorityComponent .

Displaying the URI

To create a new descriptor containing the desired component or the full URI, call TUriC8::DisplayFormL() .

This converts a component into a new descriptor. The component to be converted can take any value between EUriScheme and EUriFragment or EUriComplete (for the full URI). This method is used to obtain a pointer to a 16 bit descriptor for GUI display of URI.

       
        
       
       HBufC16* uri = parsedUri->DisplayFormL( EUriComplete );
      

where EUriComplete indicates that all the components in the URI are displayed.

To fetch the URI, call TUriC8::UriDes() . This returns a pointer to 8 bit descriptor( TDesC8 ) containing the URI, which is used for HTTP requests.

Displaying authority

To create a new descriptor containing a specific component or the full authority component, call TAuthority8::DisplayFormL() .

This converts a component into a new descriptor. The component to be converted can take any value between EAuthorityUserinfo and EAuthorityPort or the full authority, EAuthorityComplete .

       
        
       
       HBufC authority = parsedUri->DisplayFormL( EAuthorityComplete );
      

where EAuthorityComplete means that the complete authority is displayed.

See also

For related information, see:

HTTP Utilities Library Overview