diff options
Diffstat (limited to 'jni/ruby/lib/unicode_normalize.rb')
-rw-r--r-- | jni/ruby/lib/unicode_normalize.rb | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/jni/ruby/lib/unicode_normalize.rb b/jni/ruby/lib/unicode_normalize.rb new file mode 100644 index 0000000..e79f41d --- /dev/null +++ b/jni/ruby/lib/unicode_normalize.rb @@ -0,0 +1,78 @@ +# coding: utf-8 + +# Copyright Ayumu Nojima (野島 歩) and Martin J. Dürst (duerst@it.aoyama.ac.jp) + +# additions to class String for Unicode normalization +class String + # === Unicode Normalization + # + # :call-seq: + # str.unicode_normalize(form=:nfc) + # + # Returns a normalized form of +str+, using Unicode normalizations + # NFC, NFD, NFKC, or NFKD. The normalization form used is determined + # by +form+, which is any of the four values :nfc, :nfd, :nfkc, or :nfkd. + # The default is :nfc. + # + # If the string is not in a Unicode Encoding, then an Exception is raised. + # In this context, 'Unicode Encoding' means any of UTF-8, UTF-16BE/LE, + # and UTF-32BE/LE, as well as GB18030, UCS_2BE, and UCS_4BE. Anything + # else than UTF-8 is implemented by converting to UTF-8, + # which makes it slower than UTF-8. + # + # _Examples_ + # + # "a\u0300".unicode_normalize #=> 'à' (same as "\u00E0") + # "a\u0300".unicode_normalize(:nfc) #=> 'à' (same as "\u00E0") + # "\u00E0".unicode_normalize(:nfd) #=> 'à' (same as "a\u0300") + # "\xE0".force_encoding('ISO-8859-1').unicode_normalize(:nfd) + # #=> Encoding::CompatibilityError raised + # + def unicode_normalize(form = :nfc) + require 'unicode_normalize/normalize.rb' unless defined? UnicodeNormalize + ## The following line can be uncommented to avoid repeated checking for + ## UnicodeNormalize. However, tests didn't show any noticeable speedup + ## when doing this. This comment also applies to the commented out lines + ## in String#unicode_normalize! and String#unicode_normalized?. + # String.send(:define_method, :unicode_normalize, ->(form = :nfc) { UnicodeNormalize.normalize(self, form) } ) + UnicodeNormalize.normalize(self, form) + end + + # :call-seq: + # str.unicode_normalize!(form=:nfc) + # + # Destructive version of String#unicode_normalize, doing Unicode + # normalization in place. + # + def unicode_normalize!(form = :nfc) + require 'unicode_normalize/normalize.rb' unless defined? UnicodeNormalize + # String.send(:define_method, :unicode_normalize!, ->(form = :nfc) { replace(unicode_normalize(form)) } ) + replace(unicode_normalize(form)) + end + + # :call-seq: + # str.unicode_normalized?(form=:nfc) + # + # Checks whether +str+ is in Unicode normalization form +form+, + # which is any of the four values :nfc, :nfd, :nfkc, or :nfkd. + # The default is :nfc. + # + # If the string is not in a Unicode Encoding, then an Exception is raised. + # For details, see String#unicode_normalize. + # + # _Examples_ + # + # "a\u0300".unicode_normalized? #=> false + # "a\u0300".unicode_normalized?(:nfd) #=> true + # "\u00E0".unicode_normalized? #=> true + # "\u00E0".unicode_normalized?(:nfd) #=> false + # "\xE0".force_encoding('ISO-8859-1').unicode_normalized? + # #=> Encoding::CompatibilityError raised + # + def unicode_normalized?(form = :nfc) + require 'unicode_normalize/normalize.rb' unless defined? UnicodeNormalize + # String.send(:define_method, :unicode_normalized?, ->(form = :nfc) { UnicodeNormalize.normalized?(self, form) } ) + UnicodeNormalize.normalized?(self, form) + end +end + |