Builds settings to use for read_json(). More...

#include <json.hpp>

Public Member Functions
	json_reader_options_builder ()=default
	Default constructor. More...

	json_reader_options_builder (source_info src)
	Constructor from source info. More...

json_reader_options_builder &	dtypes (std::vector< data_type > types)
	Set data types for columns to be read. More...

json_reader_options_builder &	dtypes (std::map< std::string, data_type > types)
	Set data types for columns to be read. More...

json_reader_options_builder &	dtypes (std::map< std::string, schema_element > types)
	Set data types for columns to be read. More...

json_reader_options_builder &	dtypes (schema_element types)
	Set data types for columns to be read. More...

json_reader_options_builder &	compression (compression_type comp_type)
	Set the compression type. More...

json_reader_options_builder &	byte_range_offset (size_type offset)
	Set number of bytes to skip from source start. More...

json_reader_options_builder &	byte_range_size (size_type size)
	Set number of bytes to read. More...

json_reader_options_builder &	delimiter (char delimiter)
	Set delimiter separating records in JSON lines. More...

json_reader_options_builder &	lines (bool val)
	Set whether to read the file as a json object per line. More...

json_reader_options_builder &	mixed_types_as_string (bool val)
	Set whether to parse mixed types as a string column. Also enables forcing to read a struct as string column using schema. More...

json_reader_options_builder &	prune_columns (bool val)
	Set whether to prune columns on read, selected based on the dtypes option. More...

json_reader_options_builder &	experimental (bool val)
	Set whether to enable experimental features. More...

json_reader_options_builder &	dayfirst (bool val)
	Set whether to parse dates as DD/MM versus MM/DD. More...

json_reader_options_builder &	keep_quotes (bool val)
	Set whether the reader should keep quotes of string values. More...

json_reader_options_builder &	normalize_single_quotes (bool val)
	Set whether the reader should normalize single quotes around strings. More...

json_reader_options_builder &	normalize_whitespace (bool val)
	Set whether the reader should normalize unquoted whitespace. More...

json_reader_options_builder &	recovery_mode (json_recovery_mode_t val)
	Specifies the JSON reader's behavior on invalid JSON lines. More...

json_reader_options_builder &	strict_validation (bool val)
	Set whether json validation should be strict or not. More...

json_reader_options_builder &	numeric_leading_zeros (bool val)
	Set Whether leading zeros are allowed in numeric values. Strict validation must be enabled for this to have any effect. More...

json_reader_options_builder &	nonnumeric_numbers (bool val)
	Set whether specific unquoted number values are valid JSON. The values are NaN, +INF, -INF, +Infinity, Infinity, and -Infinity. Strict validation must be enabled for this to have any effect. More...

json_reader_options_builder &	unquoted_control_chars (bool val)
	Set whether chars >= 0 and < 32 are allowed in a quoted string without some form of escaping. Strict validation must be enabled for this to have any effect. More...

json_reader_options_builder &	na_values (std::vector< std::string > vals)
	Sets additional values to recognize as null values. More...

	operator json_reader_options && ()
	move json_reader_options member once it's built.

json_reader_options &&	build ()
	move json_reader_options member once it's built. More...

Detailed Description

Builds settings to use for read_json().

Definition at line 587 of file io/json.hpp.

Constructor & Destructor Documentation

◆ json_reader_options_builder() [1/2]

cudf::io::json_reader_options_builder::json_reader_options_builder ( )

explicitdefault

Default constructor.

This has been added since Cython requires a default constructor to create objects on stack.

◆ json_reader_options_builder() [2/2]

cudf::io::json_reader_options_builder::json_reader_options_builder ( source_info src )

inlineexplicit

Constructor from source info.

Parameters

src	The source information used to read avro file

Definition at line 603 of file io/json.hpp.

Member Function Documentation

◆ build()

json_reader_options&& cudf::io::json_reader_options_builder::build ( )

inline

move json_reader_options member once it's built.

This has been added since Cython does not support overloading of conversion operators.

Returns: Built json_reader_options object r-value reference

Definition at line 902 of file io/json.hpp.

◆ byte_range_offset()

json_reader_options_builder& cudf::io::json_reader_options_builder::byte_range_offset ( size_type offset )

inline

Set number of bytes to skip from source start.

