How to "URL decode" a string in Emacs Lisp?

I've got a string like "foo%20bar" and I want "foo bar" out of it.

I know there's got to be a built-in function to decode a URL-encoded string (query string) in Emacs Lisp, but for the life of me I can't find it today, either in my lisp/ folder or with google.

Anybody remember what it's called?


org-link-unescape does the job for very simple cases ... w3m-url-decode-string is better, but it isn't built in and the version I have locally isn't working with Emacs 23.


In my case I needed to do this interactively. The previous answers gave me the right functions to call, then it was just a matter of wrapping it a little to make them interactive:

(defun func-region (start end func)
  "run a function over the region between START and END in current buffer."
    (let ((text (delete-and-extract-region start end)))
      (insert (funcall func text)))))

(defun hex-region (start end)
  "urlencode the region between START and END in current buffer."
  (interactive "r")
  (func-region start end #'url-hexify-string))

(defun unhex-region (start end)
  "de-urlencode the region between START and END in current buffer."
  (interactive "r")
  (func-region start end #'url-unhex-string))

Add salt, I mean bind to keys according to taste.

Emacs is shipped with an URL library, that provides a bunch of URL parsing functions—as huaiyuan and Charlie Martin already pointed out. Here is a small example that'd give you an idea how to use it:

(let ((url ""))
  ;; Return list of arguments and values
   ;; Decode hexas
    ;; Retrieve argument list
     ;; Parse URL, return a struct
     (url-generic-parse-url url)))))
=> (("meta" "") ("btnG" "Google+keresés") ("/search?q" "elisp+decode+url"))

I think is better to rely on it than org-mode as it is its main purpose to parse URL.

I think you're making it a little too hard: split-string will probably do most of what you want. For fancier stuff, have a look at the functions in url-expand.el; unfortunately, many of them don't have doc-strings, so you may have to read code.

url-generic-parse-url looks like a potential winner.


 ? NSString URL decode?
 ? Calling UrlDecode in a C# .NET 4.0 Visual Studio 2010 Console Application?
 ? URL parameter Decoding not working
 ? How to decode a 'url-encoded' string in python
 ? How to decode "\u0026" in a URL?
 ? How to organize URLs in django for views handling GET data and parsing URL?
 ? how to decode URL-encoding character (string and array) in php?
 ? Django URL dispatcher not matching named group
 ? Apache: how to double-decode double-encoded incoming URLs
 ? How do I request a single random row from a database in SOQL?