Name

SPVM::Builder::LibInfo - Library Information

Description

The SPVM::Builder::LibInfo class has methods to manipulate library information.

Usage

my $lib_info = SPVM::Builder::LibInfo->new(%fields);
my $lib_arg = $lib_info->to_arg;

Fields

name

my $name = $lib_info->name;
$lib_info->name($name);

Gets and sets the name field.

This field is a library name.

Examples:

$lib_info->name('z');

$lib_info->name('png');

file

my $file = $lib_info->file;
$lib_info->file($file);

Gets and sets the file field.

This field is the absolute path of the library file like /path/libz.so, /path/libpng.a.

is_static

my $is_static = $lib_info->is_static;
$lib_info->is_static($is_static);

Gets and sets the is_static field.

If this field is a true value, a static library is linked.

is_abs

my $is_abs = $lib_info->is_abs;
$lib_info->is_abs($is_abs);

Gets and sets the is_abs field.

If this field is a true value, the library is linked by the library name like -lfoo.

Otherwise the library is linked by the absolute path of the library like /path/libfoo.so.

static_option_cb

my $static_option_cb = $lib_info->static_option_cb;
$lib_info->static_option_cb($static_option_cb);

Gets and sets the static_option_cb field.

This field is the callback to create a linker option to link a static library.

Class Methods

new

my $lib_info = SPVM::Builder::LibInfo->new(%fields);

Creates a SPVM::Builder::LibInfo object with "Fields".

Default Field Values:

If a field is not defined, the field is set to the following default value.

• "name"

  undef

• "file"

  undef

• "is_static"

  0

• "is_abs"

  0

• "static_option_cb"

  sub {
    my ($self, $name) = @_;
    
    $name = "-Wl,-Bstatic -l$name -Wl,-Bdynamic";
    
    return $name;
  };

Instance Methods

to_arg

my $link_command_arg = $lib_info->to_arg;

Creates an argument of the link command from the "is_abs" field and "is_static" field, and returns it.

The following ones are examples of the return value.

-lfoo
-Wl,-Bstatic -lfoo -Wl,-Bdynamic
/path/foo.so
/path/foo.a

to_string

my $lib_name = $lib_info->to_string;

Returns the "name" field.

Operators

Overloads the following operators.

bool

my $bool = !!$lib_info;

Always true.

stringify

my $lib_name = "$lib_info";

Alias for the "to_string" method.

Copyright & License

Copyright (c) 2023 Yuki Kimoto

MIT License

cpanm SPVM

perl -MCPAN -e shell
install SPVM