rnr_eg_cli

Classes
struct	AnimalInfo
struct	AppCmdExec
	Command description and exectuion structure. More...
struct	AppCmdExec3
	Self-Reference command description and exectuion structure. More...

Macros
#define	APP_EC_OK   0
	success exit code
#define	APP_EC_ARGS   2
	command-line options/arguments error exit code
#define	APP_EC_EXEC   4
	execution exit code

Enumerations
enum	Activity {   ActIdle,   ActSleeping,   ActEating,   ActWalking }
	Animal activities. More...

Functions
static ostream &	operator<< (ostream &os, const char *art[])
	ASCII art output stream operator. More...
static void	showAsciiArt (ostream &os, const char *art0[], const char *art1[], const char *art2[]=NULL, const char *art3[]=NULL)
	Write a set of ASCII art to cout. More...
static AnimalInfo *	findAnimal (const string &strCommonName)
	Find the animal with the common name. More...
const string	CliName ("Adopt-An-Animal")
	CLI name.
const string	CliPrompt ("aaa> ")
	CLI prompt.

Variables
static char *	Argv0
	the command
static OptsPgmInfo_T	PgmInfo
	Program information. More...
static OptsInfo_T	OptsInfo []
	Command line options information. More...
static const char *	AsciiAardvark []
	ASCII ardvaark. More...
static const char *	AsciiMandrill []
	ASCII Mandrill. More...
static const char *	AsciiNumbat []
	ASCII numbat. More...
static const char *	AsciiZebraSmall []
	ASCII small zebra. More...
static const char *	AsciiZebra []
	ASCII zebra. More...
static const char *	AsciiAnt []
	ASCII ant. More...
static const char *	AsciiGrub []
	ASCII grub. More...
static const char *	AsciiCarrot []
	ASCII carrot. More...
static const char *	AsciiVitamins []
	ASCII bottle of vitamins. More...
static const char *	AsciiWalking [][2]
	ASCII walk sequence. More...
const char *	AnimalInfo::m_sCommonName
	command name
const char *	AnimalInfo::m_sScientificName
	scientific name
const char **	AnimalInfo::m_sSelfie
	ASCII selfie.
string	AnimalInfo::m_strGivenName
	adopted given name by owner
bool	AnimalInfo::m_bIsAdopted
	is [not] adopted
Activity	AnimalInfo::m_eActivity
	current activity
double	AnimalInfo::m_fActStart
	activity start time
double	AnimalInfo::m_fActDuration
	activitiy uninterrupted duration
const char *	NoName = "No given name"
	'no name' name
AnimalInfo	Animals []
	The animals. More...
size_t	NumOfAnimals = arraysize(Animals)
	number of animals
Time	ActivityTime
	activity time
CommandLine	Cli (CliName, CliPrompt)
	the CLI
CmdDesc	AppCmdExec::m_desc
	command description and syntax specification
CmdExec2Func	AppCmdExec::m_fnExec
	command execution function
CmdDesc	AppCmdExec3::m_desc
	command description and syntax specification
CmdExec3Func	AppCmdExec3::m_fnExec
	command execution function
AppCmdExec	Commands []
	The command descriptions.
const size_t	NumOfCmds = arraysize(Commands)
	Number of commands.
static const char *	CliTestCmdName = "clitest"
AppCmdExec3	Command3s []
	The command descriptions. More...
const size_t	NumOfCmd3s = arraysize(Command3s)
	Number of commands.
int	checkCmd (const CmdExtArg &argv0, int argc, const string strTgtName="")
	Check if command input is matched correctly with the command execution. More...
static int	execAdopt (const CmdExtArgVec &argv)
	Execute 'adopt' command. More...
static int	execSleep (const CmdExtArgVec &argv)
	Execute 'sleep' command. More...
static int	execNameAnimal (const CmdExtArgVec &argv)
	Execute 'name' command. More...
static int	execNamaste (const CmdExtArgVec &argv)
	Execute 'namaste' command. More...
static int	execFeedAnimal (const CmdExtArgVec &argv)
	Execute 'feed' command. More...
static int	execWalkAnimal (const CmdExtArgVec &argv)
	Execute 'walk' command. More...
static int	execListAnimals (const CmdExtArgVec &argv)
	Execute 'list' command. More...
static int	execGetPetsState (const CmdExtArgVec &argv)
	Execute 'get' command. More...
static int	execReward (const CmdExtArgVec &argv)
	Execute 'reward' command. More...
static int	execSave (const CmdExtArgVec &argv)
	Execute 'save' command. More...
static int	findCommand (const std::string &strName)
	Find command by name. More...
