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(char *) xbt_str_from_file(FILE * file);
48 XBT_PUBLIC(long int) xbt_str_parse_int(const char* str, const char* error_msg);
49 XBT_PUBLIC(double) xbt_str_parse_double(const char* str, const char* error_msg);
51 #define XBT_DJB2_HASH_FUNCTION
52 //#define XBT_FNV_HASH_FUNCTION
55 * @brief Returns the hash code of a string.
57 static inline unsigned int xbt_str_hash_ext(const char *str, int str_len)
59 #ifdef XBT_DJB2_HASH_FUNCTION
60 /* fast implementation of djb2 algorithm */
62 unsigned int hash = 5381;
66 hash = ((hash << 5) + hash) + c; /* hash * 33 + c */
68 # elif defined(XBT_FNV_HASH_FUNCTION)
69 unsigned int hash = 0x811c9dc5;
70 unsigned char *bp = (unsigned char *) str; /* start of buffer */
71 unsigned char *be = bp + str_len; /* beyond end of buffer */
74 /* multiply by the 32 bit FNV magic prime mod 2^32 */
76 (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) +
79 /* xor the bottom with the current octet */
80 hash ^= (unsigned int) *bp++;
84 unsigned int hash = 0;
87 hash += (*str) * (*str);
96 * @brief Returns the hash code of a string.
98 static inline unsigned int xbt_str_hash(const char *str)
100 #ifdef XBT_DJB2_HASH_FUNCTION
101 /* fast implementation of djb2 algorithm */
103 unsigned int hash = 5381;
105 while ((c = *str++)) {
106 hash = ((hash << 5) + hash) + c; /* hash * 33 + c */
109 # elif defined(XBT_FNV_HASH_FUNCTION)
110 unsigned int hash = 0x811c9dc5;
113 /* multiply by the 32 bit FNV magic prime mod 2^32 */
114 hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
116 /* xor the bottom with the current byte */
117 hash ^= (unsigned int) *str++;
121 unsigned int hash = 0;
124 hash += (*str) * (*str);
133 #endif /* XBT_STR_H */