Class ParseExpression

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__

(inherited documentation)

Extends leaveWhitespace defined in base class, and also invokes leaveWhitespace on all contained expressions.

Overrides: ParserElement.leaveWhitespace

Define expression to be ignored (e.g., comments) while doing pattern matching; may be called repeatedly, to define multiple comment or other ignorable patterns.

Example:

   patt = OneOrMore(Word(alphas))
   patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
   
   patt.ignore(cStyleComment)
   patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']

Overrides: ParserElement.ignore

(inherited documentation)

str(x)

Overrides: object.__str__

(inherited documentation)

Overrides: ParserElement.streamline

Define name for referencing matching tokens as a nested attribute of the returned parse results. NOTE: this returns a *copy* of the original ParserElement object; this is so that the client can define a basic element, such as an integer, and reference it in multiple places with different names.

You can also set results names using the abbreviated syntax, expr("name") in place of expr.setResultsName("name") - see __call__.

Example:

   date_str = (integer.setResultsName("year") + '/' 
               + integer.setResultsName("month") + '/' 
               + integer.setResultsName("day"))

   # equivalent form:
   date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

Overrides: ParserElement.setResultsName

(inherited documentation)

Check defined expressions for valid structure, check for infinite recursive definitions.

Overrides: ParserElement.validate

(inherited documentation)

Make a copy of this ParserElement. Useful for defining different parse actions for the same parsing pattern, using copies of the original parse element.

Example:

   integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
   integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
   integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
   
   print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))

prints:

   [5120, 100, 655360, 268435456]

Equivalent form of expr.copy() is just expr():

   integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")

Overrides: ParserElement.copy

(inherited documentation)