NAME

C::Blocks::PerlAPI - C interface for interacting with Perl

SYNOPSIS

use strict;
use warnings;
use C::Blocks;
use C::Blocks::PerlAPI;

cshare {
    void say_hi() {
        PerlIO_stdoutf("hi!");
    }
}

DESCRIPTION

This C::Blocks module provides access to the Perl C library. It is roughly equivalent to including these lines at the top of your cblocks:

#define PERL_NO_GET_CONTEXT
#include "EXTERN.h"
#include "perl.h"
#include "XSUB.h"

as well as linking to libperl. Of course, as a C::Blocks module, it also avoids the re-parsing necessary if you were to include those at the top of each of your cblocks.

The Perl C library is vast, and a tutorial for it may be useful at some point. Until that time, I will simply refer you to perlapi and perlguts.