Bernhard at 10:49, 9 September 2007

2007-09-09T10:49:45Z

WikiSysop: imported from WiKit id 694

2004-06-14T15:29:48Z

imported from WiKit id 694

New page

Man page: http://aolserver.com/docs/tcl/ns_urldecode.html

----

'''NAME'''

: ns_urldecode - URL decoding

'''SYNOPSIS'''

: '''ns_urldecode''' ''?-charset charset? data''

'''DESCRIPTION'''

: This command decodes a string according to the rules for URL encoding defined in [http://www.faqs.org/rfcs/rfc1738.html RFC 1738, Uniform Resource Locators (URL)]. Essentially, each non-alphanumeric byte is converted to its hexadecimal representation, prepended with a percent sign.

: The optional '''-charset''' ''charset'' parameter defines the character set of the encoded string. If not specified, the default is "utf-8".

'''EXAMPLES'''

% ns_urldecode http%3a%2f%2fwww%2eaolserver%2ecom%2f
http://www.aolserver.com/

% set data [[ns_urlencode [format %c 0xe9]]] ;# 0xe9 is the iso8859-1 for lowercase accented 'e'
%c3%a9

% string length [[ns_urldecode -charset utf-8 $data]]
1

% string length [[ns_urldecode -charset iso8859-1 $data]]
2

'''SEE ALSO'''

: [[ns_urlencode]]

----

[[Category Documentation]] - [[Category Core Tcl API]]

@@ Line 22: / Line 22: @@
      http://www.aolserver.com/
-    % set data [[ns_urlencode [format %c 0xe9]]]    ;# 0xe9 is the iso8859-1 for lowercase accented 'e'
+The character &#233; lowercase 'e' accent is represented by the byte e9 in iso8859-1 but in utf-8 by the two bytes c3 and a9.
-     % string length [[ns_urldecode -charset utf-8 $data]]
+     % ns_urldecode -charset iso8859-1 %e9
+    % &#233;
-     % string length [[ns_urldecode -charset iso8859-1 $data]]
+Using the wrong charset may lead to errors. If one (two byte) utf-8 character was decoded using iso8859-1 it would result in two incorrect characters.
-−
 '''SEE ALSO'''

Ns urldecode - Revision history

Bernhard at 10:49, 9 September 2007

WikiSysop: imported from WiKit id 694