Please enable JavaScript to view this site.

A-Shell Reference

Navigation: Subroutines > CGIUTL

Unescape URI-Encoded String

Scroll Prev Top Next More

Updated November 2025

xcall CGIUTL, CGIOP_UNESCAPE, in, out, status

Opcode 9, CGIOP_UNESCAPE, is a utility function—not limited to CGI programs—used to convert URI-encoded (or percent-encoded) strings to the ASCII equivalent. This type of encoding is primarily used for URLs and URIs (e.g. web addresses) and consists of replacing certain special characters (primarily "!#$&'()*+,/:;=?@[] ") with %xx where xx is the hex value of the original ASCII byte code. Although those are typically the only characters encoded this way in URI's, the function converts all %xx sequences to the equivalent raw ASCII characters. In addition, it will convert any "+" appearing after an initial "?" to a space (since query parameters appended to URLs start with "?" and usually replace any spaces with "+".

Parameters

in (String)  [in]  

URI-encoded string to unescape

out  (String)  [out]

receives the output , dynamic string ok

status (Num)  [out]

returns a status code (0 for ok)

See Also