static int	execTAdd (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tadd subcommand. More...
static int	execTBt (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tbt subcommand. More...
static int	execTCompile (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tcompile subcommand. More...
static int	execTDump (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tdump subcommand. More...
static int	execTKbhit (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tkbhit subcommand. More...
static int	execTPrint (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tprint subcommand. More...
static int	execTPush (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tpush subcommand. More...
static int	execTRemove (CommandLine &cli, const CmdExtArgVec &argv)
	Execute clitest tremove subcommand. More...
static int	execCliTest (CommandLine &cli, const CmdExtArgVec &argv)
	Execute command-line interface methods command. More...
static void	mainInit (int argc, char *argv[])
	Main initialization. More...
static void	updateAnimals ()
	Update all animals' state data.
static int	loadCommands (CommandLine &cli)
	Load commands into command line. More...
static int	run (CommandLine &cli)
	Command line interface main loop. More...
int	main (int argc, char *argv[])
	Main. More...
#define	PERROR(_err)   cout << CliName << ": " << "Error: " << _err << endl
	Error and warning printing macros.
#define	PWARN(_warn)   cout << CliName << ": " << _warn << endl
#define	PCMDERROR(_cmd, _err)   cout << CliName << ": " << _cmd << ": " << "Error: " << _err << endl
#define	PCMDWARN(_cmd, _warn)   cout << CliName << ": " << _cmd << ": " << _warn << endl

Detailed Description

Enumeration Type Documentation

enum Activity

Animal activities.

Enumerator
ActIdle	idle, doing nothing
ActSleeping	sleeping
ActEating	eating
ActWalking	walking

Definition at line 475 of file rnr_eg_cli.cxx.

{
  ActIdle,      ///< idle, doing nothing
  ActSleeping,  ///< sleeping
  ActEating,    ///< eating
  ActWalking    ///< walking
};

Function Documentation

int checkCmd	(	const CmdExtArg &	argv0,
		int	argc,
		const string	strTgtName = ""
	)

Check if command input is matched correctly with the command execution.

Note

This should never happen if the command definitions are well defined and unambiguous.

Parameters

argv0	Input argument 0. (Any extended argument actually works).
argc	Number of input arguments.
strTgtName	Expected target name of execution.

Returns

OK(0) on success, negative value on failure.

Definition at line 592 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::at(), Cli, rnr::cmd::CommandLine::numOfRequiredArgs(), PERROR, and rnr::cmd::CmdExtArg::uid().

Referenced by execAdopt(), execCliTest(), execFeedAnimal(), execGetPetsState(), execNameAnimal(), execReward(), execSave(), execSleep(), and execWalkAnimal().

{
  const string &strDefName = Cli.at(argv0.uid()).getName();

  if( !strTgtName.empty() && (strTgtName != strDefName) )
  {
    PERROR("Command execution is for '" << strTgtName << "' "
      << "not input command '" << strDefName << "'");
    return RC_ERROR;
  }
  else if( argc < Cli.numOfRequiredArgs(argv0) )
  {
    PERROR("Command '" << strDefName << "' has missing arguments.");
    return RC_ERROR;
  }
  else
  {
    return OK;
  }
}

static int execAdopt ( const CmdExtArgVec &  argv )

static

Execute 'adopt' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 625 of file rnr_eg_cli.cxx.

References checkCmd(), findAnimal(), and AnimalInfo::m_bIsAdopted.

{
  static const char *cmdname = "adopt";

  size_t  argc = argv.size();
  size_t  n;  

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //
  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  else if( p->m_bIsAdopted )
  {
    PCMDWARN(cmdname, "The " << animal << " is already adopted.");
    return RC_ERROR;
  }

  else
  {
    p->m_bIsAdopted = true;
    return OK;
  }
}

static int execCliTest ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute command-line interface methods command.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1760 of file rnr_eg_cli.cxx.

References checkCmd(), execTAdd(), execTBt(), execTCompile(), execTDump(), execTKbhit(), execTPrint(), execTPush(), execTRemove(), and rnr::cmd::CommandLine::popPrompt().

{
  size_t  nCmd = 0;  
  int     rc;

  if( checkCmd(argv[nCmd], argv.size()) != OK )
  {
    rc = RC_ERROR;
  }

  //
  // Add command to interface.
  //
  else if( argv[nCmd] == "tadd" )
  {
    rc = execTAdd(cli, argv);
  }

  //
  // Backtrace last execution sequence.
  //
  else if( argv[nCmd] == "tbt" )
  {
    rc = execTBt(cli, argv);
  }

  //
  // (Re)compile interface.
  //
  else if( argv[nCmd] == "tcompile" )
  {
    rc = execTCompile(cli, argv);
  }

  //
  // Dump interface component to output stream.
  //
  else if( argv[nCmd] == "tdump" )
  {
    rc = execTDump(cli, argv);
  }

  //
  // Check for keyboard hits.
  //
  else if( argv[nCmd] == "tkbhit" )
  {
    rc = execTKbhit(cli, argv);
  }

  //
  // Print interface attribute.
  //
  else if( argv[nCmd] == "tprint" )
  {
    rc = execTPrint(cli, argv);
  }

  //
  // Push new prompt.
  //
  else if( argv[nCmd] == "tpush" )
  {
    rc = execTPush(cli, argv);
  }

  //
  // Pop current prompt, restore previous.
  //
  else if( argv[nCmd] == "tpop" )
  {
    cli.popPrompt();
    rc = OK;
  }

  //
  // Remove command from interface.
  //
  else if( argv[nCmd] == "tremove" ) 
  {
    rc = execTRemove(cli, argv);
  }

  else
  {
    PCMDERROR(CliTestCmdName,
        "Do not know how to execute '" << argv[nCmd] << "'.");
    rc = RC_ERROR;
  }

  return rc;
}

static int execFeedAnimal ( const CmdExtArgVec &  argv )

static

Execute 'feed' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 801 of file rnr_eg_cli.cxx.

References ActEating, AsciiAnt, AsciiCarrot, AsciiGrub, AsciiVitamins, checkCmd(), findAnimal(), AnimalInfo::m_bIsAdopted, AnimalInfo::m_eActivity, AnimalInfo::m_fActDuration, AnimalInfo::m_fActStart, AnimalInfo::m_sCommonName, AnimalInfo::m_sSelfie, rnr::chronos::Time::now(), and showAsciiArt().

{
  static const char *cmdname = "feed";

  size_t  argc = argv.size();
  size_t  n;  

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  else if( !p->m_bIsAdopted )
  {
    PCMDWARN(cmdname, "The " << animal << " is not yours to feed.");
    return OK;
  }

  ++n;  // next argument

  const char **food = NULL;
  double      fSecs;

  if( argv[n] == "ants" )
  {
    food  = AsciiAnt;
    fSecs = 30.0;
  }
  else if( argv[n] == "carrots" )
  {
    food  = AsciiCarrot;
    fSecs = 10.0;
  }
  else if( argv[n] == "grubs" )
  {
    food  = AsciiGrub;
    fSecs = 20.0;
  }
  else if( argv[n] == "vitamins" )
  {
    food  = AsciiVitamins;
    fSecs = 5.0;
  }
  else
  {
    PCMDERROR(cmdname, "Unknown food '" << argv[n] << "'.");
    return RC_ERROR;
  }

  if( (p->m_sCommonName == "numbat") || (p->m_sCommonName == "zebra") )
  {
    showAsciiArt(cout, food, p->m_sSelfie);
  }
  else
  {
    showAsciiArt(cout, p->m_sSelfie, food);
  }
  cout << "Delicious! Give me " << fSecs << " seconds to enjoy." << endl;

  p->m_eActivity    = ActEating;
  p->m_fActStart    = ActivityTime.now();
  p->m_fActDuration = fSecs;

  return OK;
}

static int execGetPetsState ( const CmdExtArgVec &  argv )

static

Execute 'get' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 989 of file rnr_eg_cli.cxx.

References ActEating, ActIdle, ActSleeping, ActWalking, checkCmd(), findAnimal(), AnimalInfo::m_bIsAdopted, AnimalInfo::m_eActivity, AnimalInfo::m_sCommonName, AnimalInfo::m_sScientificName, AnimalInfo::m_sSelfie, and AnimalInfo::m_strGivenName.

{
  static const char *cmdname = "get";

  size_t  argc = argv.size();
  size_t  n;  

  // optional arguments defaults
  long eState = 0;

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  string  strAdoptState;
  string  strActivity;

  strAdoptState = p->m_bIsAdopted? "Adopted": "Not adopted";

  switch( p->m_eActivity )
  {
    case ActIdle:
      strActivity = "Just chill'n dude.";
      break;
    case ActSleeping:
      strActivity = "Sleeping, don't wake me.";
      break;
    case ActEating:
      strActivity = "Num, num, num.";
      break;
    case ActWalking:
      strActivity = "And I'm walking, and walking, walking...";
      break;
    default:
      strActivity = "I dunno what I'm doing.";
      break;
  }

  ++n;  // next argument

  //
  // Optional arguments.
  //

  // 
  // Argument 2
  //
  // State: all | adoption | given | activity | species | selfie
  //
  if( n < argc )
  {
    // convert to enum index
    eState = argv[n].e();
  }

  switch( eState )
  {
    case 1: // adoption
      cout << strAdoptState << endl;
      break;
    case 2: // given
      cout << p->m_strGivenName << endl;
      break;
    case 3: // activity
      cout << strActivity << endl;
      break;
    case 4: // species
      cout << p->m_sCommonName << " (" << p->m_sScientificName << ")" << endl;
      break;
    case 5: // selfie
      cout << p->m_sSelfie;
      break;
    case 0: // all
      cout << p->m_sSelfie;
      cout << p->m_sCommonName << " (" << p->m_sScientificName << ")" << endl;
      cout << strAdoptState << endl;
      cout << p->m_strGivenName << endl;
      cout << strActivity << endl;
      break;
    default:
      PCMDERROR(cmdname, "Unknown state '" << argv[n].arg() << "'.");
      return RC_ERROR;
      break;
  }

  return OK;
}

static int execListAnimals ( const CmdExtArgVec &  argv )

static

Execute 'list' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 968 of file rnr_eg_cli.cxx.

References AnimalInfo::m_sCommonName, and NumOfAnimals.

{
  static const char *cmdname = "list";

  for(size_t i = 0; i < NumOfAnimals; ++i)
  {
    cout << Animals[i].m_sCommonName << " ";
  }

  cout << endl;

  return OK;
}

static int execNamaste ( const CmdExtArgVec &  argv )

static

Execute 'namaste' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 785 of file rnr_eg_cli.cxx.

{
  static const char *cmdname = "namaste";

  cout << "Aye. Baaaa to the divine Ewe." << endl;

  return OK;
}

static int execNameAnimal ( const CmdExtArgVec &  argv )

static

Execute 'name' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 737 of file rnr_eg_cli.cxx.

References checkCmd(), findAnimal(), AnimalInfo::m_bIsAdopted, and AnimalInfo::m_strGivenName.

{
  static const char *cmdname = "name";

  size_t  argc = argv.size();
  size_t  n;  

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  else if( !p->m_bIsAdopted )
  {
    PCMDWARN(cmdname, "You have not adopted the " << animal << ".");
    return OK;
  }

  ++n;  // next argument

  p->m_strGivenName = argv[n].s();

  return OK;
}

static int execReward ( const CmdExtArgVec &  argv )

static

Execute 'reward' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1101 of file rnr_eg_cli.cxx.

References checkCmd(), findAnimal(), AnimalInfo::m_bIsAdopted, and AnimalInfo::m_sCommonName.

{
  static const char *cmdname = "reward";

  size_t  argc = argv.size();
  size_t  n;  

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required Arguments
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  else if( !p->m_bIsAdopted )
  {
    PCMDWARN(cmdname, "The " << animal << " is not yours to reward.");
    return OK;
  }

  ++n;  // next argument

  bool isGood = argv[n].b();

  cout << "Your " << p->m_sCommonName << " ";

  if( p->m_sCommonName == "aardvark" )
  {
    if( isGood )
    {
      cout << "is a good girl." << endl;
      cout << "She ate all of those pesky ants pilfering food in the kitchen."
        << endl;
    }
    else
    {
      cout << "was a bad girl." << endl;
      cout << "She dug under the foundation again." << endl;
    }
  }

  else if( p->m_sCommonName == "mandrill" )
  {
    if( isGood )
    {
      cout << "is a good boy." << endl;
      cout << "You are now well groomed and free of fleas." << endl;
    }
    else
    {
      cout << "is a mischieveus boy." << endl;
      cout << "Why does he love reality tv so much?" << endl;
    }
  }

  else if( p->m_sCommonName == "numbat" )
  {
    if( isGood )
    {
      cout << "is a good lad." << endl;
      cout << "Those termites won't be invading any time soon." << endl;
    }
    else
    {
      cout << "is a snarky lad." << endl;
      cout << "He needs to quit putting his long, narrow tongue where it "
        << "doesn't belong!" << endl;
    }
  }

  else if( p->m_sCommonName == "zebra" )
  {
    if( isGood )
    {
      cout << "is a good lass." << endl;
      cout << "You rode her all the way to town this time without being "
        << "thrown." << endl;
    }
    else
    {
      cout << "is a very naughty lass." << endl;
      cout << "She ate all of the apples ripening on the tree." << endl;
    }
  }

  else
  {
    cout << " is " << (isGood? "good": "not good") << "." << endl;
  }

  return OK;
}

static int execSave ( const CmdExtArgVec &  argv )

static

Execute 'save' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1215 of file rnr_eg_cli.cxx.

References checkCmd(), findAnimal(), AnimalInfo::m_sCommonName, and AnimalInfo::m_sSelfie.

{
  static const char *cmdname = "save";

  size_t  argc = argv.size();
  size_t  n;  

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  ++n;  // next argument

  string filename = argv[n].s();
  bool   bSave    = false;

  if( access(filename.c_str(), F_OK) == 0 )
  {
    string line;
    string ans;

    cout << "Overwrite file '" << argv[n] << "'? [ny] ";

    if( std::getline(cin, line) )
    {
      istringstream iss(line);
      if( (iss >> ans) && (ans == "y") )
      {
        bSave = true;
      }
    }
  }
  else
  {
    bSave = true;
  }

  if( bSave )
  {
    ofstream selfie;

    selfie.open(filename.c_str());

    if( selfie.is_open() )
    {
      selfie << p->m_sSelfie;
      selfie.close();
      cout << "A " << p->m_sCommonName << " selfie writen to file '"
        << argv[n] << "'." << endl;
    }
    else
    {
      PCMDERROR(cmdname, "Failed to open file '" << argv[n] << "'.");
    }
  }

  return OK;
}

static int execSleep ( const CmdExtArgVec &  argv )

static

Execute 'sleep' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 672 of file rnr_eg_cli.cxx.

References ActSleeping, checkCmd(), findAnimal(), AnimalInfo::m_bIsAdopted, AnimalInfo::m_eActivity, AnimalInfo::m_fActDuration, AnimalInfo::m_fActStart, AnimalInfo::m_sCommonName, and rnr::chronos::Time::now().

{
  static const char *cmdname = "sleep";

  size_t  argc = argv.size();
  size_t  n;  

  // optional defaults
  long    secs = 10;

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  else if( !p->m_bIsAdopted )
  {
    PCMDWARN(cmdname, "The " << animal << " is not yours to rock to sleep.");
    return OK;
  }

  ++n;

  //
  // Optional arguments
  //

  if( n < argc )
  {
    secs = argv[n].i();
  }

  p->m_eActivity    = ActSleeping;
  p->m_fActStart    = ActivityTime.now();
  p->m_fActDuration = (double)secs;

  cout << "The " << p->m_sCommonName << " is sleeping for " << secs
    << " seconds." << endl;

  return OK;
}

static int execTAdd ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tadd subcommand.

Add a new command to interface.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1449 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::addCommand(), rnr::cmd::CommandLine::compile(), findCommand(), rnr::cmd::CommandLine::getErrorStr(), rnr::cmd::CommandLine::hasCmd(), AppCmdExec::m_desc, AppCmdExec::m_fnExec, and rnr::cmd::NoUid.

Referenced by execCliTest().

{
  size_t  nCmd = 0;   // index to command name 
  size_t  nArg = 1;   // index to current working argument
  int     i;
  int     nUid;
  int     rc = RC_ERROR;

  if( nArg >= argv.size() )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd] << ": No <cmd> specified.");
  }
  else if( (i = findCommand(argv[nArg].s())) < 0 )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
            << ": Unknown <cmd> '" << argv[nArg] << "'.");
  }
  else if( cli.hasCmd(argv[nArg].s()) )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
          << ": The <cmd> '" << argv[nArg]
          << "' is already present in the interface.");
  }
  else if( (nUid = cli.addCommand(Commands[i].m_desc, Commands[i].m_fnExec)) ==
                                                          NoUid )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
          << ": Failed to add <cmd> '" << argv[nArg] << "': "
          << cli.getErrorStr() << ".");
  }
  else if( (rc = cli.compile()) != OK )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
          << ": Failed to (re)compile interface: "
          << cli.getErrorStr() << ".");
  }
  else
  {
    cout << "Command '" << argv[nArg] << ", uid(" << nUid << ") added."
        << endl;
    rc = OK;
  }

  return rc;
}

