GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CARP::DATUM::STRIP (3)

.ds Aq ’

NAME

Carp::Datum::Strip - strips most Carp::Datum calls lexically

CONTENTS

SYNOPSIS



 use Carp::Datum::Strip qw(datum_strip);

 datum_strip("-", "-");
 datum_strip($file, "$file.new", ".bak");



DESCRIPTION

This module exports a single routine, datum_strip(), whose purpose is to remove calls to Carp::Datum routines lexically.

Because stripping is done lexically, there are some restrictions about what is actually supported. Unless the conventions documented in Carp::Datum are followed, stripping will be incorrect.

The general guidelines are:
o Do not use here documents or generalized quotes (qq) within assertion expression or tags. Write assertions using ’’ or "", as appropriate.
o Assertions can be safely put on several lines, but must end with a semi-colon, outside any string.
There are two calls that will never be stripped: VERIFY() and DTRACE(). The VERIFY() is meant to be preserved (or DREQUIRE would have been used). DTRACE, when called, will be remapped dynamically to some Log::Agent routine, depending on the trace level. See Carp::Datum for details.

INTERFACE

The interface of the datum_strip() routine is:
datum_strip old_file, new_file, [ext] The old_file specifies the old file path, the one to be stripped. The stripped version will be written to new_file.

If the optional third argument ext is given (e.g. .bak), then old_file will be renamed with the supplied extension, and new_file will be renamed old_file. Renaming only occurs if stripping was successful (i.e. the new file was correctly written to disk).

The lowest nine rwx mode bits from old_file are preserved when creating new_file.

Both old_file and new_file can be set to -, in which case STDIN and STDOUT are used, respectively, and no renaming can occur, nor any mode bit propagation.

Returns true on success, undef on error.

AUTHORS

Christophe Dehaudt and Raphael Manfredi are the original authors.

Send bug reports, hints, tips, suggestions to Dave Hoover at <squirrel@cpan.org>.

SEE ALSO

Carp::Datum(3).
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DATUM::STRIP (3) 2002-01-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.