.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "FFI::Platypus::Type::StringArray 3pm" .TH FFI::Platypus::Type::StringArray 3pm "2019-02-13" "perl v5.28.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" FFI::Platypus::Type::StringArray \- Platypus custom type for arrays of strings .SH "VERSION" .IX Header "VERSION" version 0.83 .SH "SYNOPSIS" .IX Header "SYNOPSIS" In your C code: .PP .Vb 5 \& void \& takes_string_array(const char **array) \& { \& ... \& } \& \& void \& takes_fixed_string_array(const char *array[5]) \& { \& ... \& } .Ve .PP In your Platypus::FFI code: .PP .Vb 1 \& use FFI::Platypus; \& \& my $ffi = FFI::Platypus\->new; \& $ffi\->load_custom_type(\*(Aq::StringArray\*(Aq => \*(Aqstring_array\*(Aq); \& $ffi\->load_custom_type(\*(Aq::StringArray\*(Aq => \*(Aqstring_5\*(Aq => 5); \& \& $ffi\->attach(takes_string_array => [\*(Aqstring_array\*(Aq] => \*(Aqvoid\*(Aq); \& $ffi\->attach(takes_fixed_string_array => [\*(Aqstring_5\*(Aq] => \*(Aqvoid\*(Aq); \& \& my @list = qw( foo bar baz ); \& \& takes_string_array(\e@list); \& takes_fixed_string_array([qw( s1 s2 s3 s4 s5 )]); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fB\s-1NOTE\s0\fR: The primary motivation for this custom type was originally to fill the void left by the fact that FFI::Platypus did not support arrays of strings by itself. Since 0.62 this support has been added, and that is probably what you want to use, but the semantics and feature set are slightly different, so there are cases where you might want to use this custom type. .PP This module provides a FFI::Platypus custom type for arrays of strings. The array is always \s-1NULL\s0 terminated. Return types are supported! .PP This custom type takes two optional arguments. The first is the size of arrays and the second is a default value to fill in any values that aren't provided when the function is called. If not default is provided then \f(CW\*(C`NULL\*(C'\fR will be passed in for those values. .SH "SUPPORT" .IX Header "SUPPORT" If something does not work the way you think it should, or if you have a feature request, please open an issue on this project's GitHub Issue tracker: .PP .SH "CONTRIBUTING" .IX Header "CONTRIBUTING" If you have implemented a new feature or fixed a bug then you may make a pull request on this project's GitHub repository: .PP .PP This project's GitHub issue tracker listed above is not Write-Only. If you want to contribute then feel free to browse through the existing issues and see if there is something you feel you might be good at and take a whack at the problem. I frequently open issues myself that I hope will be accomplished by someone in the future but do not have time to immediately implement myself. .PP Another good area to help out in is documentation. I try to make sure that there is good document coverage, that is there should be documentation describing all the public features and warnings about common pitfalls, but an outsider's or alternate view point on such things would be welcome; if you see something confusing or lacks sufficient detail I encourage documentation only pull requests to improve things. .SH "SEE ALSO" .IX Header "SEE ALSO" .IP "FFI::Platypus" 4 .IX Item "FFI::Platypus" .PD 0 .IP "FFI::Platypus::Type::StringPointer" 4 .IX Item "FFI::Platypus::Type::StringPointer" .PD .SH "AUTHOR" .IX Header "AUTHOR" Author: Graham Ollis .PP Contributors: .PP Bakkiaraj Murugesan (bakkiaraj) .PP Dylan Cali (calid) .PP pipcet .PP Zaki Mughal (zmughal) .PP Fitz Elliott (felliott) .PP Vickenty Fesunov (vyf) .PP Gregor Herrmann (gregoa) .PP Shlomi Fish (shlomif) .PP Damyan Ivanov .PP Ilya Pavlov (Ilya33) .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" This software is copyright (c) 2015,2016,2017,2018,2019 by Graham Ollis. .PP This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.