manpagez: man pages & more
man Perl::Critic::Policy::InputOutput::RequireCheckedClose(3)
Home | html | info | man
Perl::Critic::Policy::InputOutput::RequireCheckedClose(3)



NAME

       Perl::Critic::Policy::InputOutput::RequireCheckedClose - Write "my
       $error = close $fh;" instead of "close $fh;".


AFFILIATION

       This Policy is part of the core Perl::Critic distribution.


DESCRIPTION

       The perl builtin I/O function "close" returns a false value on failure.
       That value should be checked to ensure that the close was successful.

           my $error = close $filehandle;                   # ok
           close $filehandle or die "unable to close: $!";  # ok
           close $filehandle;                               # not ok

           use autodie qw< :io >;
           close $filehandle;                               # ok

       You can use autodie, Fatal, or Fatal::Exception to get around this.
       Currently, autodie is not properly treated as a pragma; its lexical
       effects aren't taken into account.


CONFIGURATION

       If you create a module that exports "autodie" you can tell this policy
       about it with the "autodie_modules" setting:

           [InputOutput::RequireCheckedSyscalls]
           autodie_modules = My::Thing


AUTHOR

       Andrew Moore <amoore@mooresystems.com>


ACKNOWLEDGMENTS

       This policy module is based heavily on policies written by Jeffrey Ryan
       Thalhammer <jeff@imaginative-software.com>.


COPYRIGHT

       Copyright (c) 2007-2011 Andrew Moore.  All rights reserved.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.  The full text of this license can
       be found in the LICENSE file included with this module.




perl v5.28.2         Perl::Critic::Policy::InputOutput::RequireCheckedClose(3)

perl-critic 1.134.0 - Generated Mon Jun 3 13:04:55 CDT 2019
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.