IDL Reference Guide: Network Objects

IDLnetOGCWMS::ParseUrl

The IDLnetOGCWMS::ParseUrl procedure method breaks down a given, valid URL to a remote WMS server into component parts and sets the corresponding IDLnetOGCWMS properties. This method will set the following properties assuming a URL has each component:

See Translating a URL into Property Values for more information on how URL components map to IDLnetOGCWMS properties.

This method will throw an error if the parsing process fails. Always use a known, working URL as the argument.

Syntax

Obj->[IDLnetOGCWMS::]ParseUrl, URL

Arguments

URL

A string argument containing a known, working URL to an OGC server from which data will be requested.

Keywords

None

Examples

Create an IDLnetOGCWMS object and call the ParseURL method to populate required properties. In this example use a URL of your choosing or input the following, entered as a single line at the command prompt when requested.

http://mapserv2.esrin.esa.it/cubestor/cubeserv/cubeserv.cgi?  
  
  
PRO ogcparseurl_doc  
  
; Create OGC WMS object.  
oWms = OBJ_NEW("IDLnetOGCWMS")  
  
; Enter known working URL at command line to parse.  
url = ''  
READ, url, PROMPT='Enter URL: '  
oWms->ParseUrl, STRING(url)  
  
; Get properties to see how URL portions are assigned.  
oWms->GetProperty, URL_HOSTNAME=uhost, URL_PATH=upath,$  
   URL_PORT=uport, URL_SCHEME=uscheme  
  
PRINT, ""  
PRINT, "HOST = " + uhost   
PRINT, "PATH = " + upath  
PRINT, "PORT = " + uport  
PRINT, "SCHEME = " + uscheme  
  
; Cleanup.   
OBJ_DESTROY, oWms  
  
END  

Given the URL noted above, IDL prints:

HOST = mapserv2.esrin.esa.it  
PATH = cubestor/cubeserv/cubeserv.cgi  
PORT = 80  
SCHEME = http