static int execTBt ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tbt subcommand.

Print interface attribute.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1505 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::backtrace().

Referenced by execCliTest().

{
  cli.backtrace(cout, true);

  return OK;
}

static int execTCompile ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tcompile subcommand.

(Re)compile the interface.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1522 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::compile(), rnr::cmd::CommandLine::getErrorStr(), and rnr::cmd::CommandLine::numOfCmds().

Referenced by execCliTest().

{
  size_t  nCmd = 0;   // index to command name 
  int     rc;

  if( (rc = cli.compile()) != OK )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
            << ": Failed to (re)compile interface: "
            << cli.getErrorStr() << ".");
    rc = RC_ERROR;
  }
  else
  {
    cout << "Compiled " << cli.numOfCmds() << " commands." << endl;
    rc = OK;
  }

  return rc;
}

static int execTDump ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tdump subcommand.

Dump specified command or full command-line interface.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1553 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::at(), and rnr::cmd::NoUid.

Referenced by execCliTest().

{
  size_t  nCmd = 0;   // index to command name 
  size_t  nArg = 1;   // index to current working argument
  int     rc;

  // dump command definition
  if( nArg < argv.size() )
  {
    if( cli.at(argv[nArg].s()).getUid() == NoUid )
    {
      PCMDERROR(CliTestCmdName, argv[nCmd]
            << ": The <cmd> '" << argv[nArg]
            << "' is not present in the interface.");
      rc = RC_ERROR;
    }
    else
    {
      cout << cli.at(argv[nArg].s()) << endl;  // dump command
      rc = OK;
    }
  }

  // dump full interface
  else
  {
    cout << cli << endl;
    rc = OK;
  }

  return rc;
}

