Unicode strings to ASCII ...nicely

8 August 2006   20 comments   Python

Mind that age!

This blog post is 16 years old! Most likely, its content is outdated. Especially if it's technical.


This has been a problem for a long time for me. Whenever someone enters a title in my CMS the id of the document is derived from the title. Spaces are replaced with '- and &' is replaced with and etc. The final thing I wanted to do was to make sure the Id is ASCII encoded when it's saved. My original attempt looked like this:

>>> title = u"Klüft skräms inför på fédéral électoral große"
>>> print title.encode('ascii','ignore')
Klft skrms infr p fdral lectoral groe

But as you can see, a lot of the characters are gone. I'd much rather that a word like "Klüft" is converted to "Kluft" which will be more human readable and still correct. My second attempt was to write a big table of unicode to ascii replacements.

It looked something like this:

u'\xe4': u'a',
u'\xc4': u'A',

Long, awful and not pythonic. Too risky to miss something but the result was good. Now for the final solution which I'm very happy with. It uses a module called unicodedata which is new to me. Here's how it works:

>>> import unicodedata
>>> unicodedata.normalize('NFKD', title).encode('ascii','ignore')
'Kluft skrams infor pa federal electoral groe'

It's not perfect (große should have become grosse) but's only two lines of code.



It's been years since I took any German, but wouldn't 'Klüft' more accurately be saved as 'Klueft'? I recall that 'Küchen' and 'Kuchen' are two different words entirely (Kitchen and Cake, respectively).


How about running replace on the string before normalizing:

title.replace(u'\xdf', 'ss')

and so on for any other special cases.


infidel is right. It could create some form of ambiguity - at least with german words.

Michael Kallas

1) Klüft is not a german word, so don't worry too much.
2) Why do you want to generate ids from the title? This is potentially insecure as I might find a clever way for entering cross-site-scripting that way.
3) If the id should match the title, why does it have to be ascii?


> 2) Why do you want to generate ids from the title? This is potentially insecure as I might find a clever way for entering cross-site-scripting that way.
> 3) If the id should match the title, why does it have to be ascii?


Jonathan Holst

I can also (by test) say, that it doesn't work with Scandinavian letters (æ, ø and å) -- they get ignored completely.

Peter Bengtsson

"på" became "pa"

Jonathan Holst

Well okay, but "Rødgrød med fløde" became "Rdgrd med flde".

Ian Bicking

This might assist, or maybe what you do is sufficiently equivalent:

Victor Stinner

Hi, I wrote a script based on your idea. It transforms number, str and unicode to ASCII: http://www.haypocalc.com/perso/prog/python/any2ascii.py

It takes care of some caracters like "ßøł" (just fill smart_unicode dictionnary ;-)).



Yet another approach:


Peter Bengtsson

Brilliant! Thank you.



Bryan Eastin

Hey, I just wanted to thank you for this page. It was really helpful. I wanted to retain all 8-bit characters, so my solution was more complicated (see http://beastin.livejournal.com/6819.html), but I made use of your example.


This is fantastic stuff - I was having trouble parsing film results where, for example, Rashômon was represented as Rashomon. Testing for both the unicode and ascii normalized strings before iterating to the next result really sealed it. Thanks.


Excelent! It's save my day... really thanks!


when writing about character encodings you want your page encoded properly.

page claims to be encoded in utf-8 but is encoded iso-latin-1

Peter Bengtsson

I know. It's terrible. It's because it's changed over time.

Gilles Lenfant

There's now the "unidecode" package that does all the job http://pypi.python.org/pypi/Unidecode/

>>> from unidecode import unidecode
>>> utext = u"œuf dür"
>>> unidecode(utext)
u'oeuf dur'
>>> from unicodedata import normalize
>>> normalize('NFKD', utext).encode('ascii','ignore')
'uf dur'

A better support for special latin extended characters (French, German) that should tranlitterate to multiple ASCII characters.


Peterbe to the rescue!

Your email will never ever be published.

Related posts