Redpoint Data Management™ Documentation
Breadcrumbs

HTTP functions

Overview

HTTP functions encode and decode uniform resource identifiers (URLS) and their components.

UrlDecode

Returns text, encoded as uniform resource locator (URL).

Syntax

UrlDecode ( text )

The required argument text must be of type Text.

Remarks

This function translates a text string encoded according to the percent encoding rules into a uniform resource locator (URL). It is the inverse of the UrlEncode function.

Example

The expression http://something.com/my%20stuff/your%2Fstuff returns http://something.com/my stuff/your/stuff.

UrlEncode

Returns text, encoded as uniform resource identifier (URL).

Syntax

UrlEncode ( text )

The required argument text must be of type Text.

Remarks

This function encodes a text string according to the percent encoding rules described at https://en.wikipedia.org/wiki/Percent-encoding. Use this function to encode elements of the path part of a URL not including the / character. Use UrlPathEncode to encode the entire path including the / characters.

Example

The expression "http://something.com/" + UrlEncode("my stuff") + "/" + UrlEncode("your/stuff") returns http://something.com/my%20stuff/your%2Fstuff.

UrlEncodeArguments

Encodes name/value pairs to conform with POST request method.

Syntax

UrlEncodeArguments ( name, value [, name, value ...] )

The required arguments name and value must be of type Text.

Remarks

This function encodes name/value pairs according to the POST form encoding rules described at https://en.wikipedia.org/wiki/POST_(HTTP). Use this function to encode the query component of a URL.

Example

The expression "http://something.com/search?" + UrlEncodeArguments("name", "john smith", "limit", "10") returns http://something.com/search?name=john+smith&limit=10.

UrlPathEncode

Returns text, encoded as uniform resource identifier (URL), but with the slash character intact.

Syntax

UrlPathEncode ( text )

The required argument text must be of type Text.

Remarks

This function encodes a text string according to the percent encoding rules described at https://en.wikipedia.org/wiki/Percent-encoding, except it does not encode the “/” characters. Use this function to encode the path component of a URL.

Example

The expression "http://something.com/" + UrlPathEncode("my stuff/your/stuff") returns http://something.com/my%20stuff/your/stuff.

UrlQueryEncode

Returns text, encoded as uniform resource identifier (URL) but with query components.

Syntax

UrlQueryEncode ( text )

The required argument text must be of type Text.

Remarks

This function encodes a text string according to the percent encoding rules described at https://en.wikipedia.org/wiki/Percent-encoding, except it encodes space characters as + instead of %20. Use this function to encode individual elements of the query component of a URL.

To encode a complete set of name/value pairs in a query part, use the function UrlEncodeArguments instead.

Example

The expression "http://something.com/search?name=" + UrlQueryEncode("john smith, jr.") returns http://something.com/search?name=john+smith%2C+jr..