hsperl_init argc argv

Allocates and initializes an Interpreter instance, and runs it as if called at the command line with argv strings as arguments (minus the program name, naturally) and the original environment.

As a side effect, initializes global data structures needed by Perl API functions.

Internally, calls:

• https://perldoc.perl.org/perlapi#perl_alloc,
• https://perldoc.perl.org/perlapi#perl_construct,
• https://perldoc.perl.org/perlapi#perl_parse,
• https://perldoc.perl.org/perlapi#perl_run.

This is the undef SV. Always refer to this as &PL_sv_undef.

source: https://perldoc.perl.org/perlapi#PL_sv_undef

This is the true SV. See "PL_sv_no". Always refer to this as &PL_sv_yes.

source: https://perldoc.perl.org/perlapi#PL_sv_yes

This is the false SV. See "PL_sv_yes". Always refer to this as &PL_sv_no.

source: https://perldoc.perl.org/perlapi#PL_sv_no

warning: only handles non-null ASCII strings - not Unicode-safe.

caller should free returned memory.

args: str, len of str, flags

Creates a new SV and copies a string into it. The reference count for the SV is set to 1. Note that if len is zero, Perl will create a zero length string. You are responsible for ensuring that the source string is at least len bytes long. If the s argument is NULL the new SV will be undefined.

See https://perldoc.perl.org/perlapi#newSVpvn

warning: only handles non-null ASCII strings - not Unicode-safe.

Returns a pointer to the string in the SV, or a stringified form of the SV if the SV does not contain a string.

See https://perldoc.perl.org/perlapi#SvPV_nolen

Coerces the given SV to IV and returns it. The returned value in many circumstances will get stored in sv's IV slot, but not in all cases. (Use "sv_setiv" to make sure it does).

See SvIVx for a version which guarantees to evaluate sv only once.

Source: https://perldoc.perl.org/perlapi#SvIV

Coerces the given SV to NV and returns it. The returned value in many circumstances will get stored in sv's NV slot, but not in all cases. (Use "sv_setnv" to make sure it does).

See SvNVx for a version which guarantees to evaluate sv only once.

Source: https://perldoc.perl.org/perlapi#SvNV

Creates a new SV and copies an integer into it. The reference count for the SV is set to 1.

Source: https://perldoc.perl.org/perlapi#newSViv

Creates a new SV and copies a floating point value into it. The reference count for the SV is set to 1.

Source: https://perldoc.perl.org/perlapi#newSVnv

source: https://perldoc.perl.org/perlapi#perl_destruct

Releases a Perl Interpreter. See perlembed.

See https://perldoc.perl.org/perlapi#perl_free.

hsperl_apply subroutine receiver args context

Apply a subroutine to the specified args. The subroutine can be either a plain subroutine or a method.

The first parameter, subroutine, is either the name of a subroutine (i.e. a string) or a reference to a subroutine.

The second parameter specifies the method receiver (if a method is being called). If a plain subroutine is being called, NULL should be passed. If a method is being called, this should be either a reference to an object (for a normal method) or a reference to a class (for a static method).

Then follows a NULL terminated list of args, and the usual calling Context, (encoded as an int, with potentially other flags bitwise OR'ed into it).

Return values are given according to the same protocol as hsperl_eval.

Caller should free returned memory.

args: sub, method, args, flags

Returns a boolean indicating whether Perl would evaluate the SV as true or false. See "SvOK" for a defined/undefined test. Handles get magic unless the scalar is already SvPOK, SvIOK or SvNOK (the public, not the private flags).

See "SvTRUEx" for a version which guarantees to evaluate sv only once.

source: https://perldoc.perl.org/perlapi#SvTRUE

Returns the SV of the specified Perl scalar. Flags are passed to gv_fetchpv.

If GV_ADD is set and the Perl variable does not exist then it will be created. If flags is zero and the variable does not exist then NULL is returned.

NOTE: the perl_ form of this function is deprecated.

source: https://perldoc.perl.org/perlapi#get_sv

Turn on the UTF-8 status of an SV (the data is not changed, just the flag). Do not use frivolously.

source: https://perldoc.perl.org/perlapi#SvUTF8_on.

hsperl_sv_2pvutf8 sv lp

Return a pointer to the UTF-8-encoded representation of the SV, and set *lp to its length. May cause the SV to be upgraded to UTF-8 as a side-effect.

source: https://perldoc.perl.org/perlapi#sv_2pvutf8

hsperl_get_cv name flags: Uses strlen to get the length of name, then calls get_cvn_flags.

NOTE: the perl_ form of this function is deprecated.

See https://perldoc.perl.org/perlapi#get_cv

If it's desired Perl be extra-hygienic about cleaning up resources, this should be called (a) after allocation, but before initialization, and (b) before destruction. Currently, our initialization code already includes a call to it. (Multiple calls are harmless, though.)