SYNOPSIS

use XS::APItest;
print_double(4);

ABSTRACT

This module tests the perl C . Currently tests that works correctly.

DESCRIPTION

This module can be used to check that the perl C is behaving correctly. This module provides test functions and an associated test script that verifies the output.

This module is not meant to be installed.

Exports all the test functions:

print_double

Test that a double-precision floating point number is formatted correctly by .

 print_double( $val );

Output is sent to .

print_long_double

Test that a is formatted correctly by . Takes no arguments - the test value is hard-wired into the function (as ``7'').

 print_long_double();

Output is sent to .

have_long_double

Determine whether a is supported by Perl. This should be used to determine whether to test .

 print_long_double() if have_long_double;

print_nv

Test that an is formatted correctly by .

 print_nv( $val );

Output is sent to .

print_iv

Test that an is formatted correctly by .

 print_iv( $val );

Output is sent to .

print_uv

Test that an is formatted correctly by .

 print_uv( $val );

Output is sent to .

print_int

Test that an is formatted correctly by .

 print_int( $val );

Output is sent to .

print_long

Test that an is formatted correctly by .

 print_long( $val );

Output is sent to .

print_float

Test that a single-precision floating point number is formatted correctly by .

 print_float( $val );

Output is sent to .

call_sv, call_pv, call_method

These exercise the C calls of the same names. Everything after the flags arg is passed as the the args to the called function. They return whatever the C function itself pushed onto the stack, plus the return value from the function; for example

 call_sv( sub { @_, 'c' }, G_ARRAY, 'a', 'b'); # returns 'a', 'b', 'c', 3
 call_sv( sub { @_ }, G_SCALAR, 'a', 'b'); # returns 'b', 1

eval_sv

Evaluates the passed . Result handling is done the same as for etc.

eval_pv

Exercises the C function of the same name in scalar context. Returns the same that the C function returns.

require_pv

Exercises the C function of the same name. Returns nothing.

AUTHORS

Tim Jenness, <[email protected]>, Christian Soeller, <[email protected]>, Hugo van der Sanden <[email protected]>

COPYRIGHT AND LICENSE

Copyright (C) 2002,2004 Tim Jenness, Christian Soeller, Hugo van der Sanden. All Rights Reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.