chinese_truncate 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fb28787286211d2b72e68d5a5c43e966f55984d9
+  data.tar.gz: c41bab064360ef13137cfa8dfb970c3e98185a7e
+SHA512:
+  metadata.gz: 9f1b90a9bdef8cfb1a1a0020d77fcbac57d474e871a251280d0f56d6ebc96920ce6d0e6b87b3843d247b0fa09af7e0cf0eb660a952f40e4377f9d5a5ec34f593
+  data.tar.gz: 99dcff60127119d6154a9531fab28d5ce47b9a00e88f05c9fa56a823fcdb3b64cf658442ac4d12721e07449e8ffba3da92f87e88c31f093e804114f8dfccad17

data/README.md

@@ -0,0 +1,37 @@
+# chinese_truncate
+
+helper method for truncate chinese string. 1 chinese word = 2 byte.
+
+## Install
+
+```sh
+$ gem install chinese_truncate
+```
+
+## Usage
+
+``` ruby
+
+require 'chinese_truncate'
+
+str = "中文 a和d english"
+
+puts str.chinese_size                         # => 9
+
+puts str.chinese_bytesize                     # => 17
+
+puts str.is_chinese_shorter(8)                # => false
+
+puts str.is_chinese_longer(8)                 # => 13 (not true)
+
+puts str.chinese_truncate(8)                  # => 中文 a和d eng...
+
+puts str.chinese_truncate(8, omission:'???')  # => 中文 a和d eng???
+
+puts str.chinese_truncate(8, omission:false)  # => 中文 a和d englis
+
+puts str.chinese_truncate(9)                  # => 中文 a和d english
+
+puts str.chinese_truncate(10)                 # => 中文 a和d english
+
+```

data/chinese_truncate.gemspec

@@ -0,0 +1,20 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sinarey_cache/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "chinese_truncate"
+  spec.version       = "1.0.0"
+  spec.authors       = ["Jeffrey"]
+  spec.email         = ["jeffrey6052@163.com"]
+  spec.description   = "helper method for truncate chinese string. 1 chinese word = 2 byte."
+  spec.summary       = ""
+  spec.homepage      = "https://github.com/jeffrey6052/chinese_truncate"
+  spec.license       = "MIT"
+
+  spec.files         = ['lib/chinese_truncate.rb',
+                        'test/chinese_truncate.rb',
+                        'chinese_truncate.gemspec',
+                        'README.md']
+end

data/lib/chinese_truncate.rb

@@ -0,0 +1,67 @@
+class String
+
+  #中文字符串字数 > 指定字数
+  def is_chinese_longer(sum, omission_bytesize=0)
+    bsize = sum * 2
+    tsize = bsize - omission_bytesize
+    l = i = 0
+    out = nil
+    is_longer = false
+    self.each_char do |word|
+      w = word.bytesize>1 ? 2 : 1
+      xsize = l + w
+      if xsize > tsize
+        out ||= i
+        if xsize > bsize
+          is_longer = true
+          break
+        end
+      end
+
+      i += 1
+      l += w
+    end
+
+    is_longer && out
+  end
+
+  #中文字符串字数 <= 指定字数
+  def is_chinese_shorter(sum)
+    !is_chinese_longer(sum)
+  end
+
+  #中文字符串字符数
+  def chinese_bytesize
+    self.each_char.inject(0) do |sum,word|
+      w = word.bytesize>1 ? 2 : 1
+      sum += w
+    end
+  end
+
+  #中文字符串字数
+  def chinese_size
+    sum,remain = self.chinese_bytesize.divmod(2)
+    sum += 1 if remain > 0
+    sum
+  end
+
+  #中文字符串截取
+  def chinese_truncate(truncate_at, options = {})
+    if (omission = options[:omission])
+      ol = omission.chinese_bytesize
+    elsif omission==false
+      omission = ''
+      ol = 0
+    else
+      omission = '...'
+      ol = 3
+    end
+    if i = self.is_chinese_longer(truncate_at,ol)
+      head = self[0, i]
+      head + omission
+    else
+      self
+    end
+  end
+
+end

data/test/chinese_truncate.rb

@@ -0,0 +1,26 @@
+
+$:.unshift File.expand_path("../lib", __dir__)
+
+require 'chinese_truncate'
+
+str = "中文 a和d english"
+
+puts str.chinese_size                         # => 9
+
+puts str.chinese_bytesize                     # => 17
+
+puts str.is_chinese_shorter(8)                # => false
+
+puts str.is_chinese_longer(8)                 # => 13 (not true)
+
+puts str.chinese_truncate(8)                  # => 中文 a和d eng...
+
+puts str.chinese_truncate(8, omission:'???')  # => 中文 a和d eng???
+
+puts str.chinese_truncate(8, omission:false)  # => 中文 a和d englis
+
+puts str.chinese_truncate(9)                  # => 中文 a和d english
+
+puts str.chinese_truncate(10)                 # => 中文 a和d english
+
+

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: chinese_truncate
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeffrey
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-06 00:00:00.000000000 Z
+dependencies: []
+description: helper method for truncate chinese string. 1 chinese word = 2 byte.
+email:
+- jeffrey6052@163.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/chinese_truncate.rb
+- test/chinese_truncate.rb
+- chinese_truncate.gemspec
+- README.md
+homepage: https://github.com/jeffrey6052/chinese_truncate
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: ''
+test_files: []