2021-04-10 12:54:24 +02:00
|
|
|
|
using System;
|
|
|
|
|
|
|
|
|
|
namespace ARMeilleure.Common
|
2021-04-09 18:52:28 +02:00
|
|
|
|
{
|
|
|
|
|
/// <summary>
|
2021-04-10 12:54:24 +02:00
|
|
|
|
/// Represents a numeric counter.
|
2021-04-09 18:52:28 +02:00
|
|
|
|
/// </summary>
|
2021-04-10 12:54:24 +02:00
|
|
|
|
/// <typeparam name="T">Type of the counter</typeparam>
|
2021-04-11 11:54:33 +02:00
|
|
|
|
class Counter<T> : IDisposable where T : unmanaged
|
2021-04-09 18:52:28 +02:00
|
|
|
|
{
|
2021-04-11 11:54:33 +02:00
|
|
|
|
private bool _disposed;
|
2021-04-09 18:52:28 +02:00
|
|
|
|
private readonly int _index;
|
2021-04-10 12:54:24 +02:00
|
|
|
|
private readonly EntryTable<T> _countTable;
|
2021-04-09 18:52:28 +02:00
|
|
|
|
|
|
|
|
|
/// <summary>
|
2021-04-10 12:54:24 +02:00
|
|
|
|
/// Initializes a new instance of the <see cref="Counter{T}"/> class from the specified
|
|
|
|
|
/// <see cref="EntryTable{T}"/> instance and index.
|
2021-04-09 18:52:28 +02:00
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="countTable"><see cref="EntryTable{byte}"/> instance</param>
|
2021-04-10 12:54:24 +02:00
|
|
|
|
/// <param name="index">Index in the <see cref="EntryTable{T}"/></param>
|
|
|
|
|
private Counter(EntryTable<T> countTable, int index)
|
2021-04-09 18:52:28 +02:00
|
|
|
|
{
|
|
|
|
|
_countTable = countTable;
|
|
|
|
|
_index = index;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets a reference to the value of the counter.
|
|
|
|
|
/// </summary>
|
2021-04-11 11:54:33 +02:00
|
|
|
|
public ref T Value
|
|
|
|
|
{
|
|
|
|
|
get
|
|
|
|
|
{
|
|
|
|
|
if (_disposed)
|
|
|
|
|
{
|
|
|
|
|
throw new ObjectDisposedException(null);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return ref _countTable.GetValue(_index);
|
|
|
|
|
}
|
|
|
|
|
}
|
2021-04-09 18:52:28 +02:00
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Tries to create a <see cref="Counter"/> instance from the specified <see cref="EntryTable{byte}"/> instance.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="countTable"><see cref="EntryTable{TEntry}"/> from which to create the <see cref="Counter"/></param>
|
|
|
|
|
/// <param name="counter"><see cref="Counter"/> instance if success; otherwise <see langword="null"/></param>
|
|
|
|
|
/// <returns><see langword="true"/> if success; otherwise <see langword="false"/></returns>
|
2021-04-10 12:54:24 +02:00
|
|
|
|
/// <exception cref="ArgumentNullException"><paramref name="countTable"/> is <see langword="null"/></exception>
|
|
|
|
|
/// <exception cref="ArgumentException"><typeparamref name="T"/> is unsupported</exception>
|
|
|
|
|
public static bool TryCreate(EntryTable<T> countTable, out Counter<T> counter)
|
2021-04-09 18:52:28 +02:00
|
|
|
|
{
|
2021-04-10 12:54:24 +02:00
|
|
|
|
if (countTable == null)
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentNullException(nameof(countTable));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (typeof(T) != typeof(byte) && typeof(T) != typeof(sbyte) &&
|
|
|
|
|
typeof(T) != typeof(short) && typeof(T) != typeof(ushort) &&
|
|
|
|
|
typeof(T) != typeof(int) && typeof(T) != typeof(uint) &&
|
|
|
|
|
typeof(T) != typeof(long) && typeof(T) != typeof(ulong) &&
|
|
|
|
|
typeof(T) != typeof(nint) && typeof(T) != typeof(nuint) &&
|
|
|
|
|
typeof(T) != typeof(float) && typeof(T) != typeof(double))
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentException("Counter does not support the specified type", nameof(countTable));
|
|
|
|
|
}
|
|
|
|
|
|
2021-04-09 18:52:28 +02:00
|
|
|
|
if (countTable.TryAllocate(out int index))
|
|
|
|
|
{
|
2021-04-10 12:54:24 +02:00
|
|
|
|
counter = new Counter<T>(countTable, index);
|
2021-04-09 18:52:28 +02:00
|
|
|
|
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
counter = null;
|
|
|
|
|
|
|
|
|
|
return false;
|
|
|
|
|
}
|
2021-04-11 11:54:33 +02:00
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Releases all resources used by the <see cref="Counter{T}"/> instance.
|
|
|
|
|
/// </summary>
|
|
|
|
|
public void Dispose()
|
|
|
|
|
{
|
|
|
|
|
if (!_disposed)
|
|
|
|
|
{
|
|
|
|
|
_countTable.Free(_index);
|
|
|
|
|
|
|
|
|
|
_disposed = true;
|
|
|
|
|
}
|
|
|
|
|
}
|
2021-04-09 18:52:28 +02:00
|
|
|
|
}
|
|
|
|
|
}
|