Oracle UTL_URL
Version 18.3.0.1

General Information
Library Note Morgan's Library Page Header
Coming to OpenWorld 2018? Be sure to visit the TidalScale booth in Moscone South and learn how to solve performance problems and lower costs with Software Defined Servers. Before you visit the booth, or if you can't make it this year, check out TidalScale at www.tidalscale.com. Be sure to click on the Solutions link and look through the Oracle resources.
Purpose Escape/Unescape URLs
AUTHID DEFINER
Dependencies
DBMS_ISCHED SPARQL_SERVICE_IMPL_T UTL_HTTP
DBMS_ISCHED_REMOTE_ACCESS URIFACTORY UTL_URL_LIB
SDO_RDF    
Documented Yes
Exceptions
Error Code Reason
ORA-29262 BAD_URL: The URL contains badly formed escape code sequences
ORA-29274 BAD_FIXED_WIDTH_CHARSET: Fixed-width multibyte character set not allowed as a URL character set
First Available 9.0.1
Security Model Owned by SYS with EXECUTE granted to PUBLIC
Source {ORACLE_HOME}/rdbms/admin/utlurl.sql
Subprograms
 
ESCAPE
Returns a URL with illegal characters (and optionally reserved characters) escaped using the %2-digit-hex-code format utl_url.escape(
url                   IN VARCHAR2 CHARACTER SET ANY_CS,
escape_reserved_chars IN BOOLEAN DEFAULT FALSE,
url_charset           IN VARCHAR2 DEFAULT utl_http.get_body_charset)
RETURN VARCHAR2 CHARACTER SET url%CHARSET;
SQL> SELECT utl_url.escape('http://www.mlib.com/a url with space.html')
  2  FROM dual;

UTL_URL.ESCAPE('HTTP://WWW.MLIB.COM/AURLWITHSPACE.HTML')
---------------------------------------------------------
http://www.acme.com/a%20url%20with%20space.html
 
UNESCAPE
This function unescapes the escape character sequences to its original form in a URL, to convert the %XX escape character sequences to the original characters. utl_url.escape(
url         IN VARCHAR2 CHARACTER SET ANY_CS,
url_charset IN VARCHAR2 utl_http.get_body_charset)
RETURN VARCHAR2 CHARACTER SET url%CHARSET;
SQL> SELECT utl_url.unescape('http://www.mlib.com/a%20url%20with%20space.html')
  2  FROM dual;

UTL_URL.UNESCAPE('HTTP://WWW.MLIB.COM/A%20URL%20WITH%20SPACE.HTML')
--------------------------------------------------------------------
http://www.mlib.com/a url with space.html

Related Topics
Built-in Functions
Built-in Packages
UTL_HTTP
UTL_INADDR
What's New In 12cR2
What's New In 18cR3

Morgan's Library Page Footer
This site is maintained by Dan Morgan. Last Updated: This site is protected by copyright and trademark laws under U.S. and International law. © 1998-2017 Daniel A. Morgan All Rights Reserved