class StTools::String
Public Class Methods
Метод делает заглавной первую букву в словах, разделенных пробелами или дефисом.
@param [String] text исходная строка @return [String] строка с первыми заглавными буквами @example Примеры использования
StTools::String.caps("саНКТ-петеРБург") #=> "Санкт-Петербург"
# File lib/st_tools/string.rb, line 185 def self.caps(text) return nil if text.nil? str = self.downcase(text) str.gsub!(/(^[а-яa-z]|[а-яa-z\s]-[а-яa-z]|[\.\s\_][а-яa-z])/) do |part| part.gsub(/.\b\z/) { |x| self.upcase(x) } end return str rescue return text end
Метод заменяет в исходной строке английские символы, похожие на русские - на соответстующие русские символы. То есть это похоже на ситуацию, когда Google меняет слово, случайно написанное английскими буквами - на русское слово. Одновременно буква 'ё' меняется на 'е'.
@param [String] text текст со смесью английских и русских букв @return [String] текст только с русскими буквами
# File lib/st_tools/string.rb, line 64 def self.delat(text) return nil if text.nil? text.tr('ёЁEeHCcTOoPpAHKXxBM', 'еЕЕеНСсТОоРрАНКХхВМ') end
Метод преобразует строку в нижний регистр с одновременной заменой буквы 'ё' на 'е'. Метод имеет примерно в два раза более высокую производительности по сравнению с традиционным .mb_chars.downcase.to_s, но имеет ограничение - работа только с русскими и английскими строками
@param [String] text строка в произвольном регистре @return [String] строка в нижнем регистре @example Примеры использования
StTools::String.downcase("Hello, Вася!") #=> "hello, вася!"
# File lib/st_tools/string.rb, line 31 def self.downcase(text) if text return text.tr('QWERTYUIOPASDFGHJKLZXCVBNMАБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ', 'qwertyuiopasdfghjklzxcvbnmабвгдеежзийклмнопрстуфхцчшщъыьэюя') end "" end
Метод позволяет показывать клиенту строку в неполном объеме, с закрытием части символов в строке звездочкой. При этом число звездочек в строке определеяется ее длиной. Чем строка дилинее - тем больше в ней звездочек.
@param [String] text строка, которую необходимо закрыть звездочками @return [String] строка, часть символов которой заменена звездочками @example Примеры использования
StTools::String.hide("мы") #=> "мы" StTools::String.hide("москва") #=> "мо*ква" StTools::String.hide("длиннаяфраза") #=> "дли**аяфраза" StTools::String.hide("просто произвольная фраза") #=> "**осто пр*извол*н*я фраза"
# File lib/st_tools/string.rb, line 101 def self.hide(text) return nil if text.nil? len = text.length - 3 0.upto((len / 4).to_i) do pos = rand(len) text[pos, 1] = '*' end return text end
Метод проводит нормализацию строки для последующей машиной обработки. При этом осуществляется:
-
убирается букву 'ё'
-
перевод строку в нижний регистр
-
замена случайно введенных английских букв на русские
-
убираются лидирующие и завершающие пробелы
-
в строке удаляются повторные пробелы между словами
@param [String] text строка, введенная пользователям @param [Boolean] delat флаг необходимости проводить де-латинизацию. По умолчанию - false @return [String] строка без 'ё', в нижнем регистре, без английских букв @example Примеры использования
StTools::String.normalize(" Ёлки- ПАЛКИ") #=> "елки- палки" StTools::String.normalize("Ee", delat: true) #=> "ее" (русские буквы) StTools::String.normalize("Ee") #=> "ee" (латинские буквы)
# File lib/st_tools/string.rb, line 84 def self.normalize(text, delat: false) return nil if text.nil? || text.empty? out = delat ? self.delat(text) : text.gsub('ё', 'е').gsub('Ё', 'Е') self.downcase(out).strip.gsub(/[\s\t\u00A0]{1,100}/, ' ') end
Метод преобразует список Array в строку перечисление вида “это, это и это”. Метод позволяет делать перечсиелние на разных языках, использовать частицы 'и' и 'или', а также оформлять список тегами HTML.
@param [Array] items массив значений для оформления в виде списка @param [String] separator знак разделитель, по умолчанию запятая (',') @param [Sym] union признак частицы, если указать :and, то будет использована частица 'и', либо 'или' в других случаях @param [String] pretag открывающий тег HTML для обрамления элементов списка @param [String] afttag закрывающий тег HTML для обрамления элементов списка
@return [String] конвертированная строка @example Примеры использования
StTools.configure { |config| config.locale = :ru } StTools::String.pretty_list([1,2]) #=> "1 и 2" StTools::String.pretty_list([1,2,4]) #=> "1, 2 и 4" StTools::String.pretty_list([1,2,3,4], union: :or) #=> "1, 2, 3 или 4"
# File lib/st_tools/string.rb, line 242 def self.pretty_list(items, separator: ',', union: :and, pretag: '', afttag: '') return '' if items.nil? || items.empty? return "#{pretag}#{items.first}#{afttag}" if items.count == 1 out = Array.new last = items.last arr = items[0, items.count - 1] arr.each do |one| out << "#{pretag}#{one}#{afttag}" out << separator + ' ' end out.pop case union when :and out << " #{I18n.t('st_tools.pretty_list.and', locale: StTools.configuration.locale)} " else out << " #{I18n.t('st_tools.pretty_list.or', locale: StTools.configuration.locale)} " end out << "#{pretag}#{last}#{afttag}" out.join end
Метод обрезает строку и добавляет в случае обрезания строки многоточие
@param [Object] text строка для обрезания @param [Object] length необходимая длина строки С УЧЕТОМ окончания (многоточия) @param [Object] words если true, то не будет слов “разрезанных” на части. По умолчанию false @param [Object] endwith завершающее многоточие (по умолчанию '…') @return [String] сокращенная строка строка @example Примеры использования
StTools::String.prune("1234567890", 20) #=> "1234567890" StTools::String.prune("1234567890", 8) #=> "12345..." StTools::String.prune("1234567890", 8, endwidth: '---') #=> "12345---" StTools::String.prune("Привет мир!", 12) #=> "Привет ми..." StTools::String.prune("Привет мир!", 12, words: true) #=> "Привет..."
# File lib/st_tools/string.rb, line 277 def self.prune(text, length, words: false, endwith: '...') return '' if text.nil? || text == '' return text if text.length <= length return text[0, length] if length <= endwith.length out = text.strip[0, length - endwith.length] out.gsub!(/\s[^\s]+?\z/, '') if words out.strip + endwith end
Метод аналогичен обычной функции split, однако дополнительно может выполнять следующие действия:
-
strip каждого элемента
-
normalize соответсвующей функцией (normalize)
-
сортировка в прямом порядке
-
удаление дубликотов
@param [String] text исходная строка @param [String] separator сепаратор (по умолчанию нет - необходимо явное указание) @param [Hash] opts опции преобразования @option opts [Boolean] :normalize - применить к каждому элементу массива функцию normalize @option opts [Boolean] :sort - сортировать выходной массив @option opts [Boolean] :uniq - удалить из массива дубликаты @return [Array] массив элементов из строки @example Примеры использования
StTools::String.split("саша, Паша, ТАНЯ, Алина", ',') #=> ["саша", "Паша", "ТАНЯ", "Алина"] StTools::String.split("саша, Паша, ТАНЯ, Алина", ',', normalize: true) #=> ["саша", "паша", "таня", "алина"] StTools::String.split("саша, Паша, ТАНЯ, Алина", ',', normalize: true, sort: true) #=> ["алина", "паша", "саша", "таня"] StTools::String.split("саша, Паша, ТАНЯ, Алина, таня", ',', normalize: true, sort: true, uniq: true) #=> ["алина", "паша", "саша", "таня"]
# File lib/st_tools/string.rb, line 130 def self.split(text, separator, opts = {}) return [] if text.nil? out = text.split(separator) out.map! { |x| x.strip } out.map! { |x| self.normalize(x) } if opts[:normalize] out.uniq! if opts[:uniq] out.sort! if opts[:sort] return out rescue return [] end
Метод конвертирует строку в тип boolean
@param [String] text исходная строка, содержащая 'true/false', 'on/off', '1/0' @param [Boolean] default значение по умолчанию для строк, имеющих значение nil @return [Boolean] true или false @example Примеры использования
StTools::String.to_bool("True") #=> true StTools::String.to_bool("trUE") #=> true StTools::String.to_bool("on") #=> true StTools::String.to_bool("1") #=> true StTools::String.to_bool("Да") #=> true StTools::String.to_bool("Yes") #=> true StTools::String.to_bool("false") #=> false StTools::String.to_bool("fALse") #=> false StTools::String.to_bool("oFF") #=> false StTools::String.to_bool("0") #=> false StTools::String.to_bool(nil, true) #=> true StTools::String.to_bool(nil, false) #=> false params = { opt1: true } StTools::String.to_bool(params[:opt1], false) #=> true StTools::String.to_bool(params[:opt2], true) #=> true
# File lib/st_tools/string.rb, line 219 def self.to_bool(text, default = false) return default if text.nil? return true if ['true', 'on', '1', 'да', 'yes'].include?(self.downcase(text.to_s)) false end
Метод преобразует строковое выражение в число с плавающей запятой. При этом метод корректно преобразует числа вида “12.34” и “12,34”, то есть с точкой и запятой (но будет некорректный результат в случае американских чисел, где запятая - разделитель тысяч, а не дробная часть).
@param [String, Float, Integer] text строка или число, которое нужно преобразовать в Float @param [Integer] round число цифр после запятой при округлении. По умолчанию - 6 @param [Object] stop если true, то при ошибке будет выброшен “Exception”, иначе при ошибках будет возвращаться “0”. По умолчанию - true. @return [Float] число с плавающей запятой @example Примеры использования
StTools::String.to_float('123.45678') #=> 123.45678 StTools::String.to_float('123.474565', round: 2) #=> 123.47 StTools::String.to_float('123,474565', round: 2) #=> 123.47 StTools::String.to_float(' 123,47456564', round: 2) #=> 123.47 StTools::String.to_float(' 10 123,47456', round: 2) #=> 10123.47 StTools::String.to_float(' - 10 123,474565', round: 2) #=> -10123.47 StTools::String.to_float(nil, round: 2) rescue 'fail') #=> "fail" StTools::String.to_float(nil, round: 2, stop: false) rescue 'fail') #=> 0 StTools::String.to_float(145.5667, round: 2) #=> 145.57 StTools::String.to_float(23, round: 2) #=> 23
# File lib/st_tools/string.rb, line 307 def self.to_float(text, round: 6, stop: true) # http://stackoverflow.com/questions/1034418/determine-if-a-string-is-a-valid-float-value if text.nil? stop ? (raise TypeError, "can't convert nil into Float") : (return 0) end if text.is_a?(::Float) || text.is_a?(::Integer) return text.to_f.round(round) end if text.is_a?(::String) str = text.strip.gsub(/\,/, '.').gsub(/\s/, '') if str.match(/\A\s*[+-]?((\d+_?)*\d+(\.(\d+_?)*\d+)?|\.(\d+_?)*\d+)(\s*|([eE][+-]?(\d+_?)*\d+)\s*)\z/) begin return str.to_f.round(round) rescue Exception => e stop ? (raise ArgumentError, "invalid value for Float(): #{str.inspect}") : (return 0) end end end stop ? (raise ArgumentError, "invalid value for Float(): #{text.inspect}") : (return 0) end
Метод возвращает полный массив Array [1, 4, 5, 6, 7, 456] для строк вида '1, 4, 5-7, 456'. Дополнительно осуществляется:
-
сортировка в прямом порядке
-
удаление дубликотов
@param [String] text исходная строка @param [Hash] opts @option opts [Boolean] :sort - сортировать выходной массив @option opts [Boolean] :uniq - удалить из массива дубликаты @return [Array] массив чисел @example Примеры использования
StTools::String.to_range("1, 4, 5-7, 456, 6") #=> [1, 4, 5, 6, 7, 456, 6] StTools::String.to_range("1, 4, 5-7, 456, 6", sort: true) #=> [1, 4, 5, 6, 6, 7, 456] StTools::String.to_range("1, 4, 5-7, 456, 6", sort: true, uniq: true) #=> [1, 4, 5, 6, 7, 456]
# File lib/st_tools/string.rb, line 158 def self.to_range(text, opts = {}) return [] if text.nil? out = Array.new tmp = self.split(text, ',') tmp.each do |one| if one.match(/\-/) d = one.split(/\-/) out += Range.new(d.first.to_i, d.last.to_i).to_a else out << one.to_i end end out.uniq! if opts[:uniq] out.sort! if opts[:sort] return out end
Метод преобразует текст в транслит
@param [String] text исходная строка с русскими буквами @return [String] строка в транслите @example Примеры использования
StTools::String.translit("Жмеринка") #=> "Zhmerinka"
# File lib/st_tools/string.rb, line 10 def self.translit(text) return nil if text.nil? translited = text.tr('абвгдеёзийклмнопрстуфхэыь', 'abvgdeezijklmnoprstufhey\'\'') translited = translited.tr('АБВГДЕЁЗИЙКЛМНОПРСТУФХЭЫЬ', 'ABVGDEEZIJKLMNOPRSTUFHEY\'\'') translited = translited.gsub(/[жцчшщъюяЖЦЧШЩЪЮЯ]/, 'ж' => 'zh', 'ц' => 'ts', 'ч' => 'ch', 'ш' => 'sh', 'щ' => 'sch', 'ъ' => '', 'ю' => 'ju', 'я' => 'ja', 'Ж' => 'Zh', 'Ц' => 'Ts', 'Ч' => 'Ch', 'Ш' => 'Sh', 'Щ' => 'Sch', 'Ъ' => '', 'Ю' => 'Ju', 'Я' => 'Ja') translited.gsub('\'', '') end
Метод преобразует строку в верхний регистр с одновременной заменой буквы 'Ё' на 'Е'. Метод имеет примерно в два раза более высокую производительности по сравнению с традиционным .mb_chars.downcase.to_s, но имеет ограничение - работа только с русскими и английскими строками
@param [String] text строка в произвольном регистре @return [String] строка в верхнем регистре @example Примеры использования
StTools::String.upcase("Hello, Вася!") #=> "HELLO, ВАСЯ!"
# File lib/st_tools/string.rb, line 48 def self.upcase(text) if text return text.tr('qwertyuiopasdfghjklzxcvbnmабвгдеёжзийклмнопрстуфхцчшщъыьэюя', 'QWERTYUIOPASDFGHJKLZXCVBNMАБВГДЕЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ') end "" end