Module: ActiveSupport::Multibyte::Unicode

Relationships & Source Files
Defined in:	activesupport/lib/active_support/multibyte/unicode.rb

Constant Summary

UNICODE_VERSION =

The Unicode version that is supported by the implementation

# File 'activesupport/lib/active_support/multibyte/unicode.rb', line 9
```
RbConfig::CONFIG["UNICODE_VERSION"]
```

Instance Method Summary

#compose(codepoints)

Compose decomposed characters to the composed form.
#decompose(type, codepoints)

Decompose composed characters to the decomposed form.
#tidy_bytes(string, force = false)

Replaces all ISO-8859-1 or CP1252 characters by their UTF-8 equivalent resulting in a valid UTF-8 string.

Instance Attribute Details

#default_normalization_form (rw)

[ GitHub ]

# File 'activesupport/lib/active_support/multibyte/unicode.rb', line 11


def default_normalization_form
  ActiveSupport::Deprecation.warn(
    "ActiveSupport::Multibyte::Unicode.default_normalization_form is deprecated and will be removed in Rails 7.0."
  )
end

#default_normalization_form=(_) (rw)

[ GitHub ]

# File 'activesupport/lib/active_support/multibyte/unicode.rb', line 17


def default_normalization_form=(_)
  ActiveSupport::Deprecation.warn(
    "ActiveSupport::Multibyte::Unicode.default_normalization_form= is deprecated and will be removed in Rails 7.0."
  )
end

Instance Method Details

#compose(codepoints)

Compose decomposed characters to the composed form.

[ GitHub ]

# File 'activesupport/lib/active_support/multibyte/unicode.rb', line 33


def compose(codepoints)
  codepoints.pack("U*").unicode_normalize(:nfc).codepoints
end

#decompose(type, codepoints)

Decompose composed characters to the decomposed form.

[ GitHub ]

# File 'activesupport/lib/active_support/multibyte/unicode.rb', line 24


def decompose(type, codepoints)
  if type == :compatibility
    codepoints.pack("U*").unicode_normalize(:nfkd).codepoints
  else
    codepoints.pack("U*").unicode_normalize(:nfd).codepoints
  end
end

#tidy_bytes(string, force = false)

Replaces all ISO-8859-1 or CP1252 characters by their UTF-8 equivalent resulting in a valid UTF-8 string.

Passing true will forcibly tidy all bytes, assuming that the string’s encoding is entirely CP1252 or ISO-8859-1.

See additional method definition at line 44.

[ GitHub ]

# File 'activesupport/lib/active_support/multibyte/unicode.rb', line 50


def tidy_bytes(string, force = false)
  return string if string.empty? || string.ascii_only?
  return recode_windows1252_chars(string) if force
  string.scrub { |bad| recode_windows1252_chars(bad) }
end