.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Cucumber::TagExpressions::Node 3pm"
.TH Cucumber::TagExpressions::Node 3pm "2023-08-22" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Cucumber::TagExpressions::Node \- Cucumber Tag expression components
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use Cucumber::TagExpressions;
\&
\&  my $expr = Cucumber::TagExpressions\->parse( \*(Aq@a and @b\*(Aq );
\&  if ( $expr\->evaluate( qw/x y z/ ) ) {
\&     say "The evaluation returned false";
\&  }
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module defines the components making up the tag expressions.
.SH "METHODS"
.IX Header "METHODS"
.ie n .SS "evaluate( @tags )"
.el .SS "evaluate( \f(CW@tags\fP )"
.IX Subsection "evaluate( @tags )"
Returns \f(CW\*(C`true\*(C'\fR when the tag set specified in \f(CW$tags\fR satisfies the
condition(s) of the expression, \f(CW\*(C`false\*(C'\fR otherwise.
.PP
\&\f(CW@tags\fR can be a list of tags to be used in the expression. It can
also be a reference to a hash with the keys being the tags and the
values being considered boolean values indicating whether the tag (key)
is considered part of the tagset (true) or not (false).
.SS "stringify"
.IX Subsection "stringify"
Returns a string representation of the expression node.
.SH "NODE CLASSES"
.IX Header "NODE CLASSES"
.SS "Cucumber::TagExpressions::LiteralNode"
.IX Subsection "Cucumber::TagExpressions::LiteralNode"
\fI\s-1DESCRIPTION\s0\fR
.IX Subsection "DESCRIPTION"
.PP
This node class returns \f(CW\*(C`true\*(C'\fR if the literal tag is specified as part of
the tag-list in the expression evaluation.
.PP
\fI\s-1ATTRIBUTES\s0\fR
.IX Subsection "ATTRIBUTES"
.PP
tag
.IX Subsection "tag"
.PP
The tag to test presence for.
.SS "Cucumber::TagExpressions::AndNode"
.IX Subsection "Cucumber::TagExpressions::AndNode"
\fI\s-1DESCRIPTION\s0\fR
.IX Subsection "DESCRIPTION"
.PP
This node class type evaluates one or more sub-expressions (\*(L"terms\*(R") and
returns \f(CW\*(C`false\*(C'\fR if any of the terms does. It returns \f(CW\*(C`true\*(C'\fR if all of
the terms return \f(CW\*(C`true\*(C'\fR.
.PP
\fI\s-1ATTRIBUTES\s0\fR
.IX Subsection "ATTRIBUTES"
.PP
terms
.IX Subsection "terms"
.PP
The sub-expressions to evaluate.
.SS "Cucumber::TagExpressions::OrNode"
.IX Subsection "Cucumber::TagExpressions::OrNode"
\fI\s-1DESCRIPTION\s0\fR
.IX Subsection "DESCRIPTION"
.PP
This node class type evaluates one or more sub-expressions (\*(L"terms\*(R") and
returns \f(CW\*(C`true\*(C'\fR if any of the terms does. It returns \f(CW\*(C`false\*(C'\fR if all of
the terms return \f(CW\*(C`false\*(C'\fR.
.PP
\fI\s-1ATTRIBUTES\s0\fR
.IX Subsection "ATTRIBUTES"
.PP
terms
.IX Subsection "terms"
.PP
The sub-expressions to evaluate.
.SS "Cucumber::TagExpressions::NotNode"
.IX Subsection "Cucumber::TagExpressions::NotNode"
\fI\s-1DESCRIPTION\s0\fR
.IX Subsection "DESCRIPTION"
.PP
This class wraps one of the other node class types, negating its
result on evaluation.
.PP
\fI\s-1ATTRIBUTES\s0\fR
.IX Subsection "ATTRIBUTES"
.PP
expression
.IX Subsection "expression"
.PP
The wrapped node class instance for which to negate the result.
.SS "Cucumber::TagExpressions::ExpressionNode"
.IX Subsection "Cucumber::TagExpressions::ExpressionNode"
\fI\s-1DESCRIPTION\s0\fR
.IX Subsection "DESCRIPTION"
.PP
This class models the outer-most node in the tag expression; it wraps all
other nodes and is the entry-point for tag expression evaluation.
.PP
\fI\s-1ATTRIBUTES\s0\fR
.IX Subsection "ATTRIBUTES"
.PP
sub_expression
.IX Subsection "sub_expression"
.PP
An instance of one of the other node class types.
.SH "LICENSE"
.IX Header "LICENSE"
Please see the included \s-1LICENSE\s0 for the canonical version. In summary:
.PP
The \s-1MIT\s0 License (\s-1MIT\s0)
.PP
.Vb 2
\&  Copyright (c) 2021 Erik Huelsmann
\&  Copyright (c) 2021 Cucumber Ltd
.Ve
.PP
This work is loosely derived from prior work of the same library for Ruby,
called \f(CW\*(C`cucumber\-messages\*(C'\fR.