WebSVN – HelenOS – Diff – /branches/network/uspace/srv/net/structures/char_map.c


/*
 * Copyright (c) 2009 Lukas Mejdrech
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
/** @addtogroup net
 *  @{
 */
 
/** @file
 *  Character string to integer map implementation.
 *  @see char_map.h
 */
 
#include <errno.h>
#include <malloc.h>
#include <mem.h>
#include <unistd.h>
 
#include "char_map.h"
 
/** Internal magic value for a&nbsp;consistency check.
 */
#define CHAR_MAP_MAGIC_VALUE    0x12345611
 
/** Adds the value with the key to the map.
 *  Creates new nodes to map the key.
 *  @param map The character string to integer map. Input/output parameter.
 *  @param identifier The key zero ('\\0') terminated character string. The key character string is processed until the first terminating zero ('\\0') character after the given length is found. Input parameter.
 *  @param length The key character string length. The parameter may be zero (0) which means that the string is processed until the terminating zero ('\\0') character is found. Input parameter.
 *  @param value The integral value to be stored for the key character string. Input parameter.
 *  @returns EOK on success.
 *  @returns ENOMEM if there is not enough memory left.
 *  @returns EEXIST if the key character string is already used.
 */
int char_map_add_item( char_map_ref map, const char * identifier, size_t length, const int value );
 
/** Returns the node assigned to the key from the map.
 *  @param map The character string to integer map. Input parameter.
 *  @param identifier The key zero ('\\0') terminated character string. The key character string is processed until the first terminating zero ('\\0') character after the given length is found. Input parameter.
 *  @param length The key character string length. The parameter may be zero (0) which means that the string is processed until the terminating zero ('\\0') character is found. Input parameter.
 *  @returns The node holding the integral value assigned to the key character string.
 *  @returns NULL if the key is not assigned a&nbsp;node.
 */
char_map_ref    char_map_find_node( const char_map_ref map, const char * identifier, const size_t length );
 
/** Returns the value assigned to the map.
 *  @param map The character string to integer map. Input parameter.
 *  @returns The integral value assigned to the map.
 *  @returns CHAR_MAP_NULL if the map is not assigned a&nbsp;value.
 */
int char_map_get_value( const char_map_ref map );
 
/** Checks if the map is valid.
 *  @param map The character string to integer map. Input parameter.
 *  @returns TRUE if the map is valid.
 *  @returns FALSE otherwise.
 */
int char_map_is_valid( const char_map_ref map );
 
int char_map_add( char_map_ref map, const char * identifier, size_t length, const int value ){
    if( char_map_is_valid( map ) && ( identifier ) && (( length ) || ( * identifier ))){
        int index;
 
        for( index = 0; index < map->next; ++ index ){
            if( map->items[ index ]->c == * identifier ){
                ++ identifier;
                if(( length > 1 ) || (( length == 0 ) && ( * identifier ))){
                    return char_map_add( map->items[ index ], identifier, length ? length - 1 : 0, value );
                }else{
                    if( map->items[ index ]->value != CHAR_MAP_NULL ) return EEXISTS;
                    map->items[ index ]->value = value;
                    return EOK;
                }
            }
        }
        return char_map_add_item( map, identifier, length, value );
    }
    return EINVAL;
}
 
int char_map_add_item( char_map_ref map, const char * identifier, size_t length, const int value ){
    if( map->next == ( map->size - 1 )){
        char_map_ref    * tmp;
 
        tmp = ( char_map_ref * ) realloc( map->items, sizeof( char_map_ref ) * 2 * map->size );
        if( ! tmp ) return ENOMEM;
        map->size *= 2;
        map->items = tmp;
    }
    map->items[ map->next ] = ( char_map_ref ) malloc( sizeof( char_map_t ));
    if( ! map->items[ map->next ] ) return ENOMEM;
    if( char_map_initialize( map->items[ map->next ] ) != EOK ){
        free( map->items[ map->next ] );
        map->items[ map->next ] = NULL;
        return ENOMEM;
    }
    map->items[ map->next ]->c = * identifier;
    ++ identifier;
    ++ map->next;
    if(( length > 1 ) || (( length == 0 ) && ( * identifier ))){
        map->items[ map->next - 1 ]->value = CHAR_MAP_NULL;
        return char_map_add_item( map->items[ map->next - 1 ], identifier, length ? length - 1 : 0, value );
    }else{
        map->items[ map->next - 1 ]->value = value;
    }
    return EOK;
}
 
