2020-12-26 14:12:05 -08:00
|
|
|
// Copyright (c) FIRST and other WPILib contributors.
|
|
|
|
|
// Open Source Software; you can modify and/or share it under the terms of
|
|
|
|
|
// the WPILib BSD license file in the root directory of this project.
|
2019-08-25 23:55:59 -04:00
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
2019-10-18 10:57:43 -04:00
|
|
|
#ifdef _WIN32
|
|
|
|
|
#pragma warning(push)
|
|
|
|
|
#pragma warning(disable : 4521)
|
|
|
|
|
#endif
|
|
|
|
|
|
2019-08-25 23:55:59 -04:00
|
|
|
#include <memory>
|
|
|
|
|
#include <utility>
|
|
|
|
|
#include <vector>
|
|
|
|
|
|
2019-11-05 20:52:49 -08:00
|
|
|
#include "frc2/command/CommandGroupBase.h"
|
|
|
|
|
#include "frc2/command/CommandHelper.h"
|
2019-08-25 23:55:59 -04:00
|
|
|
|
|
|
|
|
namespace frc2 {
|
|
|
|
|
/**
|
|
|
|
|
* A CommandGroup that runs a set of commands in parallel, ending only when a
|
|
|
|
|
* specific command (the "deadline") ends, interrupting all other commands that
|
|
|
|
|
* are still running at that point.
|
|
|
|
|
*
|
|
|
|
|
* <p>As a rule, CommandGroups require the union of the requirements of their
|
|
|
|
|
* component commands.
|
2022-01-08 11:11:34 -08:00
|
|
|
*
|
|
|
|
|
* This class is provided by the NewCommands VendorDep
|
2019-08-25 23:55:59 -04:00
|
|
|
*/
|
|
|
|
|
class ParallelDeadlineGroup
|
|
|
|
|
: public CommandHelper<CommandGroupBase, ParallelDeadlineGroup> {
|
|
|
|
|
public:
|
|
|
|
|
/**
|
|
|
|
|
* Creates a new ParallelDeadlineGroup. The given commands (including the
|
|
|
|
|
* deadline) will be executed simultaneously. The CommandGroup will finish
|
|
|
|
|
* when the deadline finishes, interrupting all other still-running commands.
|
|
|
|
|
* If the CommandGroup is interrupted, only the commands still running will be
|
|
|
|
|
* interrupted.
|
|
|
|
|
*
|
|
|
|
|
* @param deadline the command that determines when the group ends
|
|
|
|
|
* @param commands the commands to be executed
|
|
|
|
|
*/
|
|
|
|
|
ParallelDeadlineGroup(std::unique_ptr<Command>&& deadline,
|
|
|
|
|
std::vector<std::unique_ptr<Command>>&& commands);
|
|
|
|
|
/**
|
|
|
|
|
* Creates a new ParallelDeadlineGroup. The given commands (including the
|
|
|
|
|
* deadline) will be executed simultaneously. The CommandGroup will finish
|
|
|
|
|
* when the deadline finishes, interrupting all other still-running commands.
|
|
|
|
|
* If the CommandGroup is interrupted, only the commands still running will be
|
|
|
|
|
* interrupted.
|
|
|
|
|
*
|
|
|
|
|
* @param deadline the command that determines when the group ends
|
|
|
|
|
* @param commands the commands to be executed
|
|
|
|
|
*/
|
|
|
|
|
template <class T, class... Types,
|
|
|
|
|
typename = std::enable_if_t<
|
2019-09-13 20:14:37 -07:00
|
|
|
std::is_base_of_v<Command, std::remove_reference_t<T>>>,
|
2019-08-25 23:55:59 -04:00
|
|
|
typename = std::enable_if_t<std::conjunction_v<
|
|
|
|
|
std::is_base_of<Command, std::remove_reference_t<Types>>...>>>
|
|
|
|
|
explicit ParallelDeadlineGroup(T&& deadline, Types&&... commands) {
|
|
|
|
|
SetDeadline(std::make_unique<std::remove_reference_t<T>>(
|
|
|
|
|
std::forward<T>(deadline)));
|
|
|
|
|
AddCommands(std::forward<Types>(commands)...);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
ParallelDeadlineGroup(ParallelDeadlineGroup&& other) = default;
|
|
|
|
|
|
|
|
|
|
// No copy constructors for command groups
|
|
|
|
|
ParallelDeadlineGroup(const ParallelDeadlineGroup&) = delete;
|
|
|
|
|
|
2019-10-18 10:57:43 -04:00
|
|
|
// Prevent template expansion from emulating copy ctor
|
|
|
|
|
ParallelDeadlineGroup(ParallelDeadlineGroup&) = delete;
|
|
|
|
|
|
2019-08-25 23:55:59 -04:00
|
|
|
template <class... Types,
|
|
|
|
|
typename = std::enable_if_t<std::conjunction_v<
|
|
|
|
|
std::is_base_of<Command, std::remove_reference_t<Types>>...>>>
|
|
|
|
|
void AddCommands(Types&&... commands) {
|
|
|
|
|
std::vector<std::unique_ptr<Command>> foo;
|
|
|
|
|
((void)foo.emplace_back(std::make_unique<std::remove_reference_t<Types>>(
|
|
|
|
|
std::forward<Types>(commands))),
|
|
|
|
|
...);
|
|
|
|
|
AddCommands(std::move(foo));
|
|
|
|
|
}
|
|
|
|
|
|
2022-08-31 19:15:28 +03:00
|
|
|
void Initialize() final;
|
2019-08-25 23:55:59 -04:00
|
|
|
|
2022-08-31 19:15:28 +03:00
|
|
|
void Execute() final;
|
2019-08-25 23:55:59 -04:00
|
|
|
|
2022-08-31 19:15:28 +03:00
|
|
|
void End(bool interrupted) final;
|
2019-08-25 23:55:59 -04:00
|
|
|
|
2022-08-31 19:15:28 +03:00
|
|
|
bool IsFinished() final;
|
2019-08-25 23:55:59 -04:00
|
|
|
|
|
|
|
|
bool RunsWhenDisabled() const override;
|
|
|
|
|
|
|
|
|
|
private:
|
2020-12-26 22:06:28 -08:00
|
|
|
void AddCommands(std::vector<std::unique_ptr<Command>>&& commands) final;
|
2019-08-25 23:55:59 -04:00
|
|
|
|
|
|
|
|
void SetDeadline(std::unique_ptr<Command>&& deadline);
|
|
|
|
|
|
2019-11-05 20:52:49 -08:00
|
|
|
std::vector<std::pair<std::unique_ptr<Command>, bool>> m_commands;
|
2019-08-25 23:55:59 -04:00
|
|
|
Command* m_deadline;
|
|
|
|
|
bool m_runWhenDisabled{true};
|
2019-11-18 18:33:45 -05:00
|
|
|
bool m_finished{true};
|
2019-08-25 23:55:59 -04:00
|
|
|
};
|
|
|
|
|
} // namespace frc2
|
2019-10-18 10:57:43 -04:00
|
|
|
|
|
|
|
|
#ifdef _WIN32
|
|
|
|
|
#pragma warning(pop)
|
|
|
|
|
#endif
|