File: StringStl.h

package info (click to toggle)
jazz2-native 3.5.0-2
  • links: PTS, VCS
  • area: contrib
  • in suites: forky, sid
  • size: 16,912 kB
  • sloc: cpp: 172,557; xml: 113; python: 36; makefile: 5; sh: 2
file content (74 lines) | stat: -rw-r--r-- 3,070 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
// Copyright © 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016,
//             2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024
//           Vladimír Vondruš <mosra@centrum.cz> and contributors
// Copyright © 2020-2024 Dan R.
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.

#pragma once

/** @file
	@brief STL @ref std::string compatibility for @ref Death::Containers::String and @ref Death::Containers::StringView

	Including this header allows you to convert a
	@ref Death::Containers::String / @ref Death::Containers::StringView from
	and to a @ref std::string.
*/

#include <string>

#include "String.h"
#include "StringView.h"

namespace Death { namespace Containers { namespace Implementation {
//###==##====#=====--==~--~=~- --- -- -  -  -   -

	/** @brief Provides automatic conversion from/to STL @ref std::string */
	template<> struct StringConverter<std::string> {
		static String from(const std::string& other) {
			return String{other.data(), other.size()};
		}
		static std::string to(const String& other) {
			return std::string{other.data(), other.size()};
		}
	};

	/** @brief Provides automatic conversion from/to STL @ref std::string */
	template<> struct StringViewConverter<const char, std::string> {
		static StringView from(const std::string& other) {
			return StringView{other.data(), other.size(), StringViewFlags::NullTerminated};
		}
		static std::string to(StringView other) {
			return std::string{other.data(), other.size()};
		}
	};

	/** @brief Provides automatic conversion from/to STL @ref std::string */
	template<> struct StringViewConverter<char, std::string> {
		static MutableStringView from(std::string& other) {
			// .data() returns a const pointer until C++17, so have to use &other[0]. It's guaranteed
			// to return a pointer to a single null character if the string is empty.
			return MutableStringView{&other[0], other.size(), StringViewFlags::NullTerminated};
		}
		static std::string to(MutableStringView other) {
			return std::string{other.data(), other.size()};
		}
	};

}}}