web2py.gluon.validators.IS_MATCH

Package web2py :: Package gluon :: Module validators :: Class IS_MATCH |
[hide private]
[frames] | no frames]

# Class IS_MATCH

source code

    object --+
             |
     Validator --+
                 |
                IS_MATCH

Known Subclasses:
  IS_ALPHANUMERIC

example:

       INPUT(_type='text', _name='name', requires=IS_MATCH('.+'))

the argument of IS_MATCH is a regular expression:

       >>> IS_MATCH('.+')('hello')
       ('hello', None)

       >>> IS_MATCH('hell')('hello')
       ('hello', 'invalid expression')

       >>> IS_MATCH('hell.*', strict=False)('hello')
       ('hello', None)

       >>> IS_MATCH('hello')('shello')
       ('shello', 'invalid expression')

       >>> IS_MATCH('hello', search=True)('shello')
       ('hello', None)

       >>> IS_MATCH('hello', search=True, strict=False)('shellox')
       ('hello', None)

       >>> IS_MATCH('.*hello.*', search=True, strict=False)('shellox')
       ('shellox', None)

       >>> IS_MATCH('.+')('')
       ('', 'invalid expression')

Instance Methods | [hide private]
__init__(self, expression, error_message=`'``invalid expression``'`, strict=True, search=True, extract=True) x.__init__(...) initializes x; see x.__class__.__doc__ for signature | source code
__call__(self, value) | source code
Inherited from `Validator`: `formatter` Inherited from `object`: `__delattr__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__repr__`, `__setattr__`, `__str__`

Properties | [hide private]
Inherited from `object`: `__class__`

Method Details | [hide private]

### __init__(self, expression, error_message=`'``invalid expression``'`, strict=True, search=True, extract=True) (Constructor) | source code
x.__init__(...) initializes x; see x.__class__.__doc__ for signature Overrides: object.__init__ (inherited documentation)