Parameters

offset Number of bytes of offset

Returns: this for chaining

Definition at line 671 of file io/json.hpp.

◆ byte_range_size()

json_reader_options_builder& cudf::io::json_reader_options_builder::byte_range_size ( size_type size )

inline

Set number of bytes to read.

Parameters

size	Number of bytes to read

Returns: this for chaining

Definition at line 683 of file io/json.hpp.

◆ compression()

json_reader_options_builder& cudf::io::json_reader_options_builder::compression ( compression_type comp_type )

inline

Set the compression type.

Parameters

comp_type The compression type used

Returns: this for chaining

Definition at line 659 of file io/json.hpp.

◆ dayfirst()

json_reader_options_builder& cudf::io::json_reader_options_builder::dayfirst ( bool val )

inline

Set whether to parse dates as DD/MM versus MM/DD.

Parameters

val	Boolean value to enable/disable day first parsing format

Returns: this for chaining

Definition at line 763 of file io/json.hpp.

◆ delimiter()

json_reader_options_builder& cudf::io::json_reader_options_builder::delimiter ( char delimiter )

inline

Set delimiter separating records in JSON lines.

Parameters

delimiter Delimiter separating records in JSON lines

Returns: this for chaining

Definition at line 695 of file io/json.hpp.

◆ dtypes() [1/4]

json_reader_options_builder& cudf::io::json_reader_options_builder::dtypes ( schema_element types )

inline

Set data types for columns to be read.

Parameters

types Struct schema_element with Column name -> schema_element with map and order

Returns: this for chaining

Definition at line 647 of file io/json.hpp.

◆ dtypes() [2/4]

json_reader_options_builder& cudf::io::json_reader_options_builder::dtypes ( std::map< std::string, data_type > types )

inline

Set data types for columns to be read.

Parameters

types Column name -> dtype map

Returns: this for chaining

Definition at line 623 of file io/json.hpp.

◆ dtypes() [3/4]

json_reader_options_builder& cudf::io::json_reader_options_builder::dtypes ( std::map< std::string, schema_element > types )

inline

Set data types for columns to be read.

Parameters

types Column name -> schema_element map

Returns: this for chaining

Definition at line 635 of file io/json.hpp.

◆ dtypes() [4/4]

json_reader_options_builder& cudf::io::json_reader_options_builder::dtypes ( std::vector< data_type > types )

inline

Set data types for columns to be read.

Parameters

types Vector of dtypes

Returns: this for chaining

Definition at line 611 of file io/json.hpp.

◆ experimental()

json_reader_options_builder& cudf::io::json_reader_options_builder::experimental ( bool val )

inline

Set whether to enable experimental features.

When set to true, experimental features, such as the new column tree construction, utf-8 matching of field names will be enabled.

Parameters

val	Boolean value to enable/disable experimental features

Returns: this for chaining

Definition at line 751 of file io/json.hpp.

◆ keep_quotes()

json_reader_options_builder& cudf::io::json_reader_options_builder::keep_quotes ( bool val )

inline

Set whether the reader should keep quotes of string values.

Parameters

val	Boolean value to indicate whether the reader should keep quotes of string values

Returns: this for chaining

Definition at line 776 of file io/json.hpp.

◆ lines()

json_reader_options_builder& cudf::io::json_reader_options_builder::lines ( bool val )

inline

Set whether to read the file as a json object per line.

Parameters

val	Boolean value to enable/disable the option to read each line as a json object

Returns: this for chaining

Definition at line 707 of file io/json.hpp.

◆ mixed_types_as_string()

json_reader_options_builder& cudf::io::json_reader_options_builder::mixed_types_as_string ( bool val )

inline

Set whether to parse mixed types as a string column. Also enables forcing to read a struct as string column using schema.

Parameters

val	Boolean value to enable/disable parsing mixed types as a string column

Returns: this for chaining

Definition at line 720 of file io/json.hpp.

◆ na_values()

json_reader_options_builder& cudf::io::json_reader_options_builder::na_values ( std::vector< std::string > vals )

inline

Sets additional values to recognize as null values.

Parameters

vals	Vector of values to be considered to be null

Returns: this for chaining

Definition at line 884 of file io/json.hpp.

◆ nonnumeric_numbers()

