diff --git a/docs/dictionary/function/URLDecode.lcdoc b/docs/dictionary/function/URLDecode.lcdoc index 39e40fd2da6..5fd0a6f85c5 100644 --- a/docs/dictionary/function/URLDecode.lcdoc +++ b/docs/dictionary/function/URLDecode.lcdoc @@ -41,13 +41,25 @@ the next two characters as digits. (If one of the number is converted to its equivalent, using the currently in use. +>*Note:* Non-ASCII characters, such as Unicode, that appear in the URL +> string to be decoded will have been encoded as UTF-8 (as per standard +> convention), requiring the use of the +> after urlDecode. For example, the following code: + + local tEncodedText + put "%D1%81%D0%BA%D0%BE%D1%80%D0%BE%D1%81%D1%88%D0%B8%D0" & \ + "%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C" into tCodedText + put textDecode(urlDecode(tEncodedText),"UTF-8") + +> produces the word "скоросшиватель". + References: post (command), function (control structure), decompress (function), macToISO (function), arrayDecode (function), -charToNum (function), baseConvert (function), decode (glossary), -return (glossary), sign (glossary), encode (glossary), +charToNum (function), baseConvert (function), textDecode (function), +decode (glossary), return (glossary), sign (glossary), encode (glossary), character set (glossary), hexadecimal (glossary), server (glossary), -URL (keyword), characters (keyword), character (keyword), http (keyword), -httpHeaders (property) +function (glossary), URL (keyword), characters (keyword), +character (keyword), http (keyword), httpHeaders (property) Tags: networking diff --git a/docs/notes/bugfix-22341.md b/docs/notes/bugfix-22341.md new file mode 100644 index 00000000000..1587422173d --- /dev/null +++ b/docs/notes/bugfix-22341.md @@ -0,0 +1 @@ +# Added a note to the URLDecode entry that non-ASCII output must be put through textDecode