Redstone1024/Redcraft
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

refactor(iterator): add iterator example class and split iterator library into multiple files

Browse Source
This commit is contained in:
Redstone1024
2024-12-13 19:08:05 +08:00
parent ea625bb916
commit 24dd4347d1
8 changed files with 801 additions and 116 deletions
Download Patch File Download Diff File Expand all files Collapse all files

111
Redcraft.Utility/Source/Public/Iterator/Sentinel.h Normal file
View File

@ -0,0 +1,111 @@
#pragma once
#include "CoreTypes.h"
#include "Iterator/Utility.h"
#include "TypeTraits/TypeTraits.h"
NAMESPACE_REDCRAFT_BEGIN
NAMESPACE_MODULE_BEGIN(Redcraft)
NAMESPACE_MODULE_BEGIN(Utility)
#if PLATFORM_COMPILER_GCC
# pragma GCC diagnostic push
# pragma GCC diagnostic ignored "-Wnon-template-friend"
#endif
/**
* A concept specifies a type is a sentinel for an iterator and expression 'Iter == Sentinel' is valid.
* In addition, the type must be default constructible and copyable.
*/
template <typename S, typename I>
concept CSentinelFor = CSemiregular<S> && CInputOrOutputIterator<I> && CWeaklyEqualityComparable<S, I>;
/** This is an example of a sentinel for an iterator, indicate the traits that define a sentinel for an iterator. */
template <CInputOrOutputIterator I>
struct ISentinelFor
{
/** Default constructor. */
ISentinelFor();
/** Copy constructor. */
ISentinelFor(const ISentinelFor&);
/** Copy assignment operator. */
ISentinelFor* operator=(const ISentinelFor&);
/** Equality operator. */
bool operator==(const I&) const&;
};
// Use 'ISentinelFor' represents a sentinel for an iterator.
static_assert(CSentinelFor<ISentinelFor<IInputOrOutputIterator<int>>, IInputOrOutputIterator<int>>);
// The 'CSentinelFor' requires this code is valid.
static_assert(
requires(ISentinelFor<IInputOrOutputIterator<int>> Sentinel, IInputOrOutputIterator<int> Iter)
{
{ Iter == Sentinel } -> CBooleanTestable;
{ Sentinel == Iter } -> CBooleanTestable;
}
);
/** Disable the 'CSizedSentinelFor' concept for specific types. */
template <typename S, typename I>
inline constexpr bool bDisableSizedSentinelFor = false;
/**
* A concept specifies a type is a sized sentinel for an iterator and expressions 'Sentinel - Iter' and 'Iter - Sentinel' are valid,
* and the 'Sentinel - Iter' is equal to negative 'Iter - Sentinel'.
* In addition, the type must be default constructible and copyable.
*/
template <typename S, typename I>
concept CSizedSentinelFor = CSentinelFor<S, I>
&& !bDisableSizedSentinelFor<TRemoveCVRef<S>, TRemoveCVRef<I>>
&& requires(const I& Iter, const S& Sentinel)
{
{ Sentinel - Iter } -> CSameAs<ptrdiff>;
{ Iter - Sentinel } -> CSameAs<ptrdiff>;
};
/** This is an example of a sized sentinel for an iterator, indicate the traits that define a sized sentinel for an iterator. */
template <CInputOrOutputIterator I>
struct ISizedSentinelFor /* : ISentinelFor<I> */
{
/** Default constructor. */
ISizedSentinelFor();
/** Copy constructor. */
ISizedSentinelFor(const ISizedSentinelFor&);
/** Copy assignment operator. */
ISizedSentinelFor& operator=(const ISizedSentinelFor&);
/** Equality operator. */
bool operator==(const I&) const&;
/** Subtraction operator. The 'Sentinel - Iter' is equal to negative 'Iter - Sentinel'. */
friend ptrdiff operator-(const I&, const ISizedSentinelFor&);
friend ptrdiff operator-(const ISizedSentinelFor&, const I&);
};
// Use 'ISizedSentinelFor' represents a sized sentinel for an iterator.
static_assert(CSizedSentinelFor<ISizedSentinelFor<IInputOrOutputIterator<int>>, IInputOrOutputIterator<int>>);
// The 'CSentinelFor' requires this code is valid.
static_assert(
requires(ISizedSentinelFor<IInputOrOutputIterator<int>> Sentinel, IInputOrOutputIterator<int> Iter)
{
{ Iter == Sentinel } -> CBooleanTestable;
{ Sentinel == Iter } -> CBooleanTestable;
{ Iter - Sentinel } -> CSameAs<ptrdiff>;
{ Sentinel - Iter } -> CSameAs<ptrdiff>;
}
);
#if PLATFORM_COMPILER_GCC
# pragma GCC diagnostic pop
#endif
NAMESPACE_MODULE_END(Utility)
NAMESPACE_MODULE_END(Redcraft)
NAMESPACE_REDCRAFT_END