WebSVN – HelenOS – Blame – /branches/network/uspace/srv/net/structures/generic_char_map.h

Rev	Author	Line No.	Line
3666	mejdrech	1	/*
3912	mejdrech	2	* Copyright (c) 2009 Lukas Mejdrech
3666	mejdrech	3	* All rights reserved.
		4	*
		5	* Redistribution and use in source and binary forms, with or without
		6	* modification, are permitted provided that the following conditions
		7	* are met:
		8	*
		9	* - Redistributions of source code must retain the above copyright
		10	* notice, this list of conditions and the following disclaimer.
		11	* - Redistributions in binary form must reproduce the above copyright
		12	* notice, this list of conditions and the following disclaimer in the
		13	* documentation and/or other materials provided with the distribution.
		14	* - The name of the author may not be used to endorse or promote products
		15	* derived from this software without specific prior written permission.
		16	*
		17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
		18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
		19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
		20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
		21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
		22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
		23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
		24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
		25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
		26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
		27	*/
		28
		29	/** @addtogroup net
3846	mejdrech	30	* @{
3666	mejdrech	31	*/
		32
		33	/** @file
4704	mejdrech	34	* Character string to generic type map.
3666	mejdrech	35	*/
		36
		37	#ifndef __GENERIC_CHAR_MAP_H__
		38	#define __GENERIC_CHAR_MAP_H__
		39
4505	mejdrech	40	#include <errno.h>
3666	mejdrech	41	#include <unistd.h>
		42
3886	mejdrech	43	#include "../err.h"
		44
3666	mejdrech	45	#include "char_map.h"
		46	#include "generic_field.h"
		47
4704	mejdrech	48	/** Internal magic value for a map consistency check.
		49	*/
3666	mejdrech	50	#define GENERIC_CHAR_MAP_MAGIC_VALUE 0x12345622
		51
4704	mejdrech	52	/** Character string to generic type map declaration.
4756	mejdrech	53	* @param[in] name Name of the map.
		54	* @param[in] type Inner object type.
4704	mejdrech	55	*/
3846	mejdrech	56	#define GENERIC_CHAR_MAP_DECLARE( name, type ) \
		57	\
		58	GENERIC_FIELD_DECLARE( name##_items, type ) \
		59	\
		60	typedef struct name name##_t; \
		61	typedef name##_t * name##_ref; \
		62	\
		63	struct name{ \
		64	char_map_t names; \
		65	name##_items_t values; \
		66	int magic; \
		67	}; \
		68	\
		69	int name##_add( name##_ref map, const char * name, const size_t length, type * value ); \
		70	int name##_count( name##_ref map ); \
		71	void name##_destroy( name##_ref map ); \
		72	void name##_exclude( name##_ref map, const char * name, const size_t length ); \
		73	type * name##_find( name##_ref map, const char * name, const size_t length ); \
		74	int name##_initialize( name##_ref map ); \
3666	mejdrech	75	int name##_is_valid( name##_ref map );
		76
4704	mejdrech	77	/** Character string to generic type map implementation.
		78	* Should follow declaration with the same parameters.
4756	mejdrech	79	* @param[in] name Name of the map.
		80	* @param[in] type Inner object type.
4704	mejdrech	81	*/
3846	mejdrech	82	#define GENERIC_CHAR_MAP_IMPLEMENT( name, type ) \
		83	\
		84	GENERIC_FIELD_IMPLEMENT( name##_items, type ) \
		85	\
		86	int name##_add( name##_ref map, const char * name, const size_t length, type * value ){ \
		87	ERROR_DECLARE; \
		88	\
		89	int index; \
		90	\
		91	if( ! name##_is_valid( map )) return EINVAL; \
		92	index = name##_items_add( & map->values, value ); \
		93	if( index < 0 ) return index; \
3912	mejdrech	94	if( ERROR_OCCURRED( char_map_add( & map->names, name, length, index ))){ \
3846	mejdrech	95	name##_items_exclude_index( & map->values, index ); \
		96	return ERROR_CODE; \
		97	} \
		98	return EOK; \
		99	} \
		100	\
		101	int name##_count( name##_ref map ){ \
3666	mejdrech	102	return name##_is_valid( map ) ? name##_items_count( & map->values ) : -1; \
3846	mejdrech	103	} \
		104	\
		105	void name##_destroy( name##_ref map ){ \
		106	if( name##_is_valid( map )){ \
		107	char_map_destroy( & map->names ); \
		108	name##_items_destroy( & map->values ); \
		109	} \
		110	} \
		111	\
		112	void name##_exclude( name##_ref map, const char * name, const size_t length ){ \
		113	if( name##_is_valid( map )){ \
		114	int index; \
		115	\
		116	index = char_map_exclude( & map->names, name, length ); \
		117	if( index != CHAR_MAP_NULL ){ \
		118	name##_items_exclude_index( & map->values, index ); \
		119	} \
		120	} \
		121	} \
		122	\
		123	type * name##_find( name##_ref map, const char * name, const size_t length ){ \
		124	if( name##_is_valid( map )){ \
		125	int index; \
		126	\
		127	index = char_map_find( & map->names, name, length ); \
		128	if( index != CHAR_MAP_NULL ){ \
		129	return name##_items_get_index( & map->values, index ); \
		130	} \
		131	} \
		132	return NULL; \
		133	} \
		134	\
		135	int name##_initialize( name##_ref map ){ \
3912	mejdrech	136	ERROR_DECLARE; \
		137	\
3846	mejdrech	138	if( ! map ) return EINVAL; \
3912	mejdrech	139	ERROR_PROPAGATE( char_map_initialize( & map->names )); \
		140	if( ERROR_OCCURRED( name##_items_initialize( & map->values ))){ \
		141	char_map_destroy( & map->names ); \
		142	return ERROR_CODE; \
		143	} \
3846	mejdrech	144	map->magic = GENERIC_CHAR_MAP_MAGIC_VALUE; \
		145	return EOK; \
		146	} \
		147	\
		148	int name##_is_valid( name##_ref map ){ \
		149	return map && ( map->magic == GENERIC_CHAR_MAP_MAGIC_VALUE ); \
3666	mejdrech	150	}
		151
		152	#endif
		153
		154	/** @}
		155	*/

Subversion Repositories HelenOS

(root)/branches/network/uspace/srv/net/structures/generic_char_map.h – Rev 4756