static int execTKbhit ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tkbhit subcommand.

Loop to check non-blocking input.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1596 of file rnr_eg_cli.cxx.

Referenced by execCliTest().

{
  int   c = 0;

  cout << "Press any key, 's' to stop test." << endl;

  while( c != 's' )
  {
    if( cli.kbhit() )
    {
      c = getchar();
      cout << "     \r" << std::flush;
      switch( c )
      {
        case '\n':
          cout << "\\n";
          break;
        case '\t':
          cout << "\\t";
          break;
        default:
          cout << (char)c;
          break;
      }
      cout << "\r" << std::flush;
    }
  }

  cout << endl;

  return OK;
}

static int execTPrint ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tprint subcommand.

Print interface attribute.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1639 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::getErrorStr(), rnr::cmd::CommandLine::getName(), rnr::cmd::CommandLine::getPrompt(), and rnr::cmd::CommandLine::numOfCmds().

Referenced by execCliTest().

{
  size_t  nCmd = 0;   // index to command name 
  size_t  nArg = 1;   // index to current working argument
  int     rc   = OK;

  if( nArg >= argv.size() )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd] << ": No <attr> specified.");
    rc = RC_ERROR;
  }
  else if( argv[nArg] == "name" )       // interface name
  {
    cout << cli.getName() << endl;
  }
  else if( argv[nArg] == "prompt" )     // current prompt string
  {
    cout << cli.getPrompt() << endl;
  }
  else if( argv[nArg] == "numcmds" )    // number of added commands
  {
    cout << cli.numOfCmds() << endl;
  }
  else if( argv[nArg] == "errstr" )     // last error 
  {
    cout << cli.getErrorStr() << endl;
  }
  else
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
        << ": Unknown <attr> '" << argv[nArg] << "'.");
    rc = RC_ERROR;
  }

  return rc;
}

