textutils.urlEncode

From ComputerCraft Wiki
Revision as of 18:44, 18 January 2013 by TheOriginalBIT (Talk | contribs) (added outputs)

Jump to: navigation, search


Grid Redstone.png  Function textutils.urlEncode
Replaces certain characters in a string to make it safe for use on the internet. Note that it is a string function and will even replace characters that are allowed in URLs. Use this only for text to be inserted in an URL, not the URL itself.
Syntax textutils.urlEncode(string)
Returns A string safe for use on the internet
Part of ComputerCraft
API textutils

Examples

Grid paper.png  Example
Create a safe string from another string full of invalid characters. This is incorrect usage!
Code
sUnsafe = "http://example.com/?view=€ @!! 3-g_dvv[gf"
sSafe = textutils.urlEncode(sUnsafe)
print(sSafe)
Output http%3A%2F%2Fexample%2Ecom%2F%3Fview%3D?0%9AŒ87´A8+%40%21%21+3%2Dg%5Fdvv%5Bgf



Grid paper.png  Example
Create a safe URL from a base URL and a string to be inserted.
Code
sUnsafe = "€ @!! 3-g_dvv[gf"
sBaseURL = "http://example.com/?view="
sSafe = textutils.urlEncode(sUnsafe)
sURL = sBaseURL .. sSafe
print(sURL)
Output http://example.com/?view=Œ84+%40%21%21+3%2Dg%5Fdvv%5Bgf