src/keyval.h

   1 /*
   2  * Copyright (c) 2000 - 2016 Samsung Electronics Co., Ltd. All rights reserved.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef __KEYVAL_H__
  18 #define __KEYVAL_H__
  19
  20 /**
  21  * keyval.h
  22  *
  23  * keyval object
  24  */
  25
  26 #include <stddef.h>
  27
  28 /* ADT: object */
  29 typedef struct keyval_t keyval_t;
  30
  31 /* Object methods */
  32 typedef struct keyval_method_collection_t keyval_method_collection_t;
  33
  34 typedef void (*keyval_method_free_t)(keyval_t *kv, int do_free_object);
  35 typedef int (*keyval_method_compare_t) (keyval_t *kv1, keyval_t *kv2);
  36 typedef size_t (*keyval_method_get_encoded_size_t)(keyval_t *kv);
  37 typedef size_t (*keyval_method_encode_t)(
  38                 keyval_t *,
  39                 unsigned char **byte,
  40                 size_t *byte_len);
  41 typedef size_t (*keyval_method_decode_t)(unsigned char *byte, keyval_t **kv,
  42                 size_t byte_size);
  43
  44 struct keyval_method_collection_t {
  45         keyval_method_free_t free;
  46         keyval_method_compare_t compare;
  47         keyval_method_get_encoded_size_t get_encoded_size;
  48         keyval_method_encode_t encode;
  49         keyval_method_decode_t decode;
  50 };
  51
  52 struct keyval_t {
  53         int type;
  54         char *key;      /* To be freed. */
  55         void *val;      /* To be freed. */
  56         size_t size;    /* Size of a single value. */
  57         struct keyval_t *next;
  58         keyval_method_collection_t *method;
  59 };
  60
  61 keyval_t * keyval_new(keyval_t *kv, const char *key,
  62                 const int type, const void *val, const size_t size);
  63 void keyval_free(keyval_t *kv, int do_free_object);
  64 int keyval_compare(keyval_t *kv1, keyval_t *kv2);
  65 size_t keyval_get_encoded_size(keyval_t *kv);
  66 size_t keyval_encode(keyval_t *kv, unsigned char **byte, size_t *byte_len);
  67 size_t keyval_decode(unsigned char *byte, keyval_t **kv, size_t byte_size);
  68 int keyval_get_data(keyval_t *kv, int *type, void **val, size_t *size);
  69 int keyval_get_type_from_encoded_byte(unsigned char *byte);
  70
  71 #endif /* __KEYVAL_H__ */