static int execTPush ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tpush subcommand.

Push new prompt.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1686 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::pushPrompt().

Referenced by execCliTest().

{
  size_t  nCmd = 0;   // index to command name 
  size_t  nArg = 1;   // index to current working argument
  int     rc;

  // push prompt string
  if( nArg < argv.size() )
  {
    cli.pushPrompt(argv[nArg].s());
    rc = OK;
  }
  else
  {
    PCMDERROR(CliTestCmdName, argv[nCmd] << ": No <prompt> specified.");
    rc = RC_ERROR;
  }

  return rc;
}

static int execTRemove ( CommandLine &  cli, const CmdExtArgVec &  argv  )

static

Execute clitest tremove subcommand.

Remove command from the interface.

Parameters

cli	Command line interface.
argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 1717 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::at(), rnr::cmd::CommandLine::getErrorStr(), rnr::cmd::NoUid, and rnr::cmd::CommandLine::removeCommand().

Referenced by execCliTest().

{
  size_t  nCmd = 0;   // index to command name 
  size_t  nArg = 1;   // index to current working argument
  int     nUid;
  int     rc;

  rc = RC_ERROR;

  if( nArg >= argv.size() )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd] << ": No <cmd> specified.");
  }
  else if( (nUid = cli.at(argv[nArg].s()).getUid()) == NoUid )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
          << ": The <cmd> '" << argv[nArg]
          << "' is not present in the interface.");
  }
  else if( (rc = cli.removeCommand(argv[nArg].s())) != OK )
  {
    PCMDERROR(CliTestCmdName, argv[nCmd]
          << ": Failed to remove <cmd> '" << argv[nArg] << "': "
          << cli.getErrorStr() << ".");
  }
  else
  {
    cout << "Command '" << argv[nArg] << "', uid(" << nUid << ") removed."
        << endl;
    rc = OK;
  }

  return rc;
}

static int execWalkAnimal ( const CmdExtArgVec &  argv )

static

Execute 'walk' command.

Parameters

argv	Command line arguments.

Returns

OK(0) on success, negative value on failure.

Definition at line 890 of file rnr_eg_cli.cxx.

