head 1.1; branch 1.1.1; access; symbols netbsd-11-0-RC4:1.1.1.1 netbsd-11-0-RC3:1.1.1.1 netbsd-11-0-RC2:1.1.1.1 netbsd-11-0-RC1:1.1.1.1 perseant-exfatfs-base-20250801:1.1.1.1 netbsd-11:1.1.1.1.0.12 netbsd-11-base:1.1.1.1 netbsd-10-1-RELEASE:1.1.1.1 perseant-exfatfs-base-20240630:1.1.1.1 perseant-exfatfs:1.1.1.1.0.10 perseant-exfatfs-base:1.1.1.1 netbsd-10-0-RELEASE:1.1.1.1 netbsd-10-0-RC6:1.1.1.1 netbsd-10-0-RC5:1.1.1.1 netbsd-10-0-RC4:1.1.1.1 netbsd-10-0-RC3:1.1.1.1 netbsd-10-0-RC2:1.1.1.1 netbsd-10-0-RC1:1.1.1.1 netbsd-10:1.1.1.1.0.8 netbsd-10-base:1.1.1.1 cjep_sun2x-base1:1.1.1.1 cjep_sun2x:1.1.1.1.0.6 cjep_sun2x-base:1.1.1.1 cjep_staticlib_x-base1:1.1.1.1 cjep_staticlib_x:1.1.1.1.0.4 cjep_staticlib_x-base:1.1.1.1 phil-wifi-20200421:1.1.1.1 phil-wifi:1.1.1.1.0.2 phil-wifi-20200411:1.1.1.1 phil-wifi-20200406:1.1.1.1 libcbor-3b41770ab0ca408d242041dddb3b75811345573f:1.1.1.1 PJK:1.1.1; locks; strict; comment @# @; 1.1 date 2020.03.03.00.34.29; author christos; state Exp; branches 1.1.1.1; next ; commitid CsDukytrNgtSbTYB; 1.1.1.1 date 2020.03.03.00.34.29; author christos; state Exp; branches 1.1.1.1.2.1; next ; commitid CsDukytrNgtSbTYB; 1.1.1.1.2.1 date 2020.03.03.00.34.29; author martin; state dead; branches; next 1.1.1.1.2.2; commitid X01YhRUPVUDaec4C; 1.1.1.1.2.2 date 2020.04.13.08.02.25; author martin; state Exp; branches; next ; commitid X01YhRUPVUDaec4C; desc @@ 1.1 log @Initial revision @ text @Decoding ============================= Another way to decode data using libcbor is to specify a callbacks that will be invoked when upon finding certain items in the input. This service is provided by .. doxygenfunction:: cbor_stream_decode To get started, you might want to have a look at the simple streaming example: .. code-block:: c #include "cbor.h" #include #include /* * Illustrates how one might skim through a map (which is assumed to have * string keys and values only), looking for the value of a specific key * * Use the examples/data/map.cbor input to test this. */ const char * key = "a secret key"; bool key_found = false; void find_string(void * _ctx, cbor_data buffer, size_t len) { if (key_found) { printf("Found the value: %*s\n", (int) len, buffer); key_found = false; } else if (len == strlen(key)) { key_found = (memcmp(key, buffer, len) == 0); } } int main(int argc, char * argv[]) { FILE * f = fopen(argv[1], "rb"); fseek(f, 0, SEEK_END); size_t length = (size_t)ftell(f); fseek(f, 0, SEEK_SET); unsigned char * buffer = malloc(length); fread(buffer, length, 1, f); struct cbor_callbacks callbacks = cbor_empty_callbacks; struct cbor_decoder_result decode_result; size_t bytes_read = 0; callbacks.string = find_string; while (bytes_read < length) { decode_result = cbor_stream_decode(buffer + bytes_read, length - bytes_read, &callbacks, NULL); bytes_read += decode_result.read; } free(buffer); fclose(f); } The callbacks are defined by .. doxygenstruct:: cbor_callbacks :members: When building custom sets of callbacks, feel free to start from .. doxygenvariable:: cbor_empty_callbacks Related structures ~~~~~~~~~~~~~~~~~~~~~ .. doxygenenum:: cbor_decoder_status .. doxygenstruct:: cbor_decoder_result :members: Callback types definition ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. doxygentypedef:: cbor_int8_callback .. doxygentypedef:: cbor_int16_callback .. doxygentypedef:: cbor_int32_callback .. doxygentypedef:: cbor_int64_callback .. doxygentypedef:: cbor_simple_callback .. doxygentypedef:: cbor_string_callback .. doxygentypedef:: cbor_collection_callback .. doxygentypedef:: cbor_float_callback .. doxygentypedef:: cbor_double_callback .. doxygentypedef:: cbor_bool_callback @ 1.1.1.1 log @Import libcbor from: https://github.com/PJK/libcbor.git @ text @@ 1.1.1.1.2.1 log @file decoding.rst was added on branch phil-wifi on 2020-04-13 08:02:25 +0000 @ text @d1 91 @ 1.1.1.1.2.2 log @Mostly merge changes from HEAD upto 20200411 @ text @a0 91 Decoding ============================= Another way to decode data using libcbor is to specify a callbacks that will be invoked when upon finding certain items in the input. This service is provided by .. doxygenfunction:: cbor_stream_decode To get started, you might want to have a look at the simple streaming example: .. code-block:: c #include "cbor.h" #include #include /* * Illustrates how one might skim through a map (which is assumed to have * string keys and values only), looking for the value of a specific key * * Use the examples/data/map.cbor input to test this. */ const char * key = "a secret key"; bool key_found = false; void find_string(void * _ctx, cbor_data buffer, size_t len) { if (key_found) { printf("Found the value: %*s\n", (int) len, buffer); key_found = false; } else if (len == strlen(key)) { key_found = (memcmp(key, buffer, len) == 0); } } int main(int argc, char * argv[]) { FILE * f = fopen(argv[1], "rb"); fseek(f, 0, SEEK_END); size_t length = (size_t)ftell(f); fseek(f, 0, SEEK_SET); unsigned char * buffer = malloc(length); fread(buffer, length, 1, f); struct cbor_callbacks callbacks = cbor_empty_callbacks; struct cbor_decoder_result decode_result; size_t bytes_read = 0; callbacks.string = find_string; while (bytes_read < length) { decode_result = cbor_stream_decode(buffer + bytes_read, length - bytes_read, &callbacks, NULL); bytes_read += decode_result.read; } free(buffer); fclose(f); } The callbacks are defined by .. doxygenstruct:: cbor_callbacks :members: When building custom sets of callbacks, feel free to start from .. doxygenvariable:: cbor_empty_callbacks Related structures ~~~~~~~~~~~~~~~~~~~~~ .. doxygenenum:: cbor_decoder_status .. doxygenstruct:: cbor_decoder_result :members: Callback types definition ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. doxygentypedef:: cbor_int8_callback .. doxygentypedef:: cbor_int16_callback .. doxygentypedef:: cbor_int32_callback .. doxygentypedef:: cbor_int64_callback .. doxygentypedef:: cbor_simple_callback .. doxygentypedef:: cbor_string_callback .. doxygentypedef:: cbor_collection_callback .. doxygentypedef:: cbor_float_callback .. doxygentypedef:: cbor_double_callback .. doxygentypedef:: cbor_bool_callback @