Gestionnaire de fichiers

Gestionnaire de fichiers - Editer - /opt/cpanel/ea-ruby24/root/usr/share/ri/system/Racc/cdesc-Racc.ri

Arrière
U:RDoc::NormalModule[iI" Racc:ET@0o:RDoc::Markup::Document:@parts[o;;[�: @fileI"ext/racc/cparse/cparse.c;T:0@omit_headings_from_table_of_contents_below0o;;[Io:RDoc::Markup::Paragraph;[I")Racc is a LALR(1) parser generator. ;TI"?It is written in Ruby itself, and generates Ruby programs.;To:RDoc::Markup::BlankLine�S:RDoc::Markup::Heading: leveli: textI"Command-line Reference;T@o:RDoc::Markup::Verbatim;[I"Fracc [-o<var>filename</var>] [--output-file=<var>filename</var>] ;TI"C [-e<var>rubypath</var>] [--embedded=<var>rubypath</var>] ;TI" [-v] [--verbose] ;TI"C [-O<var>filename</var>] [--log-file=<var>filename</var>] ;TI" [-g] [--debug] ;TI" [-E] [--embedded] ;TI"# [-l] [--no-line-convert] ;TI"$ [-c] [--line-convert-all] ;TI"# [-a] [--no-omit-actions] ;TI" [-C] [--check-only] ;TI"! [-S] [--output-status] ;TI"D [--version] [--copyright] [--help] <var>grammarfile</var> ;T:@format0o:RDoc::Markup::List: @type: LABEL:@items[o:RDoc::Markup::ListItem:@label[I"+filename+;T;[o;;[I"3Racc grammar file. Any extension is permitted.;To;;[I")-o+outfile+, --output-file=+outfile+;T;[o;;[I":A filename for output. default is <+filename+>.tab.rb;To;;[I"(-O+filename+, --log-file=+filename+;T;[o;;[I".Place logging output in file +filename+. ;TI"2Default log file name is <+filename+>.output.;To;;[I"-e+rubypath+, --executable=+rubypath+;T;[o;;[I"Loutput executable file(mode 755). where +path+ is the Ruby interpreter.;To;;[I"-v, --verbose;T;[o;;[I"Lverbose mode. create +filename+.output file, like yacc's y.output file.;To;;[I"-g, --debug;T;[o;;[I"Gadd debug code to parser class. To display debugging information, ;TI"@use this '-g' option and set @yydebug true in parser class.;To;;[I"-E, --embedded;T;[o;;[I"EOutput parser which doesn't need runtime files (racc/parser.rb).;To;;[I"-C, --check-only;T;[o;;[I"0Check syntax of racc grammar file and quit.;To;;[I"-S, --output-status;T;[o;;[I"1Print messages time to time while compiling.;To;;[I"-l, --no-line-convert;T;[o;;[I"&turns off line number converting.;To;;[I"-c, --line-convert-all;T;[o;;[I">Convert line number of actions, inner, header and footer.;To;;[I"-a, --no-omit-actions;T;[o;;[I"2Call all actions, even if an action is empty.;To;;[I"--version;T;[o;;[I"!print Racc version and quit.;To;;[I"--copyright;T;[o;;[I"Print copyright and quit.;To;;[I"--help;T;[o;;[I"Print usage and quit.;T@S; ;i;I"!Generating Parser Using Racc;T@o;;[I"/To compile Racc grammar file, simply type:;T@o;;[I"$ racc parse.y ;T;0o;;[I"_This creates Ruby script file "parse.tab.y". The -o option can change the output filename.;T@S; ;i;I" Writing A Racc Grammar File;T@o;;[ I"DIf you want your own parser, you have to write a grammar file. ;TI"TA grammar file contains the name of your parser class, grammar for the parser, ;TI"#user code, and anything else. ;TI"?When writing a grammar file, yacc's knowledge is helpful. ;TI"AIf you have not used yacc before, Racc is not too difficult.;T@o;;[I")Here's an example Racc grammar file.;T@o;;[I"class Calcparser ;TI" rule ;TI"$ target: exp { print val[0] } ;TI" ;TI" exp: exp '+' exp ;TI" \| exp '' exp ;TI" \| '(' exp ')' ;TI" \| NUMBER ;TI" end ;T;0o;;[ I"-Racc grammar files resemble yacc files. ;TI")But (of course), this is Ruby code. ;TI"-yacc's $$ is the 'result', $0, $1... is ;TI"Ian array called 'val', and $-1, $-2... is an array called '_values'.;T@o;;[I"RSee the {Grammar File Reference}[rdoc-ref:lib/racc/rdoc/grammar.en.rdoc] for ;TI"'more information on grammar files.;T@S; ;i;I"Parser;T@o;;[I"JThen you must prepare the parse entry method. There are two types of ;TI"Jparse methods in Racc, Racc::Parser#do_parse and Racc::Parser#yyparse;T@o;;[I"%Racc::Parser#do_parse is simple.;T@o;;[ I"EIt's yyparse() of yacc, and Racc::Parser#next_token is yylex(). ;TI"FThis method must returns an array like [TOKENSYMBOL, ITS_VALUE]. ;TI"EOF is [false, false]. ;TI"J(TOKENSYMBOL is a Ruby symbol (taken from String#intern) by default. ;TI";If you want to change this, see the grammar reference.;T@o;;[I"=Racc::Parser#yyparse is little complicated, but useful. ;TI"WIt does not use Racc::Parser#next_token, instead it gets tokens from any iterator.;T@o;;[I":For example, <code>yyparse(obj, :scan)</code> causes ;TI"Tcalling +obj#scan+, and you can return tokens by yielding them from +obj#scan+.;T@S; ;i;I"Debugging;T@o;;[I"<When debugging, "-v" or/and the "-g" option is helpful.;T@o;;[I"."-v" creates verbose log file (.output). ;TI"&"-g" creates a "Verbose Parser". ;TI"=Verbose Parser prints the internal status when parsing. ;TI"But it's _not_ automatic. ;TI"QYou must use -g option and set +@yydebug+ to +true+ in order to get output. ;TI"/-g option only creates the verbose parser.;T@S; ;i;I" Racc reported syntax error.;T@o;;[I"!Isn't there too many "end"? ;TI".grammar of racc file is changed in v0.10.;T@o;;[I"KRacc does not use '%' mark, while yacc uses huge number of '%' marks..;T@S; ;i;I"$Racc reported "XXXX conflicts".;T@o;;[I"Try "racc -v xxxx.y". ;TI"?It causes producing racc's internal log file, xxxx.output.;T@S; ;i;I".Generated parsers does not work correctly;T@o;;[ I"Try "racc -g xxxx.y". ;TI"8This command let racc generate "debugging parser". ;TI",Then set @yydebug=true in your parser. ;TI".It produces a working log of your parser.;T@S; ;i;I"!Re-distributing Racc runtime;T@o;;[I"KA parser, which is created by Racc, requires the Racc runtime module; ;TI"racc/parser.rb.;T@o;;[I"0Ruby 1.8.x comes with Racc runtime module, ;TI"0you need NOT distribute Racc runtime files.;T@o;;[I"FIf you want to include the Racc runtime module with your parser. ;TI"+This can be done by using '-E' option:;T@o;;[I"($ racc -E -omyparser.rb myparser.y ;T;0o;;[I"EThis command creates myparser.rb which `includes' Racc runtime. ;TI"FOnly you must do is to distribute your parser file (myparser.rb).;T@o;;[I"6Note: parser.rb is LGPL, but your parser is not. ;TI")Your own parser is completely yours.;T; I"lib/racc/parser.rb;T; 0; 0; 0[�[�[�[[I" class;T[[:public[�[:protected[�[:private[�[I" instance;T[[;[�[;[�[;[�[�[U:RDoc::Context::Section[i�0o;;[�; 0; 0[@@ @ cRDoc::TopLevel

| ver. 1.4 | Github | . | PHP 8.0.30 | Génération de la page: 0 | proxy | phpinfo | Réglages