NAME
SPVM::Builder::Config - Configurations of Compile and Link of Native Sources
DESCRIPTION
SPVM::Builder::Config is configuration of c/c++ compile and link.
FIELDS
Fields.
ext
my
$ext
=
$config
->ext;
$config
->ext(
$ext
);
Get and set the extension of native sources. This is used by the compiler.
The default is undef
.
Examples:
$config
->ext(
'c'
);
$config
->ext(
'cpp'
);
cc
my
$cc
=
$config
->cc;
$config
->cc(
$cc
);
Get and set a compiler. The default is the value of cc
of Config module.
include_dirs
my
$include_dirs
=
$config
->include_dirs;
$config
->include_dirs(
$include_dirs
);
Get and set header including directories of the compiler. This is same as -I
option of gcc
.
The default value is "SPVM/Builder/include" of one up of directory that SPVM::Buidler::Config.pm is loaded.
At runtime, the "include" directory of the native module is added before include_dirs
.
ccflags
my
$ccflags
=
$config
->ccflags;
$config
->ccflags(
$ccflags
);
Get and set compiler flags. the default is a empty string.
optimize
my
$optimize
=
$config
->optimize;
$config
->optimize(
$optimize
);
Get and set the option for optimization of the compiler.
The default is -O3
.
Examples:
$config
->optimize(
'-O3'
);
$config
->optimize(
'-O2'
);
$config
->optimize(
'-g3 -O0'
);
sources
my
$sources
=
$config
->sources;
$config
->sources(
$sources
);
Get and get source files. These sourceraries are linked by the compiler.
Examples:
$config
->sources([
'foo.c'
,
'bar.c'
]);
ld
my
$ld
=
$config
->ld;
$config
->ld(
$ld
);
Get and set a linker. Default is ld
of Config module.
lib_dirs
my
$lib_dirs
=
$config
->lib_dirs;
$config
->lib_dirs(
$lib_dirs
);
Get and set the directories libraries are searched for by the linker. This is same as -L
option of gcc
.
Default:
Windows
The directory that perlxxx.dll
exists
Not Windows
empty list
At runtime, the "lib" directory of the native module is added before include_dirs
.
exported_funcs
my
$exported_funcs
=
$config
->exported_funcs;
$config
->exported_funcs(
$exported_funcs
);
Get and set the exported functions. This has means on Windows.
libs
my
$libs
=
$config
->libs;
$config
->libs(
$libs
);
Get and set libraries. These libraries are linked by the linker.
If a dynamic link library is found from "lib_dirs", this is linked. Otherwise if a static link library is found from "lib_dirs", this is linked.
Examples:
$config
->libs([
'gsl'
,
'png'
]);
If you want to link only dynamic link library, you can use the following hash reference as the value of the element instead of the library name.
{
type
=>
'dynamic'
,
name
=>
'gsl'
}
If you want to link only static link library, you can use the following hash reference as the value of the element instead of the library name.
{
type
=>
'static'
,
name
=>
'gsl'
}
resources
my
$resources
=
$config
->resources;
$config
->resources(
$resources
);
Get and get resouce module names.
At runtime, each modules' native "include" directory is added before include_dirs
, and "lib" directory is added before lib_dirs
.
E<Examples:>
$config
->resources([
'SPVM::Resouce::Zlib::V1_15'
]);
ldflags
my
ldflags =
$config
->ldflags;
$config
->ldflags(ldflags);
Get and set linker flags.
Default:
Windows
"-mdll -s"
Non-Windows
"-shared"
ld_optimize
my
$ld_optimize
=
$config
->ld_optimize;
$config
->ld_optimize(
$ld_optimize
);
Get and set the option for optimization of the linker such as -O3
, -O2
, -g3 -O0
.
The default is -O2
.
force
my
$force
=
$config
->force;
$config
->force(
$force
);
Get and set the flag to force compiles and links without caching.
quiet
my
$quiet
=
$config
->quiet;
$config
->quiet(
$quiet
);
Get and set the flag if the compiler and the linker output the results.
The default is 1
.
Methods
new
my
$config
= SPVM::Builder::Config->new;
Create SPVM::Builder::Config object.
new_c
my
$config
= SPVM::Builder::Config->new_c;
Create default build config with C settings. This is SPVM::Builder::Config object.
If you want to use the specific C version, use set_std
method.
$config
->set_std(
'c99'
);
new_c99
my
$config
= SPVM::Builder::Config->new_c99;
Create default build config with C99 settings. This is SPVM::Builder::Config object.
new_cpp
my
$config
= SPVM::Builder::Config->new_cpp;
Create default build config with C++ settings. This is SPVM::Builder::Config object.
If you want to use the specific C++ version, use set_std
method.
$config
->set_std(
'c++11'
);
new_cpp11
my
$config
= SPVM::Builder::Config->new_cpp11;
Create default build config with C++11 settings. This is SPVM::Builder::Config object.
set_std
$config
->set_std(
$std
);
Add the value that is converted to -std=$std
after the last element of ccflags
field.
Example:
$config
->set_std(
'gnu99'
);
add_ccflags
$config
->add_ccflags(
@ccflags
);
Add values after the last element of ccflags
field.
add_ldflags
$config
->add_ldflags(
@ldflags
);
Add values after the last element of ldflags
field.
add_include_dirs
$config
->add_include_dirs(
@include_dirs
);
Add values after the last element of include_dirs
field.
add_lib_dirs
$config
->add_lib_dirs(
@lib_dirs
);
Add values after the last element of lib_dirs
field.
add_sources
$config
->add_sources(
@sources
);
Add the values after the last element of sources
field.
add_exported_funcs
$config
->add_exported_funcs(
@exported_funcs
);
Add values after the last element of exported_funcs
field.
add_libs
$config
->add_libs(
@libs
);
Add the values after the last element of libs
field.
Examples:
$config
->add_libs(
'gsl'
);
add_static_libs
$config
->add_static_libs(
@libs
);
Add the values that each element is converted to the following hash reference after the last element of libs
field.
{
type
=>
'static'
,
name
=>
$lib
}
Examples:
$config
->add_static_libs(
'gsl'
);
add_dynamic_libs
$config
->add_dynamic_libs(
@libs
);
Add the values that each element is converted to the following hash reference after the last element of libs
field.
{
type
=>
'dynamic'
,
name
=>
$lib
}
Examples:
$config
->add_dynamic_libs(
'gsl'
);
add_resources
$config
->add_resources(
@resources
);
Add the values after the last element of resources
field.
Examples:
$config
->add_resources(
'SPVM::Resouce::Zlib::V1_15'
);
to_hash
my
$config
=
$config
->to_hash;
Convert SPVM::Builder::Config to a hash reference.
search_lib_dirs_from_cc_info
my
$lib_dirs
=
$config
->search_lib_dirs_from_cc_info;
Get the library searching directories parsing the infomation the compiler has.
search_lib_dirs_from_config_libpth
my
$lib_dirs
=
$config
->search_lib_dirs_from_config_libpth;
Get the library searching directories parsing libpth
of Config.
search_include_dirs_from_config_incpth
my
$include_dirs
=
$config
->search_include_dirs_from_config_incpth;
Get the header searching directories parsing incpth
of Config.
sub get_include_dir
my
$include_dir
=
$config
->get_include_dir(__FILE__);
Get the header include directory from the config file name.
get_src_dir
my
$src_dir
=
$config
->get_src_dir(__FILE__);
Get the source directory from the config file name.
get_lib_dir
my
$lib_dir
=
$config
->get_lib_dir(__FILE__);
Get the library directory from the config file name.
1 POD Error
The following errors were encountered while parsing the POD:
- Around line 640:
Unknown E content in E<Examples:>