mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-06-21 01:01:43 +00:00
67 lines
2.0 KiB
C++
67 lines
2.0 KiB
C++
/*----------------------------------------------------------------------------*/
|
|
/* Copyright (c) 2017-2018 FIRST. All Rights Reserved. */
|
|
/* Open Source Software - may be modified and shared by FRC teams. The code */
|
|
/* must be accompanied by the FIRST BSD license file in the root directory of */
|
|
/* the project. */
|
|
/*----------------------------------------------------------------------------*/
|
|
|
|
#pragma once
|
|
|
|
#include <llvm/Twine.h>
|
|
|
|
#include "Commands/Command.h"
|
|
|
|
namespace frc {
|
|
|
|
/**
|
|
* A ConditionalCommand is a Command that starts one of two commands.
|
|
*
|
|
* A ConditionalCommand uses the Condition method to determine whether it should
|
|
* run onTrue or onFalse.
|
|
*
|
|
* A ConditionalCommand adds the proper Command to the Scheduler during
|
|
* Initialize() and then IsFinished() will return true once that Command has
|
|
* finished executing.
|
|
*
|
|
* If no Command is specified for onFalse, the occurrence of that condition
|
|
* will be a no-op.
|
|
*
|
|
* A CondtionalCommand will require the superset of subsystems of the onTrue
|
|
* and onFalse commands.
|
|
*
|
|
* @see Command
|
|
* @see Scheduler
|
|
*/
|
|
class ConditionalCommand : public Command {
|
|
public:
|
|
explicit ConditionalCommand(Command* onTrue, Command* onFalse = nullptr);
|
|
ConditionalCommand(const llvm::Twine& name, Command* onTrue,
|
|
Command* onFalse = nullptr);
|
|
virtual ~ConditionalCommand() = default;
|
|
|
|
protected:
|
|
/**
|
|
* The Condition to test to determine which Command to run.
|
|
*
|
|
* @return true if m_onTrue should be run or false if m_onFalse should be run.
|
|
*/
|
|
virtual bool Condition() = 0;
|
|
|
|
void _Initialize() override;
|
|
void _Cancel() override;
|
|
bool IsFinished() override;
|
|
void _Interrupted() override;
|
|
|
|
private:
|
|
// The Command to execute if Condition() returns true
|
|
Command* m_onTrue;
|
|
|
|
// The Command to execute if Condition() returns false
|
|
Command* m_onFalse;
|
|
|
|
// Stores command chosen by condition
|
|
Command* m_chosenCommand = nullptr;
|
|
};
|
|
|
|
} // namespace frc
|