2008-07-30 06:05:13 -07:00
|
|
|
/*
|
|
|
|
* vim:ts=8:sw=3:sts=8:noexpandtab:cino=>5n-3f0^-2{2
|
|
|
|
*/
|
2008-08-06 11:15:24 -07:00
|
|
|
/* EINA - EFL data type library
|
|
|
|
* Copyright (C) 2002-2008 Carsten Haitzler, Jorge Luis Zapata Muga, Cedric Bail
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library;
|
|
|
|
* if not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*
|
|
|
|
* This file incorporates work covered by the following copyright and
|
|
|
|
* permission notice:
|
|
|
|
*
|
|
|
|
* Copyright (C) 2008 Peter Wehrfritz
|
|
|
|
*
|
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
* of this software and associated documentation files (the "Software"), to
|
|
|
|
* deal in the Software without restriction, including without limitation the
|
|
|
|
* rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
|
|
|
* sell copies of the Software, and to permit persons to whom the Software is
|
|
|
|
* furnished to do so, subject to the following conditions:
|
|
|
|
*
|
|
|
|
* The above copyright notice and this permission notice shall be included in
|
|
|
|
* all copies of the Software and its Copyright notices. In addition publicly
|
|
|
|
* documented acknowledgment must be given that this software has been used if no
|
|
|
|
* source code of this software is made available publicly. This includes
|
|
|
|
* acknowledgments in either Copyright notices, Manuals, Publicity and Marketing
|
|
|
|
* documents or any documentation provided with any product containing this
|
|
|
|
* software. This License does not apply to any software that links to the
|
|
|
|
* libraries provided by this software (statically or dynamically), but only to
|
|
|
|
* the software provided.
|
|
|
|
*
|
|
|
|
* Please see the OLD-COPYING.PLAIN for a plain-english explanation of this notice
|
|
|
|
* and it's intent.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
|
|
* THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
|
|
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
*/
|
2008-07-30 06:05:13 -07:00
|
|
|
|
2008-09-15 12:58:36 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @page tutorial_stringshare_page Stringshare Tutorial
|
|
|
|
*
|
|
|
|
* to be written...
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2008-07-30 06:05:13 -07:00
|
|
|
#ifdef HAVE_CONFIG_H
|
|
|
|
# include "config.h"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <string.h>
|
|
|
|
|
|
|
|
#include "eina_stringshare.h"
|
2008-08-06 11:15:24 -07:00
|
|
|
#include "eina_hash.h"
|
2008-08-28 07:27:43 -07:00
|
|
|
#include "eina_rbtree.h"
|
2008-08-01 05:26:35 -07:00
|
|
|
#include "eina_error.h"
|
2008-08-06 08:49:50 -07:00
|
|
|
#include "eina_private.h"
|
2008-09-25 02:02:41 -07:00
|
|
|
#include "eina_magic.h"
|
2008-07-30 06:05:13 -07:00
|
|
|
|
2008-08-28 00:46:42 -07:00
|
|
|
/*============================================================================*
|
|
|
|
* Local *
|
|
|
|
*============================================================================*/
|
|
|
|
|
2008-09-15 12:58:36 -07:00
|
|
|
/**
|
|
|
|
* @cond LOCAL
|
|
|
|
*/
|
|
|
|
|
2008-09-22 03:08:44 -07:00
|
|
|
#define EINA_STRINGSHARE_BUCKETS 256
|
2008-09-22 07:45:57 -07:00
|
|
|
#define EINA_STRINGSHARE_MASK 0xFF
|
2008-09-22 03:08:44 -07:00
|
|
|
|
2008-09-25 02:02:41 -07:00
|
|
|
#define EINA_MAGIC_CHECK_STRINGSHARE_HEAD(d) \
|
|
|
|
do { \
|
|
|
|
if (!EINA_MAGIC_CHECK((d), EINA_MAGIC_STRINGSHARE_HEAD)) \
|
|
|
|
EINA_MAGIC_FAIL((d), EINA_MAGIC_STRINGSHARE_HEAD); \
|
|
|
|
} while (0);
|
|
|
|
|
|
|
|
#define EINA_MAGIC_CHECK_STRINGSHARE_NODE(d) \
|
|
|
|
do { \
|
|
|
|
if (!EINA_MAGIC_CHECK((d), EINA_MAGIC_STRINGSHARE_NODE)) \
|
|
|
|
EINA_MAGIC_FAIL((d), EINA_MAGIC_STRINGSHARE_NODE); \
|
|
|
|
} while (0);
|
|
|
|
|
2008-07-30 07:42:37 -07:00
|
|
|
typedef struct _Eina_Stringshare Eina_Stringshare;
|
|
|
|
typedef struct _Eina_Stringshare_Node Eina_Stringshare_Node;
|
2008-09-15 05:54:54 -07:00
|
|
|
typedef struct _Eina_Stringshare_Head Eina_Stringshare_Head;
|
2008-07-30 06:05:13 -07:00
|
|
|
|
|
|
|
struct _Eina_Stringshare
|
|
|
|
{
|
2008-09-22 03:08:44 -07:00
|
|
|
Eina_Stringshare_Head *buckets[EINA_STRINGSHARE_BUCKETS];
|
2008-09-25 02:02:41 -07:00
|
|
|
|
|
|
|
EINA_MAGIC;
|
2008-09-15 05:54:54 -07:00
|
|
|
};
|
|
|
|
|
|
|
|
struct _Eina_Stringshare_Head
|
|
|
|
{
|
2008-09-24 05:57:26 -07:00
|
|
|
EINA_RBTREE;
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC;
|
2008-09-15 05:54:54 -07:00
|
|
|
int hash;
|
|
|
|
|
|
|
|
Eina_Stringshare_Node *head;
|
2008-07-30 06:05:13 -07:00
|
|
|
};
|
|
|
|
|
2008-07-30 07:42:37 -07:00
|
|
|
struct _Eina_Stringshare_Node
|
2008-07-30 06:05:13 -07:00
|
|
|
{
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC;
|
|
|
|
|
2008-09-15 05:54:54 -07:00
|
|
|
Eina_Stringshare_Node *next;
|
|
|
|
|
|
|
|
int length;
|
|
|
|
int references;
|
2008-09-22 06:06:29 -07:00
|
|
|
|
|
|
|
Eina_Bool begin : 1;
|
2008-07-30 06:05:13 -07:00
|
|
|
};
|
|
|
|
|
2008-07-30 07:42:37 -07:00
|
|
|
static Eina_Stringshare *share = NULL;
|
2008-09-03 05:06:50 -07:00
|
|
|
static int _eina_stringshare_init_count = 0;
|
2008-07-30 06:05:13 -07:00
|
|
|
|
2008-08-29 02:34:39 -07:00
|
|
|
static int
|
2008-09-25 02:02:41 -07:00
|
|
|
_eina_stringshare_cmp(const Eina_Stringshare_Head *ed, const int *hash, __UNUSED__ int length, __UNUSED__ void *data)
|
2008-08-29 02:34:39 -07:00
|
|
|
{
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_CHECK_STRINGSHARE_HEAD(ed);
|
|
|
|
|
|
|
|
return ed->hash - *hash;
|
2008-08-29 02:34:39 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
static Eina_Rbtree_Direction
|
2008-09-15 05:54:54 -07:00
|
|
|
_eina_stringshare_node(const Eina_Stringshare_Head *left, const Eina_Stringshare_Head *right, __UNUSED__ void *data)
|
2008-08-29 02:34:39 -07:00
|
|
|
{
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_CHECK_STRINGSHARE_HEAD(left);
|
|
|
|
EINA_MAGIC_CHECK_STRINGSHARE_HEAD(right);
|
|
|
|
|
2008-09-15 05:54:54 -07:00
|
|
|
if (left->hash - right->hash < 0)
|
2008-08-29 02:34:39 -07:00
|
|
|
return EINA_RBTREE_LEFT;
|
|
|
|
return EINA_RBTREE_RIGHT;
|
|
|
|
}
|
|
|
|
|
2008-09-23 09:07:48 -07:00
|
|
|
static void
|
2008-09-24 10:14:29 -07:00
|
|
|
_eina_stringshare_head_free(Eina_Stringshare_Head *ed, __UNUSED__ void *data)
|
2008-09-23 09:07:48 -07:00
|
|
|
{
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_CHECK_STRINGSHARE_HEAD(ed);
|
|
|
|
|
2008-09-23 09:07:48 -07:00
|
|
|
while (ed->head)
|
|
|
|
{
|
|
|
|
Eina_Stringshare_Node *el = ed->head;
|
|
|
|
|
|
|
|
ed->head = ed->head->next;
|
2008-09-25 02:02:41 -07:00
|
|
|
if (el->begin == EINA_FALSE)
|
|
|
|
MAGIC_FREE(el);
|
2008-09-23 09:07:48 -07:00
|
|
|
}
|
2008-09-25 02:02:41 -07:00
|
|
|
MAGIC_FREE(ed);
|
2008-09-23 09:07:48 -07:00
|
|
|
}
|
|
|
|
|
2008-09-15 12:58:36 -07:00
|
|
|
/**
|
|
|
|
* @endcond
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
2008-08-28 00:46:42 -07:00
|
|
|
/*============================================================================*
|
|
|
|
* Global *
|
|
|
|
*============================================================================*/
|
|
|
|
|
|
|
|
/*============================================================================*
|
|
|
|
* API *
|
|
|
|
*============================================================================*/
|
|
|
|
|
2008-07-30 07:42:37 -07:00
|
|
|
/**
|
2008-09-18 22:22:43 -07:00
|
|
|
* @addtogroup Eina_Data_Types_Group Data Types
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup Eina_Stringshare_Group Stringshare
|
2008-07-30 07:42:37 -07:00
|
|
|
*
|
|
|
|
* These functions allow you to store one copy of a string, and use it
|
|
|
|
* throughout your program.
|
|
|
|
*
|
|
|
|
* This is a method to reduce the number of duplicated strings kept in
|
|
|
|
* memory. It's pretty common for the same strings to be dynamically
|
|
|
|
* allocated repeatedly between applications and libraries, especially in
|
|
|
|
* circumstances where you could have multiple copies of a structure that
|
|
|
|
* allocates the string. So rather than duplicating and freeing these
|
|
|
|
* strings, you request a read-only pointer to an existing string and
|
|
|
|
* only incur the overhead of a hash lookup.
|
|
|
|
*
|
|
|
|
* It sounds like micro-optimizing, but profiling has shown this can have
|
|
|
|
* a significant impact as you scale the number of copies up. It improves
|
|
|
|
* string creation/destruction speed, reduces memory use and decreases
|
|
|
|
* memory fragmentation, so a win all-around.
|
2008-08-28 00:46:42 -07:00
|
|
|
*
|
2008-09-15 12:58:36 -07:00
|
|
|
* For more information, you can look at the @ref tutorial_stringshare_page.
|
|
|
|
*
|
2008-08-28 00:46:42 -07:00
|
|
|
* @{
|
2008-07-30 07:42:37 -07:00
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2008-09-15 12:58:36 -07:00
|
|
|
* @brief Initialize the eina stringshare internal structure.
|
|
|
|
*
|
|
|
|
* @return 1 or greater on success, 0 on error.
|
|
|
|
*
|
|
|
|
* This function allocates the memory needed by the stringshare
|
2008-09-17 11:55:54 -07:00
|
|
|
* internal structure and sets up the error module of Eina. It is also
|
2008-09-15 12:58:36 -07:00
|
|
|
* called by eina_init(). It returns 0 on failure, otherwise it
|
|
|
|
* returns the number of times it has already been called.
|
2008-07-30 07:42:37 -07:00
|
|
|
*/
|
2008-08-01 05:26:35 -07:00
|
|
|
EAPI int
|
2008-07-30 07:42:37 -07:00
|
|
|
eina_stringshare_init()
|
|
|
|
{
|
|
|
|
/*
|
|
|
|
* No strings have been loaded at this point, so create the hash
|
|
|
|
* table for storing string info for later.
|
|
|
|
*/
|
2008-09-03 05:06:50 -07:00
|
|
|
if (!_eina_stringshare_init_count)
|
2008-07-30 07:42:37 -07:00
|
|
|
{
|
|
|
|
share = calloc(1, sizeof(Eina_Stringshare));
|
|
|
|
if (!share)
|
|
|
|
return 0;
|
2008-09-25 02:02:41 -07:00
|
|
|
|
2008-08-01 07:23:54 -07:00
|
|
|
eina_error_init();
|
2008-09-25 02:02:41 -07:00
|
|
|
eina_magic_string_init();
|
|
|
|
|
|
|
|
eina_magic_string_set(EINA_MAGIC_STRINGSHARE,
|
|
|
|
"Eina Stringshare");
|
|
|
|
eina_magic_string_set(EINA_MAGIC_STRINGSHARE_HEAD,
|
|
|
|
"Eina Stringshare Head");
|
|
|
|
eina_magic_string_set(EINA_MAGIC_STRINGSHARE_NODE,
|
|
|
|
"Eina Stringshare Node");
|
|
|
|
EINA_MAGIC_SET(share, EINA_MAGIC_STRINGSHARE);
|
2008-07-30 07:42:37 -07:00
|
|
|
}
|
|
|
|
|
2008-09-25 02:02:41 -07:00
|
|
|
return ++_eina_stringshare_init_count;
|
2008-07-30 07:42:37 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2008-09-15 12:58:36 -07:00
|
|
|
* @brief Shut down the eina stringshare internal structures
|
|
|
|
*
|
|
|
|
* @return 0 when the stringshare module is completely shut down, 1 or
|
|
|
|
* greater otherwise.
|
|
|
|
*
|
|
|
|
* This function frees the memory allocated by eina_stringshare_init()
|
2008-09-17 11:55:54 -07:00
|
|
|
* and shuts down the error module. It is also called by
|
2008-09-15 12:58:36 -07:00
|
|
|
* eina_shutdown(). It returns 0 when it is called the same number of
|
|
|
|
* times than eina_stringshare_init().
|
|
|
|
*/
|
|
|
|
EAPI int
|
|
|
|
eina_stringshare_shutdown()
|
|
|
|
{
|
|
|
|
--_eina_stringshare_init_count;
|
|
|
|
if (!_eina_stringshare_init_count)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
/* remove any string still in the table */
|
2008-09-22 03:08:44 -07:00
|
|
|
for (i = 0; i < EINA_STRINGSHARE_BUCKETS; i++)
|
2008-09-15 12:58:36 -07:00
|
|
|
{
|
2008-09-24 10:14:29 -07:00
|
|
|
eina_rbtree_delete(EINA_RBTREE_GET(share->buckets[i]), EINA_RBTREE_FREE_CB(_eina_stringshare_head_free), NULL);
|
2008-09-15 12:58:36 -07:00
|
|
|
share->buckets[i] = NULL;
|
|
|
|
}
|
2008-09-25 02:02:41 -07:00
|
|
|
MAGIC_FREE(share);
|
2008-09-15 12:58:36 -07:00
|
|
|
|
2008-09-25 02:02:41 -07:00
|
|
|
eina_magic_string_shutdown();
|
2008-09-15 12:58:36 -07:00
|
|
|
eina_error_shutdown();
|
|
|
|
}
|
|
|
|
|
|
|
|
return _eina_stringshare_init_count;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Retrieve an instance of a string for use in a program.
|
|
|
|
*
|
2008-07-30 07:42:37 -07:00
|
|
|
* @param str The string to retrieve an instance of.
|
|
|
|
* @return A pointer to an instance of the string on success.
|
|
|
|
* @c NULL on failure.
|
2008-09-15 12:58:36 -07:00
|
|
|
*
|
|
|
|
* This function retrieves an instance of @p str. If @p str is
|
|
|
|
* @c NULL, then @c NULL is returned. If @p str is already stored, it
|
|
|
|
* is just returned and its reference counter is increased. Otherwise
|
|
|
|
* it is added to the strings to be searched and a duplicated string
|
|
|
|
* of @p str is returned.
|
2008-07-30 07:42:37 -07:00
|
|
|
*/
|
2008-07-30 06:05:13 -07:00
|
|
|
EAPI const char *
|
|
|
|
eina_stringshare_add(const char *str)
|
|
|
|
{
|
2008-09-22 06:06:29 -07:00
|
|
|
Eina_Stringshare_Node *nel = NULL;
|
|
|
|
Eina_Stringshare_Node *tmp;
|
2008-09-15 05:54:54 -07:00
|
|
|
Eina_Stringshare_Head *ed;
|
2008-08-28 07:27:43 -07:00
|
|
|
Eina_Stringshare_Node *el;
|
2008-07-30 06:05:13 -07:00
|
|
|
char *el_str;
|
2008-09-15 05:54:54 -07:00
|
|
|
int hash_num, slen, hash;
|
2008-07-30 06:05:13 -07:00
|
|
|
|
|
|
|
if (!str) return NULL;
|
2008-09-15 06:38:42 -07:00
|
|
|
hash = eina_hash_djb2_len(str, &slen);
|
2008-09-15 05:54:54 -07:00
|
|
|
hash_num = hash & 0xFF;
|
2008-09-22 07:45:57 -07:00
|
|
|
hash &= EINA_STRINGSHARE_MASK;
|
2008-09-15 05:54:54 -07:00
|
|
|
|
|
|
|
ed = (Eina_Stringshare_Head*) eina_rbtree_inline_lookup((Eina_Rbtree*) share->buckets[hash_num],
|
|
|
|
&hash, sizeof (hash),
|
|
|
|
EINA_RBTREE_CMP_KEY_CB(_eina_stringshare_cmp), NULL);
|
|
|
|
if (!ed)
|
|
|
|
{
|
2008-09-22 06:06:29 -07:00
|
|
|
ed = malloc(sizeof (Eina_Stringshare_Head) + sizeof (Eina_Stringshare_Node) + slen);
|
2008-09-15 05:54:54 -07:00
|
|
|
if (!ed) return NULL;
|
|
|
|
ed->hash = hash;
|
|
|
|
ed->head = NULL;
|
|
|
|
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_SET(ed, EINA_MAGIC_STRINGSHARE_HEAD);
|
|
|
|
|
2008-09-15 05:54:54 -07:00
|
|
|
share->buckets[hash_num] = (Eina_Stringshare_Head*) eina_rbtree_inline_insert((Eina_Rbtree*) share->buckets[hash_num],
|
2008-09-24 05:57:26 -07:00
|
|
|
EINA_RBTREE_GET(ed),
|
2008-09-15 05:54:54 -07:00
|
|
|
EINA_RBTREE_CMP_NODE_CB(_eina_stringshare_node), NULL);
|
2008-09-22 06:06:29 -07:00
|
|
|
|
|
|
|
nel = (Eina_Stringshare_Node*) (ed + 1);
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_SET(nel, EINA_MAGIC_STRINGSHARE_NODE);
|
2008-09-22 06:06:29 -07:00
|
|
|
nel->begin = EINA_TRUE;
|
2008-09-15 05:54:54 -07:00
|
|
|
}
|
|
|
|
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_CHECK_STRINGSHARE_HEAD(ed);
|
|
|
|
|
2008-09-22 06:06:29 -07:00
|
|
|
for (el = ed->head, tmp = NULL;
|
2008-09-15 05:54:54 -07:00
|
|
|
el && slen != el->length && memcmp(str, (const char*) (el + 1), slen) != 0;
|
2008-09-22 06:06:29 -07:00
|
|
|
tmp = el, el = el->next)
|
2008-09-15 05:54:54 -07:00
|
|
|
;
|
2008-08-28 07:27:43 -07:00
|
|
|
|
|
|
|
if (el)
|
2008-07-30 06:05:13 -07:00
|
|
|
{
|
2008-09-22 06:06:29 -07:00
|
|
|
if (tmp)
|
|
|
|
{
|
|
|
|
tmp->next = el->next;
|
|
|
|
el->next = ed->head;
|
|
|
|
ed->head = el;
|
|
|
|
}
|
|
|
|
|
2008-08-28 07:27:43 -07:00
|
|
|
el->references++;
|
|
|
|
return (const char*) (el + 1);
|
2008-07-30 06:05:13 -07:00
|
|
|
}
|
2008-08-28 07:27:43 -07:00
|
|
|
|
2008-09-22 06:06:29 -07:00
|
|
|
if (!nel)
|
|
|
|
{
|
|
|
|
nel = malloc(sizeof (Eina_Stringshare_Node) + slen);
|
|
|
|
if (!nel) return NULL;
|
|
|
|
nel->begin = EINA_FALSE;
|
2008-09-25 02:02:41 -07:00
|
|
|
|
|
|
|
EINA_MAGIC_SET(nel, EINA_MAGIC_STRINGSHARE_NODE);
|
2008-09-22 06:06:29 -07:00
|
|
|
}
|
2008-08-28 07:27:43 -07:00
|
|
|
|
2008-09-22 06:06:29 -07:00
|
|
|
nel->references = 1;
|
|
|
|
nel->length = slen;
|
|
|
|
|
|
|
|
el_str = (char*) (nel + 1);
|
2008-08-29 09:09:39 -07:00
|
|
|
memcpy(el_str, str, slen);
|
2008-08-28 07:27:43 -07:00
|
|
|
|
2008-09-22 06:06:29 -07:00
|
|
|
nel->next = ed->head;
|
|
|
|
ed->head = nel;
|
2008-08-28 07:27:43 -07:00
|
|
|
|
2008-07-30 06:05:13 -07:00
|
|
|
return el_str;
|
|
|
|
}
|
|
|
|
|
2008-07-30 07:42:37 -07:00
|
|
|
/**
|
2008-09-15 12:58:36 -07:00
|
|
|
* @brief Note that the given string has lost an instance.
|
2008-07-30 07:42:37 -07:00
|
|
|
*
|
2008-08-08 22:47:15 -07:00
|
|
|
* @param str string The given string.
|
2008-09-15 12:58:36 -07:00
|
|
|
*
|
|
|
|
* This function decreases the reference counter associated to @p str
|
|
|
|
* if it exists. If that counter reaches 0, the memory associated to
|
|
|
|
* @p str is freed. If @p str is NULL, the function returns
|
|
|
|
* immediatly.
|
2008-07-30 07:42:37 -07:00
|
|
|
*/
|
2008-07-30 06:05:13 -07:00
|
|
|
EAPI void
|
|
|
|
eina_stringshare_del(const char *str)
|
|
|
|
{
|
2008-09-15 05:54:54 -07:00
|
|
|
Eina_Stringshare_Head *ed;
|
2008-08-28 07:27:43 -07:00
|
|
|
Eina_Stringshare_Node *el;
|
2008-09-15 05:54:54 -07:00
|
|
|
Eina_Stringshare_Node *prev;
|
|
|
|
int hash_num, slen, hash;
|
2008-07-30 06:05:13 -07:00
|
|
|
|
|
|
|
if (!str) return;
|
2008-09-15 06:38:42 -07:00
|
|
|
hash = eina_hash_djb2_len(str, &slen);
|
2008-09-15 05:54:54 -07:00
|
|
|
hash_num = hash & 0xFF;
|
2008-09-22 07:45:57 -07:00
|
|
|
hash &= EINA_STRINGSHARE_MASK;
|
2008-09-15 05:54:54 -07:00
|
|
|
|
2008-09-24 05:57:26 -07:00
|
|
|
ed = (Eina_Stringshare_Head*) eina_rbtree_inline_lookup(EINA_RBTREE_GET(share->buckets[hash_num]),
|
2008-09-15 05:54:54 -07:00
|
|
|
&hash, sizeof (hash),
|
|
|
|
EINA_RBTREE_CMP_KEY_CB(_eina_stringshare_cmp), NULL);
|
|
|
|
if (!ed) goto on_error;
|
|
|
|
|
2008-09-25 02:02:41 -07:00
|
|
|
EINA_MAGIC_CHECK_STRINGSHARE_HEAD(ed);
|
|
|
|
|
2008-09-15 05:54:54 -07:00
|
|
|
for (prev = NULL, el = ed->head;
|
|
|
|
el && (const char*) (el + 1) != str;
|
|
|
|
el = el->next)
|
|
|
|
;
|
2008-08-28 07:27:43 -07:00
|
|
|
|
2008-09-22 06:06:29 -07:00
|
|
|
if (!el) goto on_error;
|
|
|
|
|
|
|
|
el->references--;
|
|
|
|
if (el->references == 0)
|
2008-07-30 06:05:13 -07:00
|
|
|
{
|
2008-09-22 06:06:29 -07:00
|
|
|
if (prev) prev->next = el->next;
|
|
|
|
else ed->head = el->next;
|
2008-09-25 02:02:41 -07:00
|
|
|
if (el->begin == EINA_FALSE)
|
|
|
|
MAGIC_FREE(el);
|
2008-09-15 05:54:54 -07:00
|
|
|
|
2008-09-22 06:06:29 -07:00
|
|
|
if (ed->head == NULL)
|
|
|
|
{
|
2008-09-24 05:57:26 -07:00
|
|
|
share->buckets[hash_num] = (Eina_Stringshare_Head*) eina_rbtree_inline_remove(EINA_RBTREE_GET(share->buckets[hash_num]),
|
|
|
|
EINA_RBTREE_GET(ed),
|
|
|
|
EINA_RBTREE_CMP_NODE_CB(_eina_stringshare_node),
|
2008-09-22 06:06:29 -07:00
|
|
|
NULL);
|
2008-09-25 02:02:41 -07:00
|
|
|
MAGIC_FREE(ed);
|
2008-07-30 06:05:13 -07:00
|
|
|
}
|
|
|
|
}
|
2008-09-22 06:06:29 -07:00
|
|
|
return ;
|
2008-09-15 05:54:54 -07:00
|
|
|
|
|
|
|
on_error:
|
2008-08-01 05:26:35 -07:00
|
|
|
EINA_ERROR_PWARN("EEEK trying to del non-shared stringshare \"%s\"\n", str);
|
|
|
|
if (getenv("EINA_ERROR_ABORT")) abort();
|
2008-07-30 06:05:13 -07:00
|
|
|
}
|
2008-07-30 07:42:37 -07:00
|
|
|
|
2008-08-28 00:46:42 -07:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|
2008-09-18 22:22:43 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|