Module: JSON::Pure::Generator::GeneratorMethods::String

Defined in:
lib/json/pure/generator.rb

Defined Under Namespace

Modules: Extend

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(modul) ⇒ Object

Extends modul with the String::Extend module.



541
542
543
# File 'lib/json/pure/generator.rb', line 541

def self.included(modul)
  modul.extend Extend
end

Instance Method Details

#to_json(state = nil, *args) ⇒ Object

This string should be encoded with UTF-8 A call to this method returns a JSON string encoded with UTF16 big endian characters as u????.



512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
# File 'lib/json/pure/generator.rb', line 512

def to_json(state = nil, *args)
  state = State.from_state(state)
  if encoding == ::Encoding::UTF_8
    unless valid_encoding?
      raise GeneratorError, "source sequence is illegal/malformed utf-8"
    end
    string = self
  else
    string = encode(::Encoding::UTF_8)
  end
  if state.ascii_only?
    %("#{JSON.utf8_to_json_ascii(string, state.script_safe)}")
  else
    %("#{JSON.utf8_to_json(string, state.script_safe)}")
  end
end

#to_json_raw(*args) ⇒ Object

This method creates a JSON text from the result of a call to to_json_raw_object of this String.



558
559
560
# File 'lib/json/pure/generator.rb', line 558

def to_json_raw(*args)
  to_json_raw_object.to_json(*args)
end

#to_json_raw_objectObject

This method creates a raw object hash, that can be nested into other data structures and will be unparsed as a raw string. This method should be used, if you want to convert raw strings to JSON instead of UTF-8 strings, e. g. binary data.



549
550
551
552
553
554
# File 'lib/json/pure/generator.rb', line 549

def to_json_raw_object
  {
    JSON.create_id  => self.class.name,
    'raw'           => self.unpack('C*'),
  }
end