json_reader_options_builder& cudf::io::json_reader_options_builder::nonnumeric_numbers ( bool val )

inline

Set whether specific unquoted number values are valid JSON. The values are NaN, +INF, -INF, +Infinity, Infinity, and -Infinity. Strict validation must be enabled for this to have any effect.

Exceptions

cudf::logic_error if strict_validation is not enabled before setting this option.

Parameters

val	Boolean value to indicate if unquoted nonnumeric values are valid json or not.

Returns: this for chaining

Definition at line 857 of file io/json.hpp.

◆ normalize_single_quotes()

json_reader_options_builder& cudf::io::json_reader_options_builder::normalize_single_quotes ( bool val )

inline

Set whether the reader should normalize single quotes around strings.

Parameters

val	Boolean value to indicate whether the reader should normalize single quotes of strings

Returns: this for chaining

Definition at line 789 of file io/json.hpp.

◆ normalize_whitespace()

json_reader_options_builder& cudf::io::json_reader_options_builder::normalize_whitespace ( bool val )

inline

Set whether the reader should normalize unquoted whitespace.

Parameters

val	Boolean value to indicate whether the reader should normalize unquoted whitespace

Returns: this for chaining

Definition at line 802 of file io/json.hpp.

◆ numeric_leading_zeros()

json_reader_options_builder& cudf::io::json_reader_options_builder::numeric_leading_zeros ( bool val )

inline

Set Whether leading zeros are allowed in numeric values. Strict validation must be enabled for this to have any effect.

Exceptions

cudf::logic_error if strict_validation is not enabled before setting this option.

Parameters

val	Boolean value to indicate whether leading zeros are allowed in numeric values

Returns: this for chaining

Definition at line 841 of file io/json.hpp.

◆ prune_columns()

json_reader_options_builder& cudf::io::json_reader_options_builder::prune_columns ( bool val )

inline

Set whether to prune columns on read, selected based on the dtypes option.

When set as true, if the reader options include dtypes, then the reader will only return those columns which are mentioned in dtypes. If false, then all columns are returned, independent of the dtypes setting.

Parameters

val	Boolean value to enable/disable column pruning

Returns: this for chaining

Definition at line 736 of file io/json.hpp.

◆ recovery_mode()

json_reader_options_builder& cudf::io::json_reader_options_builder::recovery_mode ( json_recovery_mode_t val )

inline

Specifies the JSON reader's behavior on invalid JSON lines.

Parameters

val	An enum value to indicate the JSON reader's behavior on invalid JSON lines.

Returns: this for chaining

Definition at line 814 of file io/json.hpp.

◆ strict_validation()

json_reader_options_builder& cudf::io::json_reader_options_builder::strict_validation ( bool val )

inline

Set whether json validation should be strict or not.

Parameters

val	Boolean value to indicate whether json validation should be strict or not.

Returns: this for chaining

Definition at line 826 of file io/json.hpp.

◆ unquoted_control_chars()

json_reader_options_builder& cudf::io::json_reader_options_builder::unquoted_control_chars ( bool val )

inline

Set whether chars >= 0 and < 32 are allowed in a quoted string without some form of escaping. Strict validation must be enabled for this to have any effect.

Exceptions

cudf::logic_error if strict_validation is not enabled before setting this option.

Parameters

val	Boolean value to indicate if unquoted control chars are allowed or not.

Returns: this for chaining

Definition at line 872 of file io/json.hpp.

The documentation for this class was generated from the following file:

io/json.hpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ json_reader_options_builder() [1/2]

◆ json_reader_options_builder() [2/2]

Member Function Documentation

◆ build()

◆ byte_range_offset()

◆ byte_range_size()

◆ compression()

◆ dayfirst()

◆ delimiter()

◆ dtypes() [1/4]

◆ dtypes() [2/4]

◆ dtypes() [3/4]

◆ dtypes() [4/4]

◆ experimental()

◆ keep_quotes()

◆ lines()

◆ mixed_types_as_string()

◆ na_values()

◆ nonnumeric_numbers()

◆ normalize_single_quotes()

◆ normalize_whitespace()

◆ numeric_leading_zeros()

◆ prune_columns()

◆ recovery_mode()

◆ strict_validation()

◆ unquoted_control_chars()