Remove deprecated functions and type names #487

danielaparker · 2024-02-07T04:29:44Z

As the jsoncons library has evolved, names have sometimes changed. Some deprecated names date back to 2014. You can check if you're using any of them by defining the macro JSONCONS_NO_DEPRECATED. It's past time to retire most of them.

The functions and typedefs below have been deprecated for at least three years and most produce warnings with GCC, Clang, and MSVC. They will be removed in a release sometime after July 31, 2024:

Category/class	Old name	Replacement
corelib
`json_errc`
	`json_parser_errc`	`json_errc`
	`json_parse_errc`	`json_errc`
`basic_json`
	`owjson`	`wojson`
	`preserve_order_policy`	`order_preserving_policy`
	`value_type`	No replacement
	`kvp_type`	`key_value_type`
	`member_type`	`key_value_type`
	`get_semantic_tag`	`tag`
	`is_datetime`	`tag() == semantic_tag::datetime`
	`is_epoch_time`	`tag() == semantic_tag::epoch_second`
	`add`	`push_back, emplace_back, emplace, insert`
	`set`	`insert_or_assign, try_emplace`
	`has_key`	`contains`
	`has_member`	`contains`
	`is_ulonglong`	`is<unsigned long long>()`
	`is_longlong`	`is<long long>()`
	`as_int`	`as<int>()`
	`as_uint`	`as<unsigned int>()`
	`as_long`	`as<long>()`
	`as_ulong`	`as<unsigned long>()`
	`as_longlong`	`as<long long>()`
	`as_ulonglong`	`as<unsigned long long>()`
	`as_uinteger`	`as<uint64_t>()`
	`is_numeric`	`is_number`
	`resize_array`	`resize`
	`members`	`object_range`
	`elements`	`array_range`
	`begin_members`	`object_range().begin()`
	`end_members`	`object_range().end()`
	`begin_elements`	`array_range().begin()`
	`end_elements`	`array_range().end()`
	`get_with_default(const string_view_type&)`	`at_or_null(const string_view_type&)`
	`get_with_default(const string_view_type&, U&&)`	`get_value_or(const string_view_type&,U&&)`
	`get(const string_view_type&)`	`at_or_null(const string_view_type&)`
	`get(const string_view_type& name, T&& default_value)`	`get_with_default(const string_view_type&, T&&)`
	`remove_range`	`erase`
	`remove`	`erase`
	`remove_member`	`erase`
	`is_empty`	`empty`
	`basic_json(const byte_string_view&, semantic_tag, const Allocator&)`	`basic_json(byte_string_arg_t, const Source&, semantic_tag,const Allocator&)`
	`parse(const char_type* s, std::size_t length)`	`parse(const string_view_type&)`
	`parse_file`	`parse(std::basic_istream<char_type>&, const basic_json_options<char_type>&)>)`
	`parse_stream`	`parse`
	`parse_string`	`parse`
	`dump_fragment`	`dump`
	`dump_body`	`dump`
	`dump(std::basic_ostream<char_type>&, bool)`	`dump(std::basic_ostream<char_type>&, indenting)`
	`write_body`	`dump`
	`write`	`dump`
	`to_stream`	`dump`
	`precision`	No replacement
	`decimal_places`	No replacement
	`get_stor_type`	`storage_kind`
`bigint_chars_format`
	`bignum_chars_format`	`bigint_chars_format`
	`bigint_chars_format::integer`	`bigint_chars_format::number`
`basic_json_options`
	`enum class chars_format`	`float_chars_format`
`basic_json_parser`
	`end_parse`	`finish_parse`
	`set_source`	`update`
`json_type_traits`
	`is_json_type_traits_impl`	`is_json_type_traits_declared`
	`set_source`	`update`
`json_filter`
	`to_handler`	`destination`
	`input_handler`	`destination`
	`downstream_handler`	`destination`
	`destination_handler`	`destination`
	`json_content_filter`	`json_filter`
	`wjson_content_filter`	`wjson_filter`
	`rename_name_filter`	`rename_object_key_filter`
	`wrename_name_filter`	`wrename_object_key_filter`
	`rename_object_member_filter`	`rename_object_key_filter`
	`wrename_object_member_filter`	`wrename_object_key_filter`
	`default_parse_error_handler`	`default_json_parsing`
	`strict_parse_error_handler`	`strict_json_parsing`
	`can_read_nan_replacement`	`enable_nan_to_num() or enable_nan_to_str()`
	`can_read_pos_inf_replacement`	`enable_inf_to_num() or enable_inf_to_str()`
	`can_read_neg_inf_replacement`	`enable_neginf_to_num() or enable_neginf_to_str()`
	`nan_replacement`	`nan_to_num() or nan_to_str()`
	`indent`	`indent_size`
	`object_object_split_lines`	`object_object_line_splits`
	`array_object_split_lines`	`array_object_line_splits`
	`object_array_split_lines`	`object_array_line_splits`
	`array_array_split_lines`	`array_array_line_splits`
	`replace_inf`	`inf_to_num or inf_to_str`
	`replace_pos_inf`	`inf_to_num or inf_to_str`
	`replace_neg_inf`	`neginf_to_num or neginf_to_str`
	`nan_replacement`	`nan_to_num or nan_to_str`
	`pos_inf_replacement`	`inf_to_num() or inf_to_str()`
	`neg_inf_replacement`	`neginf_to_num() or neginf_to_str()`
	`big_integer_format`	`bigint_format`
	`floating_point_format`	`float_format`
	`dec_to_str`	`lossless_number`
	`output_format`	`json_options`
	`woutput_format`	`wjson_options`
	`serialization_options`	`json_options`
	`wserialization_options`	`wjson_options`
	`json_serializing_options`	`json_options`
	`wjson_serializing_options`	`wjson_options`
`basic_json_visitor`
	`basic_json_content_handler`	`basic_json_visitor`
	`json_content_handler`	`json_visitor`
	`wjson_content_handler`	`wjson_visitor`
	`default_json_content_handler`	`default_json_visitor`
	`default_wjson_content_handler`	`wdefault_json_visitor`
	`name`	`key`
	`byte_string_value(const uint8_t*, std::size_t, semantic_tag, const ser_context&)`	`byte_string_value(const Source&,semantic_tag, const ser_context&)`
	`byte_string_value(const uint8_t*, std::size_t, semantic_tag, const ser_context&, std::error_code&)`	`byte_string_value(const Source&,semantic_tag, const ser_context&, std::error_code&)`
	`byte_string_value(const byte_string_view&, byte_string_chars_format, semantic_tag, const ser_context&)`	`byte_string_value(const byte_string_view&, semantic_tag, const ser_context&)`
	`byte_string_value(const uint8_t*, std::size_t,byte_string_chars_format, semantic_tag tag, const ser_context&)`	`byte_string_value(const byte_string_view&, semantic_tag, const ser_context&)`
	`big_integer_value`	`string_value` with `semantic_tag::bigint`
	`bignum_value`	`string_value` with `semantic_tag::bigint`
	`big_decimal_value`	`string_value` with `semantic_tag::bigdec`
	`decimal_value`	`string_value` with `semantic_tag::bigdec`
	`date_time_value`	`string_value` with `semantic_tag::datetime`
	`timestamp_value`	`string_value` with `semantic_tag::epoch_second`
	`begin_document`	No replacement
	`end_document`	No replacement
	`begin_json`	No replacement
	`end_json`	No replacement
	`integer_value`	`int64_value`
	`uinteger_value`	`uint64_value`
`basic_json_reader`
	`json_reader`	`json_string_reader` or `json_stream_reader`
	`wjson_reader`	`wjson_string_reader` or `wjson_stream_reader`
	`max_nesting_depth`	Use `max_nesting_depth` in options
`basic_staj_event`
	`stream_event`	`staj_event`
	`wstream_event`	`wstaj_event`
`basic_json_cursor`
	`class basic_json_pull_reader`	`basic_json_cursor`
	`json_pull_reader`	`json_stream_cursor`
	`wjson_pull_reader`	`wjson_stream_cursor`
	`json_staj_cursor`	`json_stream_cursor`
	`wjson_staj_cursor`	`wjson_stream_cursor`
	`json_cursor`	`json_stream_cursor`
	`wjson_cursor`	`wjson_stream_cursor`
`json_decoder`
	`json_deserializer`	`json_decoder<json>`
	`wjson_deserializer`	`json_decoder<wjson>`
	`ojson_deserializer`	`json_decoder<ojson>`
	`wojson_deserializer`	`json_decoder<wojson>`
	`json_decoder(result_allocator_arg_t, const allocator_type& alloc, const temp_allocator_type& temp_alloc)`	`json_decoder(const allocator_type& alloc, const temp_allocator_type& temp_alloc)`
	`root()`	`get_result()`
`basic_json_encoder`
	`basic_json_serializer`	`basic_json_encoder`
	`json_encoder`	`json_stream_encoder`
	`wjson_encoder`	`wjson_stream_encoder`
	`json_serializer`	`json_stream_encoder`
	`wjson_serializer`	`wjson_stream_encoder`
	`json_compressed_serializer`	`compact_json_stream_encoder`
	`wjson_compressed_serializer`	`compact_wjson_stream_encoder`
	`json_string_serializer`	`json_string_encoder`
	`wjson_string_serializer`	`wjson_string_encoder`
	`json_compressed_stream_encoder`	`compact_json_stream_encoder`
	`wjson_compressed_stream_encoder`	`compact_wjson_stream_encoder`
	`json_compressed_string_encoder`	`compact_json_string_encoder`
	`wjson_compressed_string_encoder`	`compact_wjson_string_encoder`
	`json_compressed_string_serializer`	`compact_json_string_encoder`
	`wjson_compressed_string_serializer`	`wcompact_json_string_encoder`
	`compact_json_encoder`	`compact_json_stream_encoder`
	`wcompact_json_encoder`	`compact_wjson_stream_encoder`
`ser_error`
	`line_number()`	`line()`
	`column_number()`	`column()`
	`serialization_error`	`ser_error`
	`json_parse_exception`	`ser_error`
	`parse_exception`	`ser_error`
	`parse_error`	`ser_error`
`conv_error.hpp`
	`convert_error`	`conv_error`
`semantic_tag`
	`semantic_tag::big_integer`	`semantic_tag::bigint`
	`semantic_tag::big_decimal`	`semantic_tag::bigdec`
	`semantic_tag::big_float`	`semantic_tag::bigfloat`
	`semantic_tag::date_time`	`semantic_tag::datetime`
	`semantic_tag::timestamp`	`semantic_tag::epoch_second`
bson
`basic_bson_reader`
	`bson_reader`	`bson_stream_reader`
	`bson_buffer_reader`	`bson_bytes_reader`
`basic_bson_cursor`
	`read`	`read_to`
`basic_bson_encoder`
	`bson_encoder`	`bson_stream_encoder`
	`bson_serializer`	`bson_stream_encoder`
	`bson_buffer_serializer`	`bson_bytes_encoder`
cbor
`basic_cbor_reader`
	`cbor_reader`	`cbor_stream_reader`
	`cbor_buffer_reader`	`cbor_bytes_reader`
`basic_cbor_cursor`
	`read`	`read_to`
`basic_cbor_encoder`
	`cbor_encoder`	`cbor_stream_encoder`
	`cbor_serializer`	`cbor_stream_encoder`
	`cbor_buffer_serializer`	`cbor_bytes_encoder`
`cbor_options`
	`enable_typed_arrays`	`use_typed_arrays`
`cbor_error.hpp`
	`cbor_error`	`ser_error`
	`cbor_decode_error`	`ser_error`
csv
`csv_errc`
	`csv_parser_errc`	`csv_errc`
`basic_csv_reader`
	`csv_reader`	`csv_string_reader` or `csv_stream_reader`
	`wcsv_reader`	`wcsv_string_reader` or `wcsv_stream_reader`
`basic_csv_cursor`
	`csv_cursor`	`csv_stream_cursor`
	`wcsv_cursor`	`wcsv_stream_cursor`
	`read`	`read_to`
`basic_csv_options`
	`enum class mapping_type`	`csv_mapping_kind`
	`enum class mapping_kind`	`csv_mapping_kind`
	`enum class quote_styles`	`quote_style_kind`
	`enum class quote_style_type`	`quote_style_kind`
	`csv_parameters`	`csv_options`
	`wcsv_parameters`	`wcsv_options`
	`csv_serializing_options`	`csv_options`
	`wcsv_serializing_options`	`wcsv_options`
	`mapping`	`mapping_kind`
	`floating_point_format`	`float_format`
`basic_csv_encoder`
	`csv_serializer`	`csv_stream_encoder`
	`csv_string_serializer`	`csv_string_encoder`
	`csv_encoder`	`csv_stream_encoder`
	`wcsv_encoder`	`wcsv_stream_encoder`
msgpack
`basic_msgpack_reader`
	`msgpack_reader`	`msgpack_stream_reader`
	`msgpack_buffer_reader`	`msgpack_bytes_reader`
`basic_msgpack_cursor`
	`read`	`read_to`
`basic_msgpack_encoder`
	`msgpack_encoder`	`msgpack_stream_encoder`
	`msgpack_serializer`	`msgpack_stream_encoder`
	`msgpack_buffer_serializer`	`msgpack_bytes_encoder`
ubjson
`basic_ubjson_reader`
	`ubjson_reader`	`ubjson_stream_reader`
	`ubjson_buffer_reader`	`ubjson_bytes_reader`
`basic_ubjson_cursor`
	`read`	`read_to`
`basic_ubjson_encoder`
	`ubjson_encoder`	`ubjson_stream_encoder`
	`ubjson_serializer`	`ubjson_stream_encoder`
	`ubjson_buffer_serializer`	`ubjson_bytes_encoder`
jsonpointer
`basic_json_pointer`
	`address`	`json_pointer`
	`json_ptr`	`json_pointer`
	`wjson_ptr`	`wjson_pointer`
	`unflatten_options::object`	`unflatten_options::assume_object`
	`insert_or_assign`	`add`
	`insert`	`add_if_absent`

The text was updated successfully, but these errors were encountered:

danielaparker added the Enhancement label Feb 7, 2024

danielaparker pinned this issue Feb 7, 2024

danielaparker removed the Enhancement label Feb 7, 2024

danielaparker changed the title ~~Remove deprecated functions and typedefs~~ Remove deprecated functions and type names Feb 8, 2024

danielaparker closed this as completed Aug 18, 2024

danielaparker unpinned this issue Aug 21, 2024

sikmir mentioned this issue Sep 2, 2024

Build failed with jsoncons 0.177.0 mikedld/bt-migrate#26

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Remove deprecated functions and type names #487

Remove deprecated functions and type names #487

danielaparker commented Feb 7, 2024 •

edited

Loading

Remove deprecated functions and type names #487

Remove deprecated functions and type names #487

Comments

danielaparker commented Feb 7, 2024 • edited Loading

danielaparker commented Feb 7, 2024 •

edited

Loading