Output.h

[詳解]

/// @file
/// @brief ID付けされた出力処理を行うMonostateクラス Output のヘッダ。
///
/// Copyright(C)SEGA

#ifndef AMDAEMON_OUTPUT_H
#define AMDAEMON_OUTPUT_H

#include "amdaemon/env.h"
#include "amdaemon/OutputUnit.h"
#include "amdaemon/OutputId.h"
#include "amdaemon/util/container.h"

#include <functional>
#include <vector>
#include <cstddef>

namespace amdaemon
{
/// @addtogroup g_io
/// @{

    /// @brief ID付けされた出力処理を行うMonostateクラス。
    ///
    /// Core クラスのメンバ関数 Core#execute 呼び出しによって内容が更新される。
    ///
    /// このクラスを利用するためには
    /// Daemonプロセスの設定ファイルに出力識別ID等の定義を行う必要がある。
    ///
    /// @ingroup g_common
    class Output
    {
    public:
        // 下記は暗黙の定義を用いる。
        //Output() = default;
        //‾Output() = default;
        //Output(const Output&) = default;
        //Output& operator=(const Output&) = default;

        /// @brief システムの出力処理インスタンスを取得する。
        /// @return システムの出力処理インスタンス。
        ///
        /// プレイヤーに紐付かない出力がカテゴライズされる。
        OutputUnit& getSystem();

        /// @brief システムの出力処理インスタンスを取得する。
        /// @return システムの出力処理インスタンス。
        ///
        /// プレイヤーに紐付かない出力がカテゴライズされる。
        const OutputUnit& getSystem() const;

        /// @brief 有効プレイヤー数を取得する。
        /// @return 有効プレイヤー数。
        /// @see Core#getPlayerCount
        ///
        /// Core#getPlayerCount と同じ値を返す。
        std::size_t getPlayerCount() const;

        /// @brief プレイヤーの出力処理インスタンスを取得する。
        /// @param[in] playerIndex プレイヤーインデックス。
        /// @return プレイヤーの出力処理インスタンス。
        /// @see Player
        ///
        /// @exception Exception
        /// 引数 playerIndex に有効プレイヤー数以上の値を指定した場合。
        /// 有効プレイヤー数はメンバ関数 #getPlayerCount で取得できる。
        OutputUnit& getPlayer(std::size_t playerIndex);

        /// @copydoc getPlayer
        const OutputUnit& getPlayer(std::size_t playerIndex) const;

        /// @brief プレイヤーの出力処理インスタンス配列を取得する。
        /// @return プレイヤーの出力処理インスタンス配列。
        ///
        /// 範囲for文や各種アルゴリズム関数に渡すことを想定している。
        ///
        /// - 有効プレイヤー数を知りたいだけならばメンバ関数 #getPlayerCount を用いること。
        /// - 特定プレイヤーの処理を行いたいだけならばメンバ関数 #getPlayer を用いること。
        std::vector<std::reference_wrapper<OutputUnit>> getPlayers()
        {
            return
                ::amdaemon::util::toContainer<decltype(getPlayers())>(
                    getPlayerCount(),
                    [this](std::size_t i) -> OutputUnit& { return getPlayer(i); });
        }

        /// @copydoc getPlayers
        std::vector<std::reference_wrapper<const OutputUnit>> getPlayers() const
        {
            return
                ::amdaemon::util::toContainer<decltype(getPlayers())>(
                    getPlayerCount(),
                    [this](std::size_t i) -> const OutputUnit& { return getPlayer(i); });
        }
    };

/// @}
} // namespace amdaemon

#endif // AMDAEMON_OUTPUT_H