File: string.h

package info (click to toggle)
inspircd 4.7.0%2Bds1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 7,776 kB
  • sloc: cpp: 110,200; ansic: 4,576; perl: 2,286; python: 169; sh: 132; sql: 99; makefile: 58
file content (87 lines) | stat: -rw-r--r-- 2,825 bytes parent folder | download
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
/*
 * InspIRCd -- Internet Relay Chat Daemon
 *
 *   Copyright (C) 2021, 2023 Sadie Powell <sadie@witchery.services>
 *   Copyright (C) 2016 Attila Molnar <attilamolnar@hush.com>
 *
 * This file is part of InspIRCd.  InspIRCd is free software: you can
 * redistribute it and/or modify it under the terms of the GNU General Public
 * License as published by the Free Software Foundation, version 2.
 *
 * This program 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 General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */


#pragma once

#include "utility/string.h"

namespace insp
{
	/** Combines a sequence of elements into a string.
	 * @param sequence A sequence of elements to combine.
	 * @param separator The value to separate the elements with. Defaults to ' ' (space).
	 */
	template<typename Collection, typename Separator = char>
	inline std::string join(const Collection& sequence, Separator separator = ' ')
	{
		std::string joined;
		if (sequence.empty())
			return joined;

		const std::string separatorstr = ConvToStr(separator);
		for (const auto& element : sequence)
			joined.append(ConvToStr(element)).append(separatorstr);

		joined.erase(joined.end() - separatorstr.length());
		joined.shrink_to_fit();
		return joined;
	}

	/** Creates a view of a subsection of a string.
	 * @param str The string to create a view of.
	 * @param begin The position within the string to start the view at.
	 * @param end The position within the string to end the view at.
	 */
	template <typename Iterator>
	std::string_view substring_view(const std::string& str, Iterator begin, Iterator end)
	{
		std::string_view sv = str;
		sv.remove_prefix(std::distance(str.begin(), begin));
		sv.remove_suffix(std::distance(end, str.end()));
		return sv;
	}

	/** Get underlying C string of the string passed as parameter. Useful in template functions.
	 * @param str A `const char*` string.
	 */
	inline const char* tocstr(const char* str)
	{
		return str;
	}

	/** Get underlying C string of the string passed as parameter. Useful in template functions.
	 * @param str A `std::string` string.
	 */
	inline const char* tocstr(const std::string& str)
	{
		return str.c_str();
	}

	/** Check if two strings are equal case insensitively.
	 * @param str1 First string to compare.
	 * @param str2 Second string to compare.
	 * @return True if the strings are equal case-insensitively; otherwise, false.
	 */
	template <typename S1, typename S2>
	inline bool equalsci(const S1& str1, const S2& str2)
	{
		return (!strcasecmp(tocstr(str1), tocstr(str2)));
	}
}