= hanzi_to_pinyin

translate chinese to pinyin, fetch first letter OR full pinyin

== Install

rails3

  $ gem 'hanzi_to_pinyin', '0.8.0', require: 'hanzi_to_pinyin'
or latest develop version
  $ gem 'hanzi_to_pinyin', git: 'git://github.com/wxianfeng/hanzi_to_pinyin.git'
or freeze ref version
  $ gem 'hanzi_to_pinyin', git: 'git://github.com/wxianfeng/hanzi_to_pinyin.git', ref: 5fa43b0

== Usage

  $ HanziToPinyin.hanzi_to_pinyin("中华人民共和国") => "zhrmghg"
  $ HanziToPinyin.hanzi_2_pinyin("中华人民共和国") => "zhrmghg"
  $ HanziToPinyin.hanzi_to_pinyin("喜欢Ruby") => "xhruby"
  $ HanziToPinyin.hanzi_2_pinyin("喜欢Ruby") => "xhruby"

  $ HanziToPinyin.is_hanzi?("你") => true
  $ HanziToPinyin.is_hanzi?("a") => false

  # 多音字,分隔 字字之间;分隔,字母丢弃
  $ HanziToPinyin.hanzi_2_py("我们") => "wo;men"
  $ HanziToPinyin.hanzi_2_py("查理Smith") => "cha,zha;li"
  $ HanziToPinyin.hanzi_2_py("测试1") => "ce;shi;1"
  $ HanziToPinyin.hanzi_2_py("测_试") => "ce;_;shi"
  $ HanziToPinyin.hanzi_2_py("测-试").should == "ce;-;shi"

  $ HanziToPinyin.is_number?("1".ord) => true
  $ HanziToPinyin.is_number?("a".ord) => false

  $ HanziToPinyin.is_underline?("_".ord).should be_true
  $ HanziToPinyin.is_underline?("豆豆").should be_false
  $ HanziToPinyin.is_dash?("-".ord).should be_true

== Test
  $ rake spec
or spec one case
  $ rspec spec/hanzi_to_pinyin/hanzi_to_pinyin_spec.rb -l 21

== Copyright

Copyright (c) 2011 wxianfeng. See LICENSE.txt for
further details.