- SEE ALSO
- COPYRIGHT AND LICENSE
FFI::Platypus::Memory - Memory functions for FFI
use FFI::Platypus::Memory; # allocate 64 bytes of memory using the # libc malloc function. my $pointer = malloc 64; # use that memory wisely ... # free the memory when you are done. free $pointer;
This module provides an interface to common memory functions provided by the standard C library. They may be useful when constructing interfaces to C libraries with FFI. It works mostly with the
opaque type and it is worth reviewing the section on opaque pointers in FFI::Platypus::Type.
my $pointer = calloc $count, $size;
calloc function contiguously allocates enough space for $count objects that are $size bytes of memory each.
free function frees the memory allocated by
strdup. It is important to only free memory that you yourself have allocated. A good way to crash your program is to try and free a pointer that some C library has returned to you.
my $pointer = malloc $size;
malloc function allocates $size bytes of memory.
memcpy $dst_pointer, $src_pointer, $size;
memcpy function copies $size bytes from $src_pointer to $dst_pointer. It also returns $dst_pointer.
memset $buffer, $value, $length;
memset function writes $length bytes of $value to the address specified by $buffer.
my $new_pointer = realloc $old_pointer, $size;
realloc function reallocates enough memory to fit $size bytes. It copies the existing data and frees $old_pointer.
If you pass
undef in as $old_pointer, then it behaves exactly like
my $pointer = realloc undef, 64; # same as malloc 64
strcpy $opaque, $string;
Copies the string to the memory location pointed to by
my $pointer = strdup $string;
strdup function allocates enough memory to contain $string and then copies it to that newly allocated memory. This version of
strdup returns an opaque pointer type, not a string type. This may seem a little strange, but returning a string type would not be very useful in Perl.
my $pointer = strndup $string, $max;
The same as
strdup above, except at most
$max characters will be copied in the new string.
Main Platypus documentation.
Author: Graham Ollis <firstname.lastname@example.org>
Bakkiaraj Murugesan (bakkiaraj)
Dylan Cali (calid)
Zaki Mughal (zmughal)
Fitz Elliott (felliott)
Vickenty Fesunov (vyf)
Gregor Herrmann (gregoa)
Shlomi Fish (shlomif)
Ilya Pavlov (Ilya33)
Petr Pisar (ppisar)
Mohammad S Anwar (MANWAR)
Håkon Hægland (hakonhagland, HAKONH)
Meredith (merrilymeredith, MHOWARD)
Diab Jerius (DJERIUS)
This software is copyright (c) 2015,2016,2017,2018,2019,2020 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.