Tinderbox v9 Icon

urlEncode(dataStr)


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Last Altered: 

 Function  [other Function type actions]

 Item  [operators of similar scope]

 Formatting  [other Formatting operators]

 Baseline

 9.7.0


urlEncode(dataStr)

urlEncode() converts a dataStr string to 'urlEncoded' form for for the web, in accordance with RFC1738. URLs should not contain spaces, control characters, or non-ASCII characters. Characters that are illegal in URLs are encoded as '%' followed by the corresponding hexadecimal character code, e.g. space = %20.

dataStr should be a quoted literal string or a reference to a string value.

From v9.7.0, the characters ? and / are now percent-encoded by urlEncode(), e.g. as %3F and %2F. Even though these are now permitted in the query portion of URLs, the Apple NSURL used by Tinderbox balks at their presence.