HttpRequestSetFromUrl

function

Library: HTTP support (OMHTTP)
Include: omhttp.xin

Declaration

define function HttpRequestSetFromUrl
            modifiable  stream Request
   from     value       string URL

Argument definitions

Request: is an HTTP request object.

URL: is the uniform resource locator (URL).

Purpose

Use the HttpRequestSetFromUrl function to populate several key items of the request object.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "omhttp.xin"

Usage Notes

With HttpRequestSetFromUrl, you can set the host, port, path, and search items. By setting these items, a valid request object is created and may be sent using HttpRequestSend.

Usually, you would call HttpRequestSetFromUrl in a client program.

Example

  include "omhttp.xin"
  
  process
     local HttpRequest request
  
     ; set the host and path
     HttpRequestSetFromUrl request from
        "http://www.omnimark.com/home/home.html"
  
     ; set the port and two search items in addition to the host and path
     HttpRequestSetFromUrl request from
        "http://www.omnimark.com:1080/home/home.html?name1=value1&name2=value2"

Related Topics

Other Library Functions