1 
Ctypes
2 





3

Call and wrap native C functions and libraries from Perl, using only





4

Perl.





5






6

Ctypes (current v0.003) is based on libffi to provide a way of calling





7

native C library functions directly from Perl, using only Perl, and





8

hence not requiring a compiler.





9






10

Of course, the Ctypes module itself is written with XS, so you need 





11

a compiler to install this module from source.





12

Orperhaps (wonder of wonders) it could someday be rolled into Perl5 core?





13






14

This module requires the C library libffi to run. If you're on a POSIX





15

system, libffi should have been installed this via your favoured package





16

manager, otherwise we will build and install it for you into /usr/local. 





17

If you're on Win32 there are pre-compiled libffi binaries included.





18






19

http://sourceware.org/libffi/





20






21

INSTALLATION





22






23

This module uses ExtUtils::ModuleMaker because I couldn't see how to





24

get Module::Build to compile stuff the way I wanted. Module::Install





25

is currently still a bit limited for this fancy stuff too. So what





26

you do is:





27






28

	perl Makefile.PL [INCDIR=libffi-include-path LIBDIR=libffi-lib-path]





29

	make





30

	make test





31

	make install





32






33

SUPPORT AND DOCUMENTATION





34






35

After installing, you can find documentation for this module with the





36

perldoc command.





37






38

    perldoc Ctypes





39






40

You can also look for information at:





41






42

    RT, CPAN's request tracker





43

        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Ctypes





44






45

    AnnoCPAN, Annotated CPAN documentation





46

        http://annocpan.org/dist/Ctypes





47






48

    CPAN Ratings





49

        http://cpanratings.perl.org/d/Ctypes





50






51

    Search CPAN





52

        http://search.cpan.org/dist/Ctypes/





53






54






55

LICENSE AND COPYRIGHT





56






57

Copyright (c) 2010 Ryan Jendoubi





58






59

This program is free software; you can redistribute it and/or modify it





60

under the terms of the Artistic License 2.0. 





61

See http://www.opensource.org/licenses/artistic-license-2.0.php for





62

more information.





63






64

Some code has been copied or adapted whole or in part from Python 2.7





65

source code. Those sections of code are Copyright (c) 2001, 2002, 2003,





66

2004, 2005, 2006 Python Software Foundation; All Rights Reserved, and





67

released under the Python Software Foundation License Verion 2. See the





68

LICENSES document for more details.