1 /* str.h - XBT string related functions. */
3 /* Copyright (c) 2007-2015. The SimGrid Team.
4 * All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
13 #include "xbt/dynar.h"
16 #include <stdarg.h> /* va_* */
17 #include <stdio.h> /* FILE */
21 /** @addtogroup XBT_str
22 * @brief String manipulation functions
24 * This module defines several string related functions. Looking at the diversity of string manipulation functions that
25 * are provided, you can see that several SimGrid core developers actually like Perl.
29 /* Trim related functions */
30 XBT_PUBLIC(void) xbt_str_rtrim(char *s, const char *char_list);
31 XBT_PUBLIC(void) xbt_str_ltrim(char *s, const char *char_list);
32 XBT_PUBLIC(void) xbt_str_trim(char *s, const char *char_list);
34 XBT_PUBLIC(xbt_dynar_t) xbt_str_split(const char *s, const char *sep);
35 XBT_PUBLIC(xbt_dynar_t) xbt_str_split_quoted(const char *s);
36 XBT_PUBLIC(xbt_dynar_t) xbt_str_split_quoted_in_place(char *s);
38 XBT_PUBLIC(xbt_dynar_t) xbt_str_split_str(const char *s, const char *sep);
40 XBT_PUBLIC(char *) xbt_str_join(xbt_dynar_t dynar, const char *sep);
41 XBT_PUBLIC(char *) xbt_str_join_array(const char *const *strs, const char *sep);
43 XBT_PUBLIC(void) xbt_str_subst(char *str, char from, char to, int amount);
44 XBT_PUBLIC(char *) xbt_str_varsubst(const char *str, xbt_dict_t patterns);
46 XBT_PUBLIC(long int) xbt_str_parse_int(const char* str, const char* error_msg);
47 XBT_PUBLIC(double) xbt_str_parse_double(const char* str, const char* error_msg);
49 #define XBT_DJB2_HASH_FUNCTION
50 //#define XBT_FNV_HASH_FUNCTION
53 * @brief Returns the hash code of a string.
55 static inline unsigned int xbt_str_hash_ext(const char *str, int str_len)
57 #ifdef XBT_DJB2_HASH_FUNCTION
58 /* fast implementation of djb2 algorithm */
60 unsigned int hash = 5381;
64 hash = ((hash << 5) + hash) + c; /* hash * 33 + c */
66 # elif defined(XBT_FNV_HASH_FUNCTION)
67 unsigned int hash = 0x811c9dc5;
68 unsigned char *bp = (unsigned char *) str; /* start of buffer */
69 unsigned char *be = bp + str_len; /* beyond end of buffer */
72 /* multiply by the 32 bit FNV magic prime mod 2^32 */
74 (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) +
77 /* xor the bottom with the current octet */
78 hash ^= (unsigned int) *bp++;
82 unsigned int hash = 0;
85 hash += (*str) * (*str);
94 * @brief Returns the hash code of a string.
96 static inline unsigned int xbt_str_hash(const char *str)
98 #ifdef XBT_DJB2_HASH_FUNCTION
99 /* fast implementation of djb2 algorithm */
101 unsigned int hash = 5381;
103 while ((c = *str++)) {
104 hash = ((hash << 5) + hash) + c; /* hash * 33 + c */
107 # elif defined(XBT_FNV_HASH_FUNCTION)
108 unsigned int hash = 0x811c9dc5;
111 /* multiply by the 32 bit FNV magic prime mod 2^32 */
112 hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
114 /* xor the bottom with the current byte */
115 hash ^= (unsigned int) *str++;
119 unsigned int hash = 0;
122 hash += (*str) * (*str);
131 #endif /* XBT_STR_H */