---
name: "WebCommon.urlEncode"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/WebCommon.urlEncode"
---

# WebCommon.urlEncode(3kaya)

URL encode a string

## NAME

WebCommon::urlEncode - URL encode a string

## SYNOPSIS

**String urlEncode(** *String x* **)**

## ARGUMENTS

**x** The string to encode

## DESCRIPTION

URL encode a string. You should use this to encode reserved characters in URLs that you wish to be passed literally.

-

   // trying to pass "http://www.example.com" as a parameter\
    url = "http://localhost/test.cgi?url=";\
    url += urlEncode("http://www.example.com");\
    // url = http://localhost/test.cgi?url=http%3A%2F%2Fwww.example.com

Note that in the example above, encoding the whole URL would be incorrect - that would create a relative URL beginning "http://".

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**WebCommon.urlDecode (3kaya)**