void char_map_destroy( char_map_ref map ){
    if( char_map_is_valid( map )){
        int index;
 
        map->magic = 0;
        for( index = 0; index < map->next; ++ index ){
            char_map_destroy( map->items[ index ] );
        }
        free( map->items );
        map->items = NULL;
    }
}
 
int char_map_exclude( char_map_ref map, const char * identifier, size_t length ){
    char_map_ref    node;
 
    node = char_map_find_node( map, identifier, length );
    if( node ){
        int value;
 
        value = node->value;
        node->value = CHAR_MAP_NULL;
        return value;
    }
    return CHAR_MAP_NULL;
}
 
int char_map_find( const char_map_ref map, const char * identifier, size_t length ){
    char_map_ref    node;
 
    node = char_map_find_node( map, identifier, length );
    return node ? node->value : CHAR_MAP_NULL;
}
 
char_map_ref char_map_find_node( const char_map_ref map, const char * identifier, size_t length ){
    if( ! char_map_is_valid( map )) return NULL;
    if( length || ( * identifier )){
        int index;
 
        for( index = 0; index < map->next; ++ index ){
            if( map->items[ index ]->c == * identifier ){
                ++ identifier;
                if( length == 1 ) return map->items[ index ];
                return char_map_find_node( map->items[ index ], identifier, length ? length - 1 : 0 );
            }
        }
        return NULL;
    }
    return map;
}
 
int char_map_get_value( const char_map_ref map ){
    return char_map_is_valid( map ) ? map->value : CHAR_MAP_NULL;
}
 
int char_map_initialize( char_map_ref map ){
    if( ! map ) return EINVAL;
    map->c = '\0';
    map->value = CHAR_MAP_NULL;
    map->size = 2;
    map->next = 0;
    map->items = malloc( sizeof( char_map_ref ) * map->size );
    if( ! map->items ){
        map->magic = 0;
        return ENOMEM;
    }
    map->items[ map->next ] = NULL;
    map->magic = CHAR_MAP_MAGIC_VALUE;
    return EOK;
}
 
int char_map_is_valid( const char_map_ref map ){
    return map && ( map->magic == CHAR_MAP_MAGIC_VALUE );
}
 
int char_map_update( char_map_ref map, const char * identifier, const size_t length, const int value ){
    char_map_ref    node;
 
//  if( ! char_map_is_valid( map )) return EINVAL;
    node = char_map_find_node( map, identifier, length );
    if( node ){
        node->value = value;
        return EOK;
    }else{
        return char_map_add( map, identifier, length, value );
    }
}
 
/** @}
 */
 

Subversion Repositories HelenOS

(root)/branches/network/uspace/srv/net/structures/char_map.c – Rev 4332 → 4743

