The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

JDDPAUSE / MarpaX-ESLIF-3.0.27 / lib / MarpaX / ESLIF / Value / Interface.pod 

            

              
1
2
3
4
5
—
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

              
# PODNAME: MarpaX::ESLIF::Value::Interface
# ABSTRACT: MarpaX::ESLIF's value interface
__END__
=pod
=encoding UTF-8
=head1 NAME
MarpaX::ESLIF::Value::Interface - MarpaX::ESLIF's value interface
=head1 VERSION
version 3.0.27
=head1 DESCRIPTION
Value interface is a list of methods that are required by MarpaX::ESLIF at run-time to perform valuation. It has to be an object instance, referenced with C<$valueInterface> below.
=head1 METHODS
=over
=item $valueInterface->isWithHighRankOnly()
Returns the rank order preference.
When the interface returns true, only the choices with the highest rank are kept. This method is used at valuation instance creation step only.
=item $valueInterface->isWithOrderByRank()
Returns the rank order preference.
Orders the parse tree values by their rank value. This method is used at valuation instance creation step only.
=item $valueInterface->isWithAmbiguous()
Returns the ambiguity acceptance.
Accept ambiguous parse tree. This method is used at valuation instance creation step only.
=item $valueInterface->isWithNull()
Returns the null acceptance.
Accept a null parse tree value (e.g. when the start rule is not complete). This method is used at valuation instance creation step only.
=item $valueInterface->maxParses()
Returns the maximum number of wanted parses, 0 for all parse trees.
A very ambiguous parsing can provide a lot of parse tree values, it is possible to reduce such number, at the cost of not having all the valuation possibilities. This method is used at valuation instance creation step only.
=item $valueInterface->setResult($result)
Store the parsing result.
When valuation is successful, marpaESLIF is using this callback.
=item $valueInterface->getResult()
Returns the parsing result.
marpaESLIF is not using this method per-se, but it is nevertheless required to ensure the interface coherency v.s. the C<getResult()> required method.
=back
=head1 LOCALIZED VARIABLES
At each symbol or rule callback, the following values are localized:
=over
=item C<$MarpaX::ESLIF::Context::symbolName>
Symbol name in case of a symbol callback, C<undef> otherwise.
=item C<$MarpaX::ESLIF::Context::symbolNumber>
Symbol number in case of a symbol callback, C<undef> otherwise.
=item C<$MarpaX::ESLIF::Context::ruleName>
Rule name in case of a rule callback, C<undef> otherwise.
=item C<$MarpaX::ESLIF::Context::ruleNumber>
Rule number in case of a rule callback, C<undef> otherwise.
=item C<$MarpaX::ESLIF::Context::grammar>
Grammar instance.
=back
=head1 OPTIONAL METHODS SINCE VERSION 2.0.15
=over
=item $valueInterface->setSymbolName($symbolName)
Stores symbol name. Always set in case of a symbol callback, C<undef> otherwise.
=item $valueInterface->setSymbolNumber($symbolNumber)
Stores symbol number. Always set in case of a symbol callback, C<undef> otherwise.
=item $valueInterface->setRuleName($ruleName)
Stores rule name. Always set in case of a rule callback, C<undef> otherwise.
=item $valueInterface->setRuleNumber($ruleNumber)
Stores rule number. Always set in case of a rule callback, C<undef> otherwise.
=item $valueInterface->setGrammar($grammar)
Stores grammar instance.
=back
=head1 AUTHOR
Jean-Damien Durand <jeandamiendurand@free.fr>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2017 by Jean-Damien Durand.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut