class Complex - json: Ruby Standard Library Documentation

# class Complex

### Public Class Methods

json_create(object) click to toggle source

See `as_json`.

    # File json/lib/json/add/complex.rb, line 9
    def self.json_create(object)
      Complex(object['r'], object['i'])
    end

### Public Instance Methods

as_json(*) click to toggle source

Methods `Complex#as_json` and `Complex.json_create` may be used to serialize and deserialize a Complex object; see Marshal.

Method `Complex#as_json` serializes `self`, returning a 2-element hash representing `self`:

    require 'json/add/complex'
    x = Complex(2).as_json      # => {"json_class"=>"Complex", "r"=>2, "i"=>0}
    y = Complex(2.0, 4).as_json # => {"json_class"=>"Complex", "r"=>2.0, "i"=>4}

Method `JSON.create` deserializes such a hash, returning a Complex object:

    Complex.json_create(x) # => (2+0i)
    Complex.json_create(y) # => (2.0+4i)

    # File json/lib/json/add/complex.rb, line 29
    def as_json(*)
      {
        JSON.create_id => self.class.name,
        'r'            => real,
        'i'            => imag,
      }
    end

to_json(*args) click to toggle source

Returns a `JSON` string representing `self`:

    require 'json/add/complex'
    puts Complex(2).to_json
    puts Complex(2.0, 4).to_json

Output:

    {"json_class":"Complex","r":2,"i":0}
    {"json_class":"Complex","r":2.0,"i":4}

    # File json/lib/json/add/complex.rb, line 48
    def to_json(*args)
      as_json.to_json(*args)
    end