📄 protoent.pm
字号:
package Net::protoent;use strict;use 5.006_001;our $VERSION = '1.00';our(@EXPORT, @EXPORT_OK, %EXPORT_TAGS);BEGIN { use Exporter (); @EXPORT = qw(getprotobyname getprotobynumber getprotoent getproto); @EXPORT_OK = qw( $p_name @p_aliases $p_proto ); %EXPORT_TAGS = ( FIELDS => [ @EXPORT_OK, @EXPORT ] );}use vars @EXPORT_OK;# Class::Struct forbids use of @ISAsub import { goto &Exporter::import }use Class::Struct qw(struct);struct 'Net::protoent' => [ name => '$', aliases => '@', proto => '$',];sub populate (@) { return unless @_; my $pob = new(); $p_name = $pob->[0] = $_[0]; @p_aliases = @{ $pob->[1] } = split ' ', $_[1]; $p_proto = $pob->[2] = $_[2]; return $pob;} sub getprotoent ( ) { populate(CORE::getprotoent()) } sub getprotobyname ($) { populate(CORE::getprotobyname(shift)) } sub getprotobynumber ($) { populate(CORE::getprotobynumber(shift)) } sub getproto ($;$) { no strict 'refs'; return &{'getprotoby' . ($_[0]=~/^\d+$/ ? 'number' : 'name')}(@_);}1;__END__=head1 NAMENet::protoent - by-name interface to Perl's built-in getproto*() functions=head1 SYNOPSIS use Net::protoent; $p = getprotobyname(shift || 'tcp') || die "no proto"; printf "proto for %s is %d, aliases are %s\n", $p->name, $p->proto, "@{$p->aliases}"; use Net::protoent qw(:FIELDS); getprotobyname(shift || 'tcp') || die "no proto"; print "proto for $p_name is $p_proto, aliases are @p_aliases\n";=head1 DESCRIPTIONThis module's default exports override the core getprotoent(),getprotobyname(), and getnetbyport() functions, replacing them withversions that return "Net::protoent" objects. They take defaultsecond arguments of "tcp". This object has methods that return thesimilarly named structure field name from the C's protoent structurefrom F<netdb.h>; namely name, aliases, and proto. The aliases methodreturns an array reference, the rest scalars.You may also import all the structure fields directly into your namespaceas regular variables using the :FIELDS import tag. (Note that this stilloverrides your core functions.) Access these fields as variables namedwith a preceding C<p_>. Thus, C<$proto_obj-E<gt>name()> corresponds to$p_name if you import the fields. Array references are available asregular array variables, so for example C<@{ $proto_obj-E<gt>aliases()}> would be simply @p_aliases.The getproto() function is a simple front-end that forwards a numericargument to getprotobyport(), and the rest to getprotobyname().To access this functionality without the core overrides,pass the C<use> an empty import list, and then accessfunction functions with their full qualified names.On the other hand, the built-ins are still availablevia the C<CORE::> pseudo-package.=head1 NOTEWhile this class is currently implemented using the Class::Structmodule to build a struct-like class, you shouldn't rely upon this.=head1 AUTHORTom Christiansen
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -