NAME

Regexp::Common::whitespace -- provides a regex for leading or trailing whitescape

SYNOPSIS

use Regexp::Common qw /whitespace/;

while (<>) {
    s/$RE{ws}{crop}//g;           # Delete surrounding whitespace
}

DESCRIPTION

Please consult the manual of Regexp::Common for a general description of the works of this interface.

Do not use this module directly, but load it via Regexp::Common.

$RE{ws}{crop}

Returns a pattern that identifies leading or trailing whitespace.

For example:

$str =~ s/$RE{ws}{crop}//g;     # Delete surrounding whitespace

The call:

$RE{ws}{crop}->subs($str);

is optimized (but probably still slower than doing the s///g explicitly).

This pattern does not capture under -keep.

HISTORY

$Log: whitespace.pm,v $
Revision 1.2  2002/08/27 16:59:39  abigail
Fix POD

Revision 1.1  2002/08/27 16:58:59  abigail
Initial checkin.

SEE ALSO

Regexp::Common for a general description of how to use this interface.

AUTHOR

Damian Conway (damian@conway.org)

MAINTAINANCE

This package is maintained by Abigail (regexp-common@abigail.nl).

BUGS AND IRRITATIONS

Bound to be plenty.

For a start, there are many common regexes missing. Send them in to regexp-common@abigail.nl.

COPYRIGHT

Copyright (c) 2001 - 2002, Damian Conway. All Rights Reserved.
  This module is free software. It may be used, redistributed
 and/or modified under the terms of the Perl Artistic License
       (see http://www.perl.com/perl/misc/Artistic.html)