URLEncode returns the string Value encoded for use within a URL.

This converts special characters, into URL acceptable characters.

This type of encoding is referred to as Percent Encoding, where the special characters are replaced in the string Value as their hexadecimal value, pre-fixed with a percent sign (%).

Declaration: Function URLEncode( Value : String) : String

In the below example, as URLs cannot contain spaces, URL encoding normally replaces a space with a %20 - a space in the file name is translated into ascii 32, which is hex 20. So it would appear as %20. However, a %20 can also be replaced with a plus (+) sign. A plus (+) sign and a %20 mean the same thing - it’s a space.

The index to the Str2 variable result -

  • A space = %20 (or +)

  • An apostrophe (') = %27

  • An asterisk (*) = %2A

  • A shriek (!) = %21

procedure OnMapEvent(var Value:Variant);
var
Str1, Str2 : string;
begin
//Returns 'The+File+Name.pdf'
Str1 := URLEncode('The File Name.pdf'); //returns 'The%20File%20Name.pdf'
LogInfo(Str1);
//Returns 'The+Girl%27s+%2AParty%21.pdf'
Str2 := URLEncode('The Girl''s *Party!.pdf');
LogInfo(Str2);
LogInfo('');
 
end;