XS::APItest - Test the perl C API

- NAME
- SYNOPSIS
- ABSTRACT
- DESCRIPTION

- EXPORT

- SEE ALSO
- AUTHORS
- COPYRIGHT AND LICENSE

# NAME

XS::APItest - Test the perl C API

# SYNOPSIS

      use XS::APItest;
      print_double(4);

# ABSTRACT

This module tests the perl C API. Currently tests that `printf` works correctly.

# DESCRIPTION

This module can be used to check that the perl C API 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.

## EXPORT

Exports all the test functions:

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

        print_double( $val );

  Output is sent to STDOUT.

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

        print_long_double();

  Output is sent to STDOUT.

have_long_double
  Determine whether a `long double` is supported by Perl. This should be used to determine whether to test `print_long_double`.

        print_long_double() if have_long_double;

print_nv
  Test that an `NV` is formatted correctly by `printf`.

        print_nv( $val );

  Output is sent to STDOUT.

print_iv
  Test that an `IV` is formatted correctly by `printf`.

        print_iv( $val );

  Output is sent to STDOUT.

print_uv
  Test that an `UV` is formatted correctly by `printf`.

        print_uv( $val );

  Output is sent to STDOUT.

print_int
  Test that an `int` is formatted correctly by `printf`.

        print_int( $val );

  Output is sent to STDOUT.

print_long
  Test that an `long` is formatted correctly by `printf`.

        print_long( $val );

  Output is sent to STDOUT.

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

        print_float( $val );

  Output is sent to STDOUT.

# SEE ALSO

the XS::Typemap manpage, the perlapi manpage.

# AUTHORS

Tim Jenness, <t.jenness@jach.hawaii.edu>, Christian Soeller, <csoelle@mph.auckland.ac.nz>, Hugo van der Sanden <hv@crypt.compulink.co.uk>

# COPYRIGHT AND LICENSE

Copyright (C) 2002 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.

XS::APItest - Test the perl C API