aboutsummaryrefslogtreecommitdiff
path: root/include/utility/pointer.h
blob: a03e69ef4af07bf00e6e30181661bb43297efab9 (about) (plain) (blame)
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
/*
 * InspIRCd -- Internet Relay Chat Daemon
 *
 *   Copyright (C) 2026 Sadie Powell <sadie@witchery.services>
 *
 * 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

namespace insp
{
	/** A pointer to a FILE that closes when it goes out of scope. */
	using file_ptr = std::unique_ptr<FILE, int(*)(FILE*)>;

	/** Assigns a pointer type to a target if it is not null; otherwise, does nothing.
	 * This is mainly intended for use with const char* to std::string assignment.
	 */
	template<typename Target, typename Source>
	void assign_ptr(Target& target, const Source* source)
	{
		if (source)
			target = source;
	}

	/** Deletes all elements in a container using operator delete
	 * @param cont The container containing the elements to delete
	 */
	template <typename Cont, typename Del = std::default_delete<std::remove_pointer_t<typename Cont::value_type>>>
	void delete_all(const Cont& cont)
	{
		std::for_each(cont.begin(), cont.end(), Del());
	}

	/** Deletes a object and zeroes the memory location that pointed to it.
	 * @param pr A reference to the pointer that contains the object to delete.
	 */
	template<typename T, typename Del = std::default_delete<T>>
	void delete_zero(T*& pr)
	{
		auto* p = pr;
		pr = nullptr;
		Del()(p);
	}

	/** Determines if the pointer in \p ptr1 is empty.
	 * @param ptr Either a shared_ptr<> or a weak_ptr<>.
	 */
	template <typename Ptr>
	bool empty_ptr(const Ptr& ptr)
	{
		return same_ptr(ptr, {});
	}

	/** Determines if the pointer in \p ptr1 points to the same value as the pointer in \p ptr2.
	 * @param ptr1 Either a shared_ptr<> or a weak_ptr<>.
	 * @param ptr2 Either a shared_ptr<> or a weak_ptr<>.
	 */
	template <typename Ptr1, typename Ptr2 = Ptr1>
	bool same_ptr(const Ptr1& ptr1, const Ptr2& ptr2)
	{
		return !ptr1.owner_before(ptr2) && !ptr2.owner_before(ptr1);
	}

	/** Returns the raw pointer of the shared pointer passed to it.
	 * @param value The shared pointer to return the raw pointer of.
	 */
	template <typename Value>
	inline Value* to_ptr(std::shared_ptr<Value>& value)
	{
		return value.get();
	}

	/** Returns the raw pointer of the reference passed to it.
	 * @param value The reference to return the raw pointer of.
	 */
	template <typename Value>
	inline Value* to_ptr(Value& value)
	{
		return &value;
	}

	/** Returns the value passed to it.
	 * @param value The value to return.
	 */
	template <typename Value>
	inline Value* to_ptr(Value* value)
	{
		return value;
	}
}