123456789_123456789_123456789_123456789_123456789_

Class: JSON::Ext::ParserConfig

Relationships & Source Files
Inherits: Object
Defined in: ext/json/parser/parser.c

Class Method Summary

Instance Method Summary

  • #parse(source)

    Parses the current ::JSON text source and returns the complete data structure as a result.

Constructor Details

.new(opts) ⇒ {}

Creates a new ParserConfig instance.

It will be configured by the opts hash. opts can have the following keys:

opts can have the following keys:

  • max_nesting: The maximum depth of nesting allowed in the parsed data structures. Disable depth checking with :max_nesting => false|nil|0, it defaults to 100.

  • allow_nan: If set to true, allow NaN, Infinity and -Infinity in defiance of RFC 4627 to be parsed by the Parser. This option defaults to false.

  • symbolize_names: If set to true, returns symbols for the names (keys) in a JSON object. Otherwise strings are returned, which is also the default. It’s not possible to use this option in conjunction with the create_additions option.

  • create_additions: If set to false, the Parser doesn’t create additions even if a matching class and create_id was found. This option defaults to false.

  • object_class: Defaults to Hash. If another type is provided, it will be used instead of Hash to represent JSON objects. The type must respond to new without arguments, and return an object that respond to []=.

  • array_class: Defaults to Array If another type is provided, it will be used instead of Hash to represent JSON arrays. The type must respond to new without arguments, and return an object that respond to <<.

  • decimal_class: Specifies which class to use instead of the default

    (Float) when parsing decimal numbers. This class must accept a single
    string argument in its constructor.
[ GitHub ]

  
# File 'ext/json/parser/parser.c', line 1309

static VALUE cParserConfig_initialize(VALUE self, VALUE opts)
{
    GET_PARSER_CONFIG;

    parser_config_init(config, opts);

    RB_OBJ_WRITTEN(self, Qundef, config->create_id);
    RB_OBJ_WRITTEN(self, Qundef, config->object_class);
    RB_OBJ_WRITTEN(self, Qundef, config->array_class);
    RB_OBJ_WRITTEN(self, Qundef, config->decimal_class);
    RB_OBJ_WRITTEN(self, Qundef, config->match_string);

    return self;
}

Instance Method Details

#parse(source)

Parses the current ::JSON text source and returns the complete data structure as a result. It raises ::JSON::ParserError if fail to parse.

[ GitHub ]

  
# File 'ext/json/parser/parser.c', line 1361

static VALUE cParserConfig_parse(VALUE self, VALUE Vsource)
{
    GET_PARSER_CONFIG;
    return cParser_parse(config, Vsource);
}