NAME
FFI::Platypus::Record::StringArray - Array of strings for your FFI record
VERSION
version 0.01
SYNOPSIS
my $a = FFI::Platypus::Record::StringArray->new(qw( foo bar baz ));
my $opaque = $a->opaque;
DESCRIPTION
Experimental interface for an array of C strings, useful for FFI record classes.
The Platypus record class doesn't easily support an array of strings, and trying to use an opaque
type to implement this is possible but more than a little arcane. This class provides an interface for creating a C array of strings which can be used to provide an opaque
pointer than can be used by an FFI::Platypus::Record object.
Care needs to be taken! Because Perl has no way of knowing if/when the opaque pointer is no longer being used by C, you have to make sure that the FFI::Platypus::Record::StringArray instance remains in scope for as long as the opaque
pointer is in use by C.
CONSTRUCTOR
new
my $a = FFI::Platypus::Record::StringArray->new(@a);
Creates a new array of C strings.
METHODS
opaque
my $opaque = $a->opaque;
Returns the opaque pointer to the array of C strings.
size
my $size = $a->size;
Returns the number of elements in the array of C strings.
element
my $element = $a->element($index);
Returns the string in the array of C strings at the given index.
AUTHOR
Graham Ollis <plicease@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2019 by Graham Ollis.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.