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);
45 XBT_PUBLIC(long int) xbt_str_parse_int(const char* str, const char* error_msg);
46 XBT_PUBLIC(double) xbt_str_parse_double(const char* str, const char* error_msg);
48 #define XBT_DJB2_HASH_FUNCTION
49 //#define XBT_FNV_HASH_FUNCTION
52 * @brief Returns the hash code of a string.
54 static inline unsigned int xbt_str_hash_ext(const char *str, int str_len)
56 #ifdef XBT_DJB2_HASH_FUNCTION
57 /* fast implementation of djb2 algorithm */
58 unsigned int hash = 5381;
62 hash = ((hash << 5) + hash) + c; /* hash * 33 + c */
64 # elif defined(XBT_FNV_HASH_FUNCTION)
65 unsigned int hash = 0x811c9dc5;
66 unsigned char *bp = (unsigned char *) str; /* start of buffer */
67 unsigned char *be = bp + str_len; /* beyond end of buffer */
70 /* multiply by the 32 bit FNV magic prime mod 2^32 */
72 (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) +
75 /* xor the bottom with the current octet */
76 hash ^= (unsigned int) *bp++;
80 unsigned int hash = 0;
83 hash += (*str) * (*str);
92 * @brief Returns the hash code of a string.
94 static inline unsigned int xbt_str_hash(const char *str)
96 #ifdef XBT_DJB2_HASH_FUNCTION
97 /* fast implementation of djb2 algorithm */
99 unsigned int hash = 5381;
101 while ((c = *str++)) {
102 hash = ((hash << 5) + hash) + c; /* hash * 33 + c */
105 # elif defined(XBT_FNV_HASH_FUNCTION)
106 unsigned int hash = 0x811c9dc5;
109 /* multiply by the 32 bit FNV magic prime mod 2^32 */
110 hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
112 /* xor the bottom with the current byte */
113 hash ^= (unsigned int) *str++;
117 unsigned int hash = 0;
120 hash += (*str) * (*str);
129 #endif /* XBT_STR_H */