This repository has been archived on 2020-05-10. You can view files and clone it, but cannot push or open issues or pull requests.
mastodon-cpp/src/easy/entities/card.hpp

150 lines
3.6 KiB
C++

/* This file is part of mastodon-cpp.
* Copyright © 2018 tastytea <tastytea@tastytea.de>
*
* This program 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 3.
*
* 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/>.
*/
#ifndef MASTODON_CPP_EASY_CARD_HPP
#define MASTODON_CPP_EASY_CARD_HPP
#include <string>
#include <cstdint>
// If we are compiling mastodon-cpp, use another include path
#ifdef MASTODON_CPP
#include "mastodon-cpp.hpp"
#include "easy/easy.hpp"
#else
#include <mastodon-cpp/mastodon-cpp.hpp>
#include <mastodon-cpp/easy/easy.hpp>
#endif
using std::string;
using std::uint_fast64_t;
namespace Mastodon
{
/*!
* @brief Class to hold cards
*
* @since before 0.11.0
*/
class Easy::Card : public Easy::Entity
{
public:
/*!
* @brief Constructs a Card object from a JSON string.
*
* @param json JSON string
*
* @since before 0.11.0
*/
explicit Card(const string &json);
/*!
* @brief Constructs an empty Card object.
*
* @since before 0.11.0
*/
Card();
virtual bool valid() const;
/*!
* @brief Returns the name of the author
*
* @since before 0.11.0
*/
const string author_name() const;
/*!
* @brief Returns the URL of the author
*
* @since before 0.11.0
*/
const string author_url() const;
/*!
* @brief Returns the description
*
* @since before 0.11.0
*/
const string description() const;
/*!
* @brief Returns the height of the card
*
* @since before 0.11.0
*/
uint_fast64_t height() const;
/*!
* @brief Returns the HTML
*
* @since before 0.11.0
*/
const string html() const;
/*!
* @brief Returns the URL of the image associated with the card
*
* @since before 0.11.0
*/
const string image() const;
/*!
* @brief Returns the name of the provider
*
* @since before 0.11.0
*/
const string provider_name() const;
/*!
* @brief Returns the URL of the provider
*
* @since before 0.11.0
*/
const string provider_url() const;
/*!
* @brief Returns the title
*
* @since before 0.11.0
*/
const string title() const;
/*!
* @brief Returns the type of the card
*
* @since before 0.11.0
*/
Easy::card_type type() const;
/*!
* @brief Returns the URL associated with the card
*
* @since before 0.11.0
*/
const string url() const;
/*!
* @brief Returns the width of the card
*
* @since before 0.11.0
*/
uint_fast64_t width() const;
};
}
#endif // MASTODON_CPP_EASY_CARD_HPP