*OBJ/PARSEURL Parse URL Object
Usage
The *obj/parseUrl object consists of various properties and methods that parse the components of a provided URL. See Properties and Methods.
(The Parse URL object *OBJ/PARSEURL was added in PxPlus 2026.)
Instantiating the Parse URL Object
To instantiate the Parse URL object using the handle parse_obj (where parse_obj can be any numeric variable), enter the following command:
parse_obj=NEW("*obj/parseUrl")To access any of the available properties and methods, the object handle (parse_obj) is used, followed by an ' (apostrophe) and the property or method (with the desired parameters).
Examples:
parse_obj'url$=https://example.com/test/1234?email=xyz4@test.com&testing=123
print parse_obj'site$
print parse_obj'arg$("email")Properties and Methods
The following properties are supported:
| Property | Description |
|---|---|
| url$ | Full URL |
| arg_cnt | Number of arguments present |
| site$ | Website |
| path$ | Path |
| query_str$ | Portion of URL following the ? (question mark) character |
| protocol$ | HTTP or HTTPS |
The following method is supported:
Method | Description |
|---|---|
Arg$(x) | Returns argument values based on either an index value (x) or an argument name (x$). |
Examples
Example 1 - This example is using the following URL:
https://example.com/test/1234?email=xyz@test.com. ->a=new("*obj/ParseUrl")
->a'url$=https://example.com/test/1234?email=xyz@test.com -->print a'site$
example.com
->print a'path$
test/1234 ->print a'protocol$
https ->print a'arg_cnt
1 ->print a'arg$(1) ! Get by index
email=xyz@test.com ->print a'arg$("email") ! Get by name
xyz@test.comExample 2 - This example is using the following URL:
https://example.com/test/1234?email=xyz4@test.com&testing=123 ->a=new("*obj/ParseUrl")
->a'url$="https://example.com/test/1234?email=xyz4@test.com&testing=123" ->print a'arg_cnt
2 ->print a'arg$(1) ! Get by index
email=xyz4@test.com ->print a'arg$("email") ! Get by name
xyz4@test.com ->print a'arg$(2) ! Second arg
testing=123 ->print a'arg$("testing")
123 ->print a'query_str$
email=xyz4@test.com&testing=123