References ActWalking, AsciiWalking, checkCmd(), findAnimal(), AnimalInfo::m_bIsAdopted, AnimalInfo::m_eActivity, AnimalInfo::m_fActDuration, AnimalInfo::m_fActStart, AnimalInfo::m_sCommonName, and rnr::chronos::Time::now().

{
  static const char *cmdname = "walk";

  size_t  argc = argv.size();
  size_t  n;  

  if( checkCmd(argv[0], argc, cmdname) != OK )
  {
    return RC_ERROR;
  }

  n = 1;  // skip argv0

  //
  // Required arguments.
  //

  string animal = argv[n].s();

  AnimalInfo *p = findAnimal(animal);

  if( p == NULL )
  {
    PCMDERROR(cmdname, "Unknown animal '" << animal << "'.");
    return RC_ERROR;
  }

  else if( !p->m_bIsAdopted )
  {
    PCMDWARN(cmdname, "The " << animal << " is not yours to walk.");
    return OK;
  }

  ++n;  // next argument

  double  minutes = argv[n].f();

  p->m_eActivity    = ActWalking;
  p->m_fActStart    = ActivityTime.now();
  p->m_fActDuration = (double)minutes * 60.0;

  cout << "You are walking the " << p->m_sCommonName << " for " << minutes
    << " minutes." << endl;

  //
  // Fun stuff
  //
  const char *gait;

  //
  // I used printf here, instead of cout insertion. Lot easier. But then, I've
  // always preferred stdio over fstream.
  //
  for(int i = 0; i < 40; ++i)
  {
    gait = AsciiWalking[i%4][0];
    printf("%*s%s\r", i, " ", gait);
    fflush(stdout);
    usleep(50000);
  }

  usleep(250000);
  printf("%*s\r", 80, " ");
  fflush(stdout);

  printf("\n");

  return OK;
}

static AnimalInfo* findAnimal ( const string &  strCommonName )

static

Find the animal with the common name.

Parameters

strCommonName

Common name.

Returns

On succes, returns pointer to the animal's info. On failure, NULL is returned.

Definition at line 536 of file rnr_eg_cli.cxx.

References NumOfAnimals.

Referenced by execAdopt(), execFeedAnimal(), execGetPetsState(), execNameAnimal(), execReward(), execSave(), execSleep(), and execWalkAnimal().

{
  for(size_t i = 0; i < NumOfAnimals; ++i)
  {
    if( strCommonName == Animals[i].m_sCommonName )
    {
      return &Animals[i];
    }
  }
  return NULL;
}

static int findCommand ( const std::string &  strName )

static

Find command by name.

Parameters

strName

Command to find.

Returns

On succes, returns index to Commands[], otherwise -1 is returned.

Definition at line 1420 of file rnr_eg_cli.cxx.

References NumOfCmds.

Referenced by execTAdd().

{
  for(int i = 0; i < NumOfCmds; ++i)
  {
    if( strName == Commands[i].m_desc.name )
    {
      return i;
    }
  }
  return -1;
}

static int loadCommands ( CommandLine &  cli )

static

Load commands into command line.

Loading involves adding all commands and then compiling.

Parameters

cli	Command line interface.

Returns

OK(0) on success, negative value on failure.

Definition at line 1952 of file rnr_eg_cli.cxx.

References rnr::cmd::addons::addBtEnableCommand(), rnr::cmd::CommandLine::addCommand(), rnr::cmd::addons::addHelpCommand(), rnr::cmd::addons::addQuitCommand(), rnr::cmd::CommandLine::backtrace(), rnr::cmd::CommandLine::compile(), rnr::cmd::NoUid, NumOfCmd3s, NumOfCmds, and PERROR.

Referenced by main().

{
  int   nUid;
  int   rc;

  //
  // Add "normal" commands to command-line interface.
  //
  for(size_t i = 0; i < NumOfCmds; ++i)
  {
    nUid = cli.addCommand(Commands[i].m_desc, Commands[i].m_fnExec);

    if( nUid == NoUid )
    {
      PERROR("Failed to add command '" << Commands[i].m_desc.name << "'.");
      return RC_ERROR;
    }
  }

  //
  // Add "self-referenced" commands to command-line interface.
  //
  for(size_t i = 0; i < NumOfCmd3s; ++i)
  {
    nUid = cli.addCommand(Command3s[i].m_desc, Command3s[i].m_fnExec);

    if( nUid == NoUid )
    {
      PERROR("Failed to add command '" << Command3s[i].m_desc.name << "'.");
      return RC_ERROR;
    }
  }

  //
  // Add built-in commands to interface.
  //
  addons::addHelpCommand(cli);
  addons::addQuitCommand(cli);
  addons::addBtEnableCommand(cli);

  //
  // Now compile comamnd-line interace.
  //
  if( (rc = cli.compile()) != OK )
  {
    PERROR("Compile failed.");
    cerr << "(backtrace)" << endl;
    cli.backtrace(cerr, true);
  }

  return rc;
}

int main	(	int	argc,
		char *	argv[]
	)

Main.

Parameters

argc	Command-line argument count.
argv	Command-line argument list.

Returns

Returns 0 on succes, non-zero on failure.

Definition at line 2057 of file rnr_eg_cli.cxx.

References APP_EC_EXEC, APP_EC_OK, AsciiAardvark, Cli, CliName(), loadCommands(), mainInit(), PERROR, and run().

