ExtUtils::ParseXS::Utilities - Online Linux Manual PageSection : 3
Updated : 2022-01-21
Source : perl v5.34.0
Note : User Contributed Perl Documentation
NAMEExtUtils::ParseXS::Utilities − Subroutines used with ExtUtils::ParseXS
SYNOPSIS​ use ExtUtils::ParseXS::Utilities qw( ​ standard_typemap_locations ​ trim_whitespace ​ C_string ​ valid_proto_string ​ process_typemaps ​ map_type ​ standard_XS_defs ​ assign_func_args ​ analyze_preprocessor_statements ​ set_cond ​ Warn ​ blurt ​ death ​ check_conditional_preprocessor_statements ​ escape_file_for_line_directive ​ report_typemap_failure ​ );
SUBROUTINESThe following functions are not considered to be part of the public interface. They are documented here for the benefit of future maintainers of this module.
standard_typemap_locations()• Purpose Provide a list of filepaths where typemap files may be found. The filepaths \*(-- relative paths to files (not just directory paths) \*(-- appear in this list in lowest-to-highest priority. The highest priority is to look in the current directory. ​ 'typemap' The second and third highest priorities are to look in the parent of the current directory and a directory called lib/ExtUtils underneath the parent directory. ​ '../typemap', ​ '../lib/ExtUtils/typemap', The fourth through ninth highest priorities are to look in the corresponding grandparent, great-grandparent and great-great-grandparent directories. ​ '../../typemap', ​ '../../lib/ExtUtils/typemap', ​ '../../../typemap', ​ '../../../lib/ExtUtils/typemap', ​ '../../../../typemap', ​ '../../../../lib/ExtUtils/typemap', The tenth and subsequent priorities are to look in directories named ​ExtUtils which are subdirectories of directories found in @INC \*(-- ​provided a file named typemap actually exists in such a directory. Example: ​ '/usr/local/lib/perl5/5.10.1/ExtUtils/typemap', However, these filepaths appear in the list returned by ​standard_typemap_locations() in reverse order, i.e., lowest-to-highest. ​ '/usr/local/lib/perl5/5.10.1/ExtUtils/typemap', ​ '../../../../lib/ExtUtils/typemap', ​ '../../../../typemap', ​ '../../../lib/ExtUtils/typemap', ​ '../../../typemap', ​ '../../lib/ExtUtils/typemap', ​ '../../typemap', ​ '../lib/ExtUtils/typemap', ​ '../typemap', ​ 'typemap' • Arguments ​ my @stl = standard_typemap_locations( \@INC ); Reference to @INC. • Return Value Array holding list of directories to be searched for typemap files.
trim_whitespace()• Purpose Perform an in-place trimming of leading and trailing whitespace from the first argument provided to the function. • Argument ​ trim_whitespace($arg); • Return Value None. Remember: this is an in-place modification of the argument.
C_string()• Purpose Escape backslashes (\) in prototype strings. • Arguments ​ $ProtoThisXSUB = C_string($_); String needing escaping. • Return Value Properly escaped string.
valid_proto_string()• Purpose Validate prototype string. • Arguments String needing checking. • Return Value Upon success, returns the same string passed as argument. Upon failure, returns 0.
process_typemaps()• Purpose Process all typemap files. • Arguments ​ my $typemaps_object = process_typemaps( $args{typemap}, $pwd ); List of two elements: typemap element from %args; current working directory. • Return Value Upon success, returns an ExtUtils::Typemaps object.
map_type()• Purpose Performs a mapping at several places inside PARAGRAPH loop. • Arguments ​ $type = map_type($self, $type, $varname); List of three arguments. • Return Value String holding augmented version of second argument.
standard_XS_defs()• Purpose Writes to the .c output file certain preprocessor directives and function headers needed in all such files. • Arguments None. • Return Value Returns true.
assign_func_args()• Purpose Perform assignment to the func_args attribute. • Arguments ​ $string = assign_func_args($self, $argsref, $class); List of three elements. Second is an array reference; third is a string. • Return Value String.
analyze_preprocessor_statements()• Purpose Within each function inside each Xsub, print to the .c output file certain preprocessor statements. • Arguments ​ ( $self, $XSS_work_idx, $BootCode_ref ) = ​ analyze_preprocessor_statements( ​ $self, $statement, $XSS_work_idx, $BootCode_ref ​ ); List of four elements. • Return Value Modifed values of three of the arguments passed to the function. In particular, the XSStack and InitFileCode attributes are modified.
set_cond()• Purpose • Arguments • Return Value
current_line_number()• Purpose Figures out the current line number in the XS file. • Arguments ​$self • Return Value The current line number.
Warn()• Purpose • Arguments • Return Value
blurt()• Purpose • Arguments • Return Value
death()• Purpose • Arguments • Return Value
check_conditional_preprocessor_statements()• Purpose • Arguments • Return Value
escape_file_for_line_directive()• Purpose Escapes a given code source name (typically a file name but can also be a command that was read from) so that double-quotes and backslashes are escaped. • Arguments A string. • Return Value A string with escapes for double-quotes and backslashes.
report_typemap_failure• Purpose Do error reporting for missing typemaps. • Arguments The ExtUtils::ParseXS object. An ExtUtils::Typemaps object. The string that represents the C type that was not found in the typemap. Optionally, the string death or blurt to choose whether the error is immediately fatal or not. Default: blurt • Return Value Returns nothing. Depending on the arguments, this may call death or blurt, the former of which is fatal. 0
Johanes Gumabo
Data Size   :   31,511 byte
man-ExtUtils::ParseXS::Utilities.3pmBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   5 / 188,932
Visitor ID   :     :  
Visitor IP   :   18.224.44.233   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.
ERROR : Need New Coding :         (parse_manual_page_|249|ExtUtils::ParseXS::Utilities.3pm|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\| )         (htmlprn|149|ExtUtils::ParseXS::Utilities.3pm|36/37|.el══─{─══. ds --  —  |.el══─{─══. ds -- \|\(em\| )         (parse_manual_page_|249|ExtUtils::ParseXS::Utilities.3pm|43|br══─}─══|'br══─}─══ )         (htmlprn|149|ExtUtils::ParseXS::Utilities.3pm|43|'br══─}─══ |'br══─}─══ )         (rof_escape_sequence|91|ExtUtils::ParseXS::Utilities.3pm|114|\*(-- relative paths to files (not just directory paths) \*(-- appear in this list in lowest-to-highest priority. |filepaths \*(-- relative paths to files (not just directory paths) \*(-- appear in this list in lowest-to-highest priority. )         (rof_escape_sequence|91|ExtUtils::ParseXS::Utilities.3pm|144|\*(-- |\&\fIExtUtils\fR which are subdirectories of directories found in \f(CW@INC\fR \*(-- )