Remove deprecated functions and type names

Open danielaparker opened this issue 1 year ago • 0 comments

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`

Feb 07 '24 04:02 danielaparker