Rev 4332		Rev 4743
1	/*	1	/*
2	* Copyright (c) 2009 Lukas Mejdrech	2	* Copyright (c) 2009 Lukas Mejdrech
3	* All rights reserved.	3	* All rights reserved.
4	*	4	*
5	* Redistribution and use in source and binary forms, with or without	5	* Redistribution and use in source and binary forms, with or without
6	* modification, are permitted provided that the following conditions	6	* modification, are permitted provided that the following conditions
7	* are met:	7	* are met:
8	*	8	*
9	* - Redistributions of source code must retain the above copyright	9	* - Redistributions of source code must retain the above copyright
10	* notice, this list of conditions and the following disclaimer.	10	* notice, this list of conditions and the following disclaimer.
11	* - Redistributions in binary form must reproduce the above copyright	11	* - Redistributions in binary form must reproduce the above copyright
12	* notice, this list of conditions and the following disclaimer in the	12	* notice, this list of conditions and the following disclaimer in the
13	* documentation and/or other materials provided with the distribution.	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	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.	15	* derived from this software without specific prior written permission.
16	*	16	*
17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR	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	18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.	19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,	20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT	21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,	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	23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT	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	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.	26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27	*/	27	*/
28		28
29	/** @addtogroup net	29	/** @addtogroup net
30	* @{	30	* @{
31	*/	31	*/
32		32
33	/** @file	33	/** @file
34	* Character string to integer map implementation.	34	* Character string to integer map implementation.
35	* @see char_map.h	35	* @see char_map.h
36	*/	36	*/
37		37
38	#include <errno.h>	38	#include <errno.h>
39	#include <malloc.h>	39	#include <malloc.h>
40	#include <mem.h>	40	#include <mem.h>
41	#include <unistd.h>	41	#include <unistd.h>
42		42
43	#include "char_map.h"	43	#include "char_map.h"
44		44
45	/** Internal magic value for a consistency check.	45	/** Internal magic value for a consistency check.
46	*/	46	*/
47	#define CHAR_MAP_MAGIC_VALUE 0x12345611	47	#define CHAR_MAP_MAGIC_VALUE 0x12345611
48		48
49	/** Adds the value with the key to the map.	49	/** Adds the value with the key to the map.
50	* Creates new nodes to map the key.	50	* Creates new nodes to map the key.
51	* @param map The character string to integer map. Input/output parameter.	51	* @param map The character string to integer map. Input/output parameter.
52	* @param identifier The key zero ('\\0') terminated character string. The key character string is processed until the first terminating zero ('\\0') character after the given length is found. Input parameter.	52	* @param identifier The key zero ('\\0') terminated character string. The key character string is processed until the first terminating zero ('\\0') character after the given length is found. Input parameter.
53	* @param length The key character string length. The parameter may be zero (0) which means that the string is processed until the terminating zero ('\\0') character is found. Input parameter.	53	* @param length The key character string length. The parameter may be zero (0) which means that the string is processed until the terminating zero ('\\0') character is found. Input parameter.
54	* @param value The integral value to be stored for the key character string. Input parameter.	54	* @param value The integral value to be stored for the key character string. Input parameter.
55	* @returns EOK on success.	55	* @returns EOK on success.
56	* @returns ENOMEM if there is not enough memory left.	56	* @returns ENOMEM if there is not enough memory left.
57	* @returns EEXIST if the key character string is already used.	57	* @returns EEXIST if the key character string is already used.
58	*/	58	*/
59	int char_map_add_item( char_map_ref map, const char * identifier, size_t length, const int value );	59	int char_map_add_item( char_map_ref map, const char * identifier, size_t length, const int value );
60		60
61	/** Returns the node assigned to the key from the map.	61	/** Returns the node assigned to the key from the map.
62	* @param map The character string to integer map. Input parameter.	62	* @param map The character string to integer map. Input parameter.
63	* @param identifier The key zero ('\\0') terminated character string. The key character string is processed until the first terminating zero ('\\0') character after the given length is found. Input parameter.	63	* @param identifier The key zero ('\\0') terminated character string. The key character string is processed until the first terminating zero ('\\0') character after the given length is found. Input parameter.
64	* @param length The key character string length. The parameter may be zero (0) which means that the string is processed until the terminating zero ('\\0') character is found. Input parameter.	64	* @param length The key character string length. The parameter may be zero (0) which means that the string is processed until the terminating zero ('\\0') character is found. Input parameter.
65	* @returns The node holding the integral value assigned to the key character string.	65	* @returns The node holding the integral value assigned to the key character string.
66	* @returns NULL if the key is not assigned a node.	66	* @returns NULL if the key is not assigned a node.
67	*/	67	*/
68	char_map_ref char_map_find_node( const char_map_ref map, const char * identifier, const size_t length );	68	char_map_ref char_map_find_node( const char_map_ref map, const char * identifier, const size_t length );
69		69
-		70	/** Returns the value assigned to the map.
-		71	* @param map The character string to integer map. Input parameter.
-		72	* @returns The integral value assigned to the map.
-		73	* @returns CHAR_MAP_NULL if the map is not assigned a value.
-		74	*/
-		75	int char_map_get_value( const char_map_ref map );
-		76
70	/** Checks if the map is valid.	77	/** Checks if the map is valid.
71	* @param map The character string to integer map. Input parameter.	78	* @param map The character string to integer map. Input parameter.
72	* @returns TRUE if the map is valid.	79	* @returns TRUE if the map is valid.
73	* @returns FALSE otherwise.	80	* @returns FALSE otherwise.
74	*/	81	*/
75	int char_map_is_valid( const char_map_ref map );	82	int char_map_is_valid( const char_map_ref map );
76		83
77	int char_map_add( char_map_ref map, const char * identifier, size_t length, const int value ){	84	int char_map_add( char_map_ref map, const char * identifier, size_t length, const int value ){
78	if( char_map_is_valid( map ) && ( identifier ) && (( length ) \|\| ( * identifier ))){	85	if( char_map_is_valid( map ) && ( identifier ) && (( length ) \|\| ( * identifier ))){
79	int index;	86	int index;
80		87
81	for( index = 0; index < map->next; ++ index ){	88	for( index = 0; index < map->next; ++ index ){
82	if( map->items[ index ]->c == * identifier ){	89	if( map->items[ index ]->c == * identifier ){
83	++ identifier;	90	++ identifier;
84	if(( length > 1 ) \|\| (( length == 0 ) && ( * identifier ))){	91	if(( length > 1 ) \|\| (( length == 0 ) && ( * identifier ))){
85	return char_map_add( map->items[ index ], identifier, length ? length - 1 : 0, value );	92	return char_map_add( map->items[ index ], identifier, length ? length - 1 : 0, value );
86	}else{	93	}else{
87	if( map->items[ index ]->value != CHAR_MAP_NULL ) return EEXISTS;	94	if( map->items[ index ]->value != CHAR_MAP_NULL ) return EEXISTS;
88	map->items[ index ]->value = value;	95	map->items[ index ]->value = value;
89	return EOK;	96	return EOK;
90	}	97	}
91	}	98	}
92	}	99	}
93	return char_map_add_item( map, identifier, length, value );	100	return char_map_add_item( map, identifier, length, value );
94	}	101	}
95	return EINVAL;	102	return EINVAL;
96	}	103	}
97		104
98	int char_map_add_item( char_map_ref map, const char * identifier, size_t length, const int value ){	105	int char_map_add_item( char_map_ref map, const char * identifier, size_t length, const int value ){
99	if( map->next == ( map->size - 1 )){	106	if( map->next == ( map->size - 1 )){
100	char_map_ref * tmp;	107	char_map_ref * tmp;
101		108
102	tmp = ( char_map_ref * ) realloc( map->items, sizeof( char_map_ref ) * 2 * map->size );	109	tmp = ( char_map_ref * ) realloc( map->items, sizeof( char_map_ref ) * 2 * map->size );
103	if( ! tmp ) return ENOMEM;	110	if( ! tmp ) return ENOMEM;
104	map->size *= 2;	111	map->size *= 2;
105	map->items = tmp;	112	map->items = tmp;
106	}	113	}
107	map->items[ map->next ] = ( char_map_ref ) malloc( sizeof( char_map_t ));	114	map->items[ map->next ] = ( char_map_ref ) malloc( sizeof( char_map_t ));
108	if( ! map->items[ map->next ] ) return ENOMEM;	115	if( ! map->items[ map->next ] ) return ENOMEM;
109	if( char_map_initialize( map->items[ map->next ] ) != EOK ){	116	if( char_map_initialize( map->items[ map->next ] ) != EOK ){
110	free( map->items[ map->next ] );	117	free( map->items[ map->next ] );
111	map->items[ map->next ] = NULL;	118	map->items[ map->next ] = NULL;
112	return ENOMEM;	119	return ENOMEM;
113	}	120	}
114	map->items[ map->next ]->c = * identifier;	121	map->items[ map->next ]->c = * identifier;
115	++ identifier;	122	++ identifier;
116	++ map->next;	123	++ map->next;
117	if(( length > 1 ) \|\| (( length == 0 ) && ( * identifier ))){	124	if(( length > 1 ) \|\| (( length == 0 ) && ( * identifier ))){
118	map->items[ map->next - 1 ]->value = CHAR_MAP_NULL;	125	map->items[ map->next - 1 ]->value = CHAR_MAP_NULL;
119	return char_map_add_item( map->items[ map->next - 1 ], identifier, length ? length - 1 : 0, value );	126	return char_map_add_item( map->items[ map->next - 1 ], identifier, length ? length - 1 : 0, value );
120	}else{	127	}else{
121	map->items[ map->next - 1 ]->value = value;	128	map->items[ map->next - 1 ]->value = value;
122	}	129	}
123	return EOK;	130	return EOK;
124	}	131	}
125		132
126	void char_map_destroy( char_map_ref map ){	133	void char_map_destroy( char_map_ref map ){
127	if( char_map_is_valid( map )){	134	if( char_map_is_valid( map )){
128	int index;	135	int index;
129		136
130	map->magic = 0;	137	map->magic = 0;
131	for( index = 0; index < map->next; ++ index ){	138	for( index = 0; index < map->next; ++ index ){
132	char_map_destroy( map->items[ index ] );	139	char_map_destroy( map->items[ index ] );
133	}	140	}
134	free( map->items );	141	free( map->items );
135	map->items = NULL;	142	map->items = NULL;
136	}	143	}
137	}	144	}
138		145
139	int char_map_exclude( char_map_ref map, const char * identifier, size_t length ){	146	int char_map_exclude( char_map_ref map, const char * identifier, size_t length ){
140	char_map_ref node;	147	char_map_ref node;
141		148
142	node = char_map_find_node( map, identifier, length );	149	node = char_map_find_node( map, identifier, length );
143	if( node ){	150	if( node ){
144	int value;	151	int value;
145		152
146	value = node->value;	153	value = node->value;
147	node->value = CHAR_MAP_NULL;	154	node->value = CHAR_MAP_NULL;
148	return value;	155	return value;
149	}	156	}
150	return CHAR_MAP_NULL;	157	return CHAR_MAP_NULL;
151	}	158	}
152		159
153	int char_map_find( const char_map_ref map, const char * identifier, size_t length ){	160	int char_map_find( const char_map_ref map, const char * identifier, size_t length ){
154	char_map_ref node;	161	char_map_ref node;
155		162
156	node = char_map_find_node( map, identifier, length );	163	node = char_map_find_node( map, identifier, length );
157	return node ? node->value : CHAR_MAP_NULL;	164	return node ? node->value : CHAR_MAP_NULL;
158	}	165	}
159		166
160	char_map_ref char_map_find_node( const char_map_ref map, const char * identifier, size_t length ){	167	char_map_ref char_map_find_node( const char_map_ref map, const char * identifier, size_t length ){
161	if( ! char_map_is_valid( map )) return NULL;	168	if( ! char_map_is_valid( map )) return NULL;
162	if( length \|\| ( * identifier )){	169	if( length \|\| ( * identifier )){
163	int index;	170	int index;
164		171
165	for( index = 0; index < map->next; ++ index ){	172	for( index = 0; index < map->next; ++ index ){
166	if( map->items[ index ]->c == * identifier ){	173	if( map->items[ index ]->c == * identifier ){
167	++ identifier;	174	++ identifier;
168	if( length == 1 ) return map->items[ index ];	175	if( length == 1 ) return map->items[ index ];
169	return char_map_find_node( map->items[ index ], identifier, length ? length - 1 : 0 );	176	return char_map_find_node( map->items[ index ], identifier, length ? length - 1 : 0 );
170	}	177	}
171	}	178	}
172	return NULL;	179	return NULL;
173	}	180	}
174	return map;	181	return map;
175	}	182	}
176		183
177	int char_map_get_value( const char_map_ref map ){	184	int char_map_get_value( const char_map_ref map ){
178	return char_map_is_valid( map ) ? map->value : CHAR_MAP_NULL;	185	return char_map_is_valid( map ) ? map->value : CHAR_MAP_NULL;
179	}	186	}
180		187
181	int char_map_initialize( char_map_ref map ){	188	int char_map_initialize( char_map_ref map ){
182	if( ! map ) return EINVAL;	189	if( ! map ) return EINVAL;
183	map->c = '\0';	190	map->c = '\0';
184	map->value = CHAR_MAP_NULL;	191	map->value = CHAR_MAP_NULL;
185	map->size = 2;	192	map->size = 2;
186	map->next = 0;	193	map->next = 0;
187	map->items = malloc( sizeof( char_map_ref ) * map->size );	194	map->items = malloc( sizeof( char_map_ref ) * map->size );
188	if( ! map->items ){	195	if( ! map->items ){
189	map->magic = 0;	196	map->magic = 0;
190	return ENOMEM;	197	return ENOMEM;
191	}	198	}
192	map->items[ map->next ] = NULL;	199	map->items[ map->next ] = NULL;
193	map->magic = CHAR_MAP_MAGIC_VALUE;	200	map->magic = CHAR_MAP_MAGIC_VALUE;
194	return EOK;	201	return EOK;
195	}	202	}
196		203
197	int char_map_is_valid( const char_map_ref map ){	204	int char_map_is_valid( const char_map_ref map ){
198	return map && ( map->magic == CHAR_MAP_MAGIC_VALUE );	205	return map && ( map->magic == CHAR_MAP_MAGIC_VALUE );
199	}	206	}
200		207
201	int char_map_update( char_map_ref map, const char * identifier, const size_t length, const int value ){	208	int char_map_update( char_map_ref map, const char * identifier, const size_t length, const int value ){
202	char_map_ref node;	209	char_map_ref node;
203		210
204	// if( ! char_map_is_valid( map )) return EINVAL;	211	// if( ! char_map_is_valid( map )) return EINVAL;
205	node = char_map_find_node( map, identifier, length );	212	node = char_map_find_node( map, identifier, length );
206	if( node ){	213	if( node ){
207	node->value = value;	214	node->value = value;
208	return EOK;	215	return EOK;
209	}else{	216	}else{
210	return char_map_add( map, identifier, length, value );	217	return char_map_add( map, identifier, length, value );
211	}	218	}
212	}	219	}
213		220
214	/** @}	221	/** @}
215	*/	222	*/
216		223