.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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.  | will give a
.\" real vertical bar.  \*(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-|\(bv\*(Tr
.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" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Text::Query::Build 3"
.TH Text::Query::Build 3 "1999-06-19" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
Text::Query::Build \- Base class for query builders
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&    package Text::Query::BuildMy;
.Ve
.PP
.Vb 1
\&    use Text::Query::Build;
.Ve
.PP
.Vb 1
\&    use vars qw(@ISA);
.Ve
.PP
.Vb 1
\&    @ISA = qw(Text::Query::Build);
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module provides a virtual base class for query builders.
.PP
Query builders are called by the parser logic. A given set of functions is
provided by the builder to match a Boolean logic.
All the methods return a scalar corresponding to the code that performs 
the specified options.
.PP
Parameters Q1 and Q2 are the same type of scalar as the return values.
.SH "METHODS"
.IX Header "METHODS"
.IP "\fImatchstring()\fR" 4
.IX Item "matchstring()"
Return a string that represent the last built expression. Two identical expressions
should generate the same string. This is for testing purpose.
.SH "CODE-GENERATION METHODS"
.IX Header "CODE-GENERATION METHODS"
.IP "\fIbuild_init()\fR" 4
.IX Item "build_init()"
Called before building the expression. A chance to initialize object data.
.IP "build_final_expression(Q1)" 4
.IX Item "build_final_expression(Q1)"
Does any final processing to generate code to match a top-level expression.  
The return value is \s-1NOT\s0 necessarily of a type that can be passed to 
the other code-generation methods.
.IP "build_expression(Q1,Q2)" 4
.IX Item "build_expression(Q1,Q2)"
Generate code to match \f(CW\*(C`Q1\*(C'\fR \s-1OR\s0 \f(CW\*(C`Q2\*(C'\fR
.IP "build_expression_finish(Q1)" 4
.IX Item "build_expression_finish(Q1)"
Generate any code needed to enclose an expression. 
.IP "build_conj(Q1,Q2,F)" 4
.IX Item "build_conj(Q1,Q2,F)"
Generate code needed to match \f(CW\*(C`Q1\*(C'\fR \s-1AND\s0 \f(CW\*(C`Q2\*(C'\fR.  F will be true if this is the first 
time this method is called in a sequence of several conjunctions.
.IP "build_near(Q1,Q2)" 4
.IX Item "build_near(Q1,Q2)"
Generate code needed to match \f(CW\*(C`Q1\*(C'\fR \s-1NEAR\s0 \f(CW\*(C`Q2\*(C'\fR.
.IP "build_concat(Q1,Q2)" 4
.IX Item "build_concat(Q1,Q2)"
Generate code needed to match \f(CW\*(C`Q1\*(C'\fR immediately followed by \f(CW\*(C`Q2\*(C'\fR.
.IP "build_negation(Q1)" 4
.IX Item "build_negation(Q1)"
Generate code needed to match \s-1NOT\s0 \f(CW\*(C`Q1\*(C'\fR.
.IP "build_literal(Q1)" 4
.IX Item "build_literal(Q1)"
Generate code to match \f(CW\*(C`Q1\*(C'\fR as a literal.
.IP "build_scope_start($scope)" 4
.IX Item "build_scope_start($scope)"
Generate code to enter in the \f(CW$scope\fR query context.
.IP "build_scope_end($scope,Q1)" 4
.IX Item "build_scope_end($scope,Q1)"
Generate code needed to match \f(CW\*(C`Q1\*(C'\fR in the \f(CW$scope\fR context.
.IP "build_mandatory(Q1)" 4
.IX Item "build_mandatory(Q1)"
Generate code to match \f(CW\*(C`Q1\*(C'\fR (think + in AltaVista syntax).
.IP "build_forbiden(Q1)" 4
.IX Item "build_forbiden(Q1)"
Generate code to match \s-1NOT\s0 \f(CW\*(C`Q1\*(C'\fR (think \- in AltaVista syntax).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIText::Query\fR\|(3)
.SH "AUTHORS"
.IX Header "AUTHORS"
Eric Bohlman (ebohlman@netcom.com)
.PP
Loic Dachary (loic@senga.org)