Program Listing for File hash_map.h
↰ Return to documentation for file (include/rcutils/types/hash_map.h
)
// Copyright 2018-2019 Open Source Robotics Foundation, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#ifndef RCUTILS__TYPES__HASH_MAP_H_
#define RCUTILS__TYPES__HASH_MAP_H_
#ifdef __cplusplus
extern "C"
{
#endif
#include <string.h>
#include "rcutils/allocator.h"
#include "rcutils/types/rcutils_ret.h"
#include "rcutils/macros.h"
#include "rcutils/visibility_control.h"
struct rcutils_hash_map_impl_s;
typedef struct RCUTILS_PUBLIC_TYPE rcutils_hash_map_s
{
struct rcutils_hash_map_impl_s * impl;
} rcutils_hash_map_t;
typedef size_t (* rcutils_hash_map_key_hasher_t)(
const void * key
);
typedef int (* rcutils_hash_map_key_cmp_t)(
const void * val1,
const void * val2
);
#define HASH_MAP_VALIDATE_HASH_MAP(map) \
RCUTILS_CHECK_ARGUMENT_FOR_NULL(map, RCUTILS_RET_INVALID_ARGUMENT); \
if (NULL == map->impl) { \
RCUTILS_SET_ERROR_MSG("map is not initialized"); \
return RCUTILS_RET_NOT_INITIALIZED; \
}
RCUTILS_PUBLIC
size_t
rcutils_hash_map_string_hash_func(const void * key_str);
RCUTILS_PUBLIC
int
rcutils_hash_map_string_cmp_func(const void * val1, const void * val2);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_hash_map_t
rcutils_get_zero_initialized_hash_map(void);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_ret_t
rcutils_hash_map_init(
rcutils_hash_map_t * hash_map,
size_t initial_capacity,
size_t key_size,
size_t data_size,
rcutils_hash_map_key_hasher_t key_hashing_func,
rcutils_hash_map_key_cmp_t key_cmp_func,
const rcutils_allocator_t * allocator);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_ret_t
rcutils_hash_map_fini(rcutils_hash_map_t * hash_map);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_ret_t
rcutils_hash_map_get_capacity(const rcutils_hash_map_t * hash_map, size_t * capacity);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_ret_t
rcutils_hash_map_get_size(const rcutils_hash_map_t * hash_map, size_t * size);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_ret_t
rcutils_hash_map_set(rcutils_hash_map_t * hash_map, const void * key, const void * value);
RCUTILS_PUBLIC
RCUTILS_WARN_UNUSED
rcutils_ret_t
rcutils_hash_map_unset(rcutils_hash_map_t * hash_map, const void * key);
RCUTILS_PUBLIC
bool
rcutils_hash_map_key_exists(const rcutils_hash_map_t * hash_map, const void * key);
RCUTILS_PUBLIC
rcutils_ret_t
rcutils_hash_map_get(const rcutils_hash_map_t * hash_map, const void * key, void * data);
RCUTILS_PUBLIC
rcutils_ret_t
rcutils_hash_map_get_next_key_and_data(
const rcutils_hash_map_t * hash_map,
const void * previous_key,
void * key,
void * data);
#ifdef __cplusplus
}
#endif
#endif // RCUTILS__TYPES__HASH_MAP_H_