Project::OSiRiON - Git repositories
Project::OSiRiON
News . About . Screenshots . Downloads . Forum . Wiki . Tracker . Git
summaryrefslogtreecommitdiff
blob: 557ab45b626ea549024fca70b84d5c02e07e3af2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
/*
   aux/functions.h
   This file is part of the Osirion project and is distributed under
   the terms of the GNU General Public License version 2
*/

#ifndef __INCLUDED_AUX_FUNCTIONS_H__
#define __INCLUDED_AUX_FUNCTIONS_H__

#include <string>


/// auxiliary functions
namespace aux
{

/// append an "s" to a word, depending on the amount
const std::string plural(const char * word, size_t n);

/// append an "s" to a word, depending on the amount
inline const std::string plural(const std::string & word, size_t n) { return plural(word.c_str(), n); }

/// prepend the "a" or "an" article to a word
const std::string article(const char * word);

inline const std::string article(const std::string & word) { return article(word.c_str()); }

inline bool is_base_color_code(char const *c) { return ((*c == '^') && (*(c+1) >= '0') && (*(c+1) <= '9')); }

inline bool is_core_color_code(char const *c) { return ((*c == '^') && (*(c+1) >= 'A') && (*(c+1) <= 'Z')); }

inline bool is_color_code(char const *c) { return (is_base_color_code(c) || is_core_color_code(c)); }

/// length of a string, excluding color codes
size_t text_length(const std::string &text);

/// prepend spaces to a string up to the desired lenght, excluding color codes
const std::string pad_left(const std::string &text, size_t n);

/// append spaces to a string up to the desired lenght, excluding color codes
const std::string pad_right(const std::string &text, size_t n);

/// convert a string to lowercase
void to_lowercase(std::string &text);

/// return text, converted to lowercase
const std::string lowercase(const std::string &text);

/// return text, stripped of color codes
const std::string text_strip(const std::string &text);

/// return text, stripped of color codes and converted to lowercase
const std::string text_strip_lowercase(const std::string &text);

/// trim leading ad trailing spaces from a string
void trim(std::string &text);

}

#endif // __INCLUDED_AUX_FUNCTIONS_H__