{
  mainInit(argc, argv);

  if( loadCommands(Cli) != OK )
  {
    PERROR("Failed to load commands.");
    return APP_EC_EXEC;
  }

  // debug
  //cerr << Cli << endl;

  cout << AsciiAardvark;
  cout << CliName << " CommandLine/ReadLine/LogBook/RegEx Example" << endl;
  cout << "  (enter 'help' for list of commands)" << endl << endl;

  if( run(Cli) != OK )
  {
    PERROR("Failed to run commands.");
    return APP_EC_EXEC;
  }

  return APP_EC_OK;
}

static void mainInit ( int  argc, char *  argv[]  )

static

Main initialization.

Parameters

argc	Command-line argument count.
argv	Command-line argument list.

Exits:

Program terminates on conversion error.

Definition at line 1909 of file rnr_eg_cli.cxx.

References Argv0, OptsInfo, PgmInfo, and PkgInfo.

Referenced by main().

{
  // name of this process
  Argv0 = basename(argv[0]);

  // parse input options
  argv = OptsGet(Argv0, &PkgInfo, &PgmInfo, OptsInfo, true, &argc, argv);
}

static ostream& operator<< ( ostream &  os, const char *  art[]  )

static

ASCII art output stream operator.

Parameters

os	Output stream.
art	Art to insert.

Returns

Reference to output stream.

Definition at line 367 of file rnr_eg_cli.cxx.

{
  for(int i = 0; art[i] != NULL; ++i)
  {
    os << art[i] << endl;
  }
  return os;
}

static int run ( CommandLine &  cli )

static

Command line interface main loop.

Parameters

cli	Command line interface.

Returns

OK(0) on success, negative value on failure.

Definition at line 2012 of file rnr_eg_cli.cxx.

References rnr::cmd::CommandLine::addToHistory(), rnr::cmd::CommandLine::execute(), rnr::cmd::CommandLine::ok(), PERROR, rnr::cmd::CommandLine::readCommand(), and updateAnimals().

Referenced by main().

{
  CmdExtArgVec  argv;     // vector of string input arguments
  int           rc;       // return code

  while( cli.ok() )
  {
    rc = cli.readCommand(argv);

    updateAnimals();

    if( rc == OK )
    {
      // see the results of a good command match
      //cli.backtrace(cerr);

      if( argv.size() > 0 ) 
      {
        rc = cli.execute(argv);

        if( rc == OK )
        {
          cli.addToHistory(argv);
        }
      }
    }
    else
    {
      PERROR("Bad command.");
      // cerr << "backtrace:" << endl;
      // cli.backtrace(cerr);
    }
  }

  return OK;
}

static void showAsciiArt ( ostream &  os, const char *  art0[], const char *  art1[], const char *  art2[] = NULL, const char *  art3[] = NULL  )

static

Write a set of ASCII art to cout.

The art written left to right, bottom justified.

Parameters

os	Output stream.
art0	Required art 0.
art1	Required art 1.
art2	Optional art 2.
art3	Optional art 3.

Definition at line 387 of file rnr_eg_cli.cxx.

Referenced by execFeedAnimal().

{
  int nPieces = 2;
  int linecnt[4];
  int maxlen[4];
  int maxlinecnt = 0;
  int len;
  int i, j;

  const char **pieces[4];

  pieces[0] = art0;
  pieces[1] = art1;

  if( art2 != NULL )
  {
    ++nPieces;
    pieces[2] = art2;
  }

  if( art3 != NULL )
  {
    ++nPieces;
    pieces[3] = art3;
  }

  // gather stats
  for(i = 0; i < nPieces; ++i)
  {
    linecnt[i]  = 0;
    maxlen[i]   = 0;

    for(j = 0; pieces[i][j] != NULL; ++j)
    {
      len = strlen(pieces[i][j]);
      if( len > maxlen[i] )
      {
        maxlen[i] = len;
      }
      linecnt[i] += 1;
    }

    if( linecnt[i] > maxlinecnt )
    {
      maxlinecnt = linecnt[i];
    }
  }

  char    ofill  = os.fill();
  size_t  owidth = os.width();

  os.fill(' ');

  // show
  for(int line = 0; line < maxlinecnt; ++line)
  {
    for(i = 0; i < nPieces; ++i)
    {
      if( linecnt[i] >= maxlinecnt-line )
      {
        j = linecnt[i] - (maxlinecnt - line);
        // os << "line " << line << ", art " << i << " j " << j << endl;
        len = strlen(pieces[i][j]);
        os << pieces[i][j] << setw(maxlen[i]-len+1) << "";
      }
      else
      {
        os << setw(maxlen[i]) << "";
      }
    }
    os << endl;
  }

  os.fill(ofill);
  os.width(owidth);
}

Variable Documentation

AnimalInfo Animals[]

Initial value:

= 
{
  { "aardvark",  "orycteropus afer",      AsciiAardvark,
    NoName, false, ActIdle, 0.0, 0.0
  },

  { "mandrill",  "mandrillus sphinx",     AsciiMandrill,
    NoName, false, ActIdle, 0.0, 0.0
  },

  { "numbat",    "myrmecobius fasciatus", AsciiNumbat,
    NoName, false, ActIdle, 0.0, 0.0
  },

  { "zebra",     "equus quagga",          AsciiZebra,
    NoName, false, ActIdle, 0.0, 0.0
  }
}

The animals.

Definition at line 506 of file rnr_eg_cli.cxx.

const char* AsciiAardvark[]

static

Initial value:

=
{
"        _.---._    /\\\\",
"     ./'       \"--`\\//",
"   ./              o \\",
"  /./\\  )______   \\__ \\",
" ./  / /\\ \\   | \\ \\  \\ \\",
"    / /  \\ \\  | |\\ \\  \\7",
"     \"     \"    \"  \"",
}

ASCII ardvaark.

