mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2024-11-08 16:57:16 +01:00
77 lines
2.4 KiB
C
77 lines
2.4 KiB
C
|
/************************************************************************************
|
||
|
|
*
|
||
|
|
* D++, A Lightweight C++ library for Discord
|
||
|
|
*
|
||
|
|
* Copyright 2021 Craig Edwards and D++ contributors
|
||
|
|
* (https://github.com/brainboxdotcc/DPP/graphs/contributors)
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*
|
||
|
|
************************************************************************************/
|
||
|
|
#pragma once
|
||
|
|
#include <dpp/export.h>
|
||
|
|
#include <dpp/snowflake.h>
|
||
|
|
#include <string>
|
||
|
|
|
||
|
|
namespace dpp {
|
||
|
|
|
||
|
|
/** @brief The managed class is the base class for various types that can
|
||
|
|
* be stored in a cache that are identified by a dpp::snowflake id.
|
||
|
|
*/
|
||
|
|
class DPP_EXPORT managed {
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* @brief Unique ID of object set by Discord.
|
||
|
|
* This value contains a timestamp, worker ID, internal server ID, and an incrementing value.
|
||
|
|
* Only the timestamp is relevant to us as useful metadata.
|
||
|
|
*/
|
||
|
|
snowflake id;
|
||
|
|
/**
|
||
|
|
* @brief Constructor, initialises ID
|
||
|
|
* @param nid ID to set
|
||
|
|
*/
|
||
|
|
managed(const snowflake nid = 0);
|
||
|
|
/**
|
||
|
|
* @brief Destroy the managed object
|
||
|
|
*/
|
||
|
|
virtual ~managed() = default;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Get the creation time of this object according to Discord.
|
||
|
|
*
|
||
|
|
* @return double creation time inferred from the snowflake ID.
|
||
|
|
* The minimum possible value is the first second of 2015.
|
||
|
|
*/
|
||
|
|
double get_creation_time() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Comparison operator for comparing two managed objects by id
|
||
|
|
*
|
||
|
|
* @param other Other object to compare against
|
||
|
|
* @return true objects are the same id
|
||
|
|
* @return false objects are not the same id
|
||
|
|
*/
|
||
|
|
bool operator==(const managed& other) const noexcept;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Comparison operator for comparing two managed objects by id
|
||
|
|
*
|
||
|
|
* @param other Other object to compare against
|
||
|
|
* @return true objects are not the same id
|
||
|
|
* @return false objects are the same id
|
||
|
|
*/
|
||
|
|
bool operator!=(const managed& other) const noexcept;
|
||
|
|
};
|
||
|
|
|
||
|
|
};
|