bs::shell_node_dollar_command Class Reference

Command-substitution node used in $() or backticks when appearing inside other contexts. More...

#include <shell_node.h>

Inheritance diagram for bs::shell_node_dollar_command:

Collaboration diagram for bs::shell_node_dollar_command:

Public Member Functions
	shell_node_dollar_command (std::size_t nPos, std::unique_ptr< shell_node_evaluable > &&pCommand)
	Construct a dollar-command node.
void	expand (std::vector< std::string > &vTokens, shell_session &oSession, bool bSplit) const override
	Expand by executing the subcommand and inserting its textual output. Expand the node into textual tokens. Parameters vTokens Vector where generated token strings will be appended. oSession Session context (used for variable/argument lookup, etc.). bSplit When true apply word-splitting semantics; otherwise keep as single token. .
const shell_node_evaluable *	get_command () const noexcept
	Get non-owning pointer to the subcommand.
Public Member Functions inherited from bs::shell_node_expandable
	shell_node_expandable (const shell_node_type nType, const std::size_t nPos)
	Construct an expandable node.
Public Member Functions inherited from bs::shell_node
virtual	~shell_node ()=default
	Virtual default destructor for polymorphic deletion.
shell_node_type	get_type () const noexcept
	Get the node type.
std::size_t	get_pos () const noexcept
	Get node position in the original input stream.

Additional Inherited Members
Protected Member Functions inherited from bs::shell_node
	shell_node (const shell_node_type nType, const std::size_t nPos)
	Protected constructor used by derived classes.
Protected Attributes inherited from bs::shell_node
const shell_node_type	m_nType
	Node type.
const std::size_t	m_nPos
	Position in the input stream.

Detailed Description

Command-substitution node used in $() or backticks when appearing inside other contexts.

The node owns an evaluable subcommand that will be executed during expansion.

Constructor & Destructor Documentation

shell_node_dollar_command()

bs::shell_node_dollar_command::shell_node_dollar_command	(	std::size_t	nPos,
		std::unique_ptr< shell_node_evaluable > &&	pCommand
	)

Construct a dollar-command node.

Exceptions

shell_node_invalid_argument

If pCommand is null.

Parameters

nPos	Command position in the stream.
pCommand	Owned evaluable subcommand.

Member Function Documentation

expand()

void bs::shell_node_dollar_command::expand ( std::vector< std::string > &  vTokens, shell_session &  oSession, bool  bSplit  ) const

overridevirtual

Expand by executing the subcommand and inserting its textual output. Expand the node into textual tokens.

Parameters

vTokens	Vector where generated token strings will be appended.
oSession	Session context (used for variable/argument lookup, etc.).
bSplit	When true apply word-splitting semantics; otherwise keep as single token.

.

Implements bs::shell_node_expandable.

get_command()

const shell_node_evaluable * bs::shell_node_dollar_command::get_command ( ) const

inlinenoexcept

Get non-owning pointer to the subcommand.

Returns

const shell_node_evaluable* Pointer to the subcommand.

---

The documentation for this class was generated from the following files:

• /home/runner/work/bashspark/bashspark/include/BashSpark/shell/shell_node.h
• /home/runner/work/bashspark/bashspark/src/BashSpark/shell/shell_node.cpp
• /home/runner/work/bashspark/bashspark/src/BashSpark/shell/shell_node_expand.cpp