Definition at line 125 of file rnr_eg_cli.cxx.

Referenced by main().

const char* AsciiAnt[]

static

Initial value:

=
{
" '\\__",
"  (o )     ___",
"  <>(_)(_)(___)",
"    < < > >",
"    ' ' ` `",
NULL
}

ASCII ant.

Definition at line 260 of file rnr_eg_cli.cxx.

Referenced by execFeedAnimal().

const char* AsciiCarrot[]

static

Initial value:

=
{
"    \\/'",
"   \\/'",
"  _/'",
" (,;)",
" (,.)",
" (,/",
" |/",
NULL
}

ASCII carrot.

Definition at line 298 of file rnr_eg_cli.cxx.

Referenced by execFeedAnimal().

const char* AsciiGrub[]

static

Initial value:

=
{
" \\",
"  '-.__.-'",
"  /oo |--.--,--,--.",
"  \\_.-'._i__i__i_.'",
"        \"\"\"\"\"\"\"\"\"",
NULL
}

ASCII grub.

Definition at line 273 of file rnr_eg_cli.cxx.

Referenced by execFeedAnimal().

const char* AsciiMandrill[]

static

Initial value:

=
{
" ::        ,-,       ::",
" ::       :o~o:      ::",
"  ::.___.-:{|}:--..-::;",
"   \"=___   '_'   ,..-\"",
"        :-,    ' :__",
"        \\  \\     /  :",
"         \\  :. .:,__:",
NULL
}

ASCII Mandrill.

Definition at line 151 of file rnr_eg_cli.cxx.

const char* AsciiNumbat[]

static

Initial value:

=
{
" _             ____              ~^",
" \\`.|\\..----''` / /`'--.,.,,     ~''",
" /  ' `     / /,/ / /  ,,. -    ~,,",
" )/' _/     \\ / `-_,/  /   - \",,,' ",
" | /' `\"\\_  ,_.-;_.-\\_ ',   '',,,'",
" |/   _.-'_/   <__.'   ; ",
"    {_.-``-'         <__",
NULL
}

ASCII numbat.

Definition at line 178 of file rnr_eg_cli.cxx.

const char* AsciiVitamins[]

static

Initial value:

=
{
"     _____",
"   _(_|_|_)_",
"  /  _      \\",
" '  (C) ( \\  '",
" | ___   \\B\\ |",
" |(_A_)   \\ )|",
" '___________'",
NULL
}

ASCII bottle of vitamins.

Definition at line 325 of file rnr_eg_cli.cxx.

Referenced by execFeedAnimal().

const char* AsciiWalking[][2]

static

Initial value:

=
{
  {" |''''|\"> ",   NULL},
  {" |\\'''|\\\">", NULL},
  {" /\\'''/\\\">", NULL},
  {" /|''/|\"> ",   NULL}
}

ASCII walk sequence.

Definition at line 351 of file rnr_eg_cli.cxx.

Referenced by execWalkAnimal().

const char* AsciiZebra[]

static

Initial value:

=
{
"   \\\\/),",
"  ,'.' /,",
" (_)- / /,",
"    /\\_/ |__..--,  *",
"   (\\ _ /\\ \\ \\ / ).'",
"    \\(-'./ / (_ //",
"     \\\\ \\,'--'\\_(",
"     )(_/  )_/ )_)",
"    (_,'  (_.'(_.'",
NULL
}

ASCII zebra.

Definition at line 226 of file rnr_eg_cli.cxx.

const char* AsciiZebraSmall[]

static

Initial value:

=
{
"         ,,_   ",
"        =/.-\" ",
" ~._   =//     ",
"   _(||||\\|_  ",
"  /        /   ",
NULL
}

ASCII small zebra.

Definition at line 213 of file rnr_eg_cli.cxx.

AppCmdExec3 Command3s[]

Initial value:

=
{
  { { CliTestCmdName,
      "<clitest:re(^t[abcdkpr].+)> [<modifier:multiword>]",
      "Test CommandLine interface features.",
      "The 'clitest' command validates command wild carding and provides test "
      "functions to validate the CommandLine and underlining classes.\n\n"
      "Supported Test Functions:\n"
      "  tadd <cmd>     - Add command to interface.\n"
      "  tbt            - Backtrace log.\n"
      "  tcompile       - (Re)compile interface.\n"
      "  tdump [<cmd>]  - Dump all or <cmd> definitions.\n"
      "  tkbhit         - Check for keyboard hits.\n"
      "  tprint <attr>  - Print attribute, where <attr> is one of:\n"
      "                     name prompt numcmds errstr.\n"
      "  tpush <prompt> - Push new <prompt> string.\n"
      "  tpop           - Pop current prompt string.\n"
      "  tremove <cmd>  - Remove command from interface.\n\n"
      "Demonstrates command name wild carding.\n"
      "Demonstrates regular expresson variable argument type."
    },
    execCliTest
  }
}

The command descriptions.

Definition at line 1865 of file rnr_eg_cli.cxx.

OptsInfo_T OptsInfo[]

static

Initial value:

=
{
  {NULL, }
}

Command line options information.

Definition at line 100 of file rnr_eg_cli.cxx.

Referenced by mainInit().

OptsPgmInfo_T PgmInfo

static

Initial value:

=
{
  
  NULL,

  
  "A RoadNarrows Robotics librnr_appkit CLI example program.",

  
  "The %P command demonstrates the use of librnr_appkit's CommandLine, "
  "ReadLine, LogBook, RegEx classes to build a command line interface.",

  
  NULL
}

Program information.

Definition at line 81 of file rnr_eg_cli.cxx.

Referenced by mainInit().