Skip to content
This gem adds String#display_width to get the display size of a string using EastAsianWidth.txt.
Find file
Latest commit 3cba623 @janlelis Release 0.3.1
Failed to load latest commit information.
data update EastAsianWidth index from 7.0 to 8.0
lib/unicode Release 0.3.1
spec specs
.editorconfig add .editorconfig
.gitignore add rake to gemfile and remove Gemfile.lock from repo
.rspec specs
CHANGELOG.txt Release 0.3.1
Gemfile specs
MIT-LICENSE.txt meta file updates
README.rdoc readme tweaks
Rakefile :warning: `*' interpreted as argument prefix



An early draft of a way to determine the size of the characters using EastAsianWidth.txt, based on the very early draft of a Ruby interface to UnicodeData.txt by runpaint.


Install the gem with:

gem install unicode-display_width

or add to your Gemfile:

gem 'unicode-display_width'


require 'unicode/display_width'

The easy way is to use the String#display_width method:

"⚀".display_width #=> 1
'一'.display_width #=> 2

To obtain more detailed character data, you can use the following syntax:

Unicode::DisplayWidth.codepoint( c )

Ambiguous Characters

The display_width method takes an optional argument, which will be used as width for characters defined as “ambigious”. The default value is 1.


Copyright © 2011, 2015 Jan Lelis,, released under the MIT license.

Contains code by runpaint: Copyright © 2009 Run Paint Run Run

Contains EastAsianWidth.txt: Copyright © 1991-2015 Unicode, Inc.


Something went wrong with that request. Please try again.