url|null url( path, secure, app )

Description:

Retrieve a URL object.

Parameters:

path

Path of the site URL to retrieve. Defaults to the current URL for the page being rendered.

secure

Set to true to retrieve the secure site's version of the requested URL. Defaults to false.

app

Retrieves the first URL associated with an app. The 'path' parameter will be ignored if this parameter is specified.

Return:

A URL object for the requested path or app, or null if no such URL could be found.