Adding some documentation to Sort
[Math-GSL.git] / NTuple.i
blobddf43e82d76f13792f0e0192dad5c4ee01453946
1 %module "Math::GSL::NTuple"
2 %include "typemaps.i"
4 %typemap(in) void * {
5 $1 = (double *) $input;
6 };
8 %{
9 #include "gsl/gsl_ntuple.h"
12 %include "gsl/gsl_ntuple.h"
14 //%apply double * OUTPUT {
16 %perlcode %{
17 @EXPORT_OK = qw/
18 gsl_ntuple_open
19 gsl_ntuple_create
20 gsl_ntuple_write
21 gsl_ntuple_read
22 gsl_ntuple_bookdata
23 gsl_ntuple_project
24 gsl_ntuple_close
26 %EXPORT_TAGS = ( all => [ @EXPORT_OK ] );
28 __END__
30 =head1 NAME
32 Math::GSL::NTuple - Functions for creating and manipulating ntuples, sets of values associated with events
34 =head1 SYNOPSIS
36 This module is not yet implemented. Patches Welcome!
38 use Math::GSL::NTuple qw /:all/;
40 =head1 DESCRIPTION
42 Here is a list of all the functions in this module :
44 =over
46 =item * <gsl_ntuple_open($filename, $ntuple_data, $size)> - This function opens an existing ntuple file $filename for reading and returns a pointer to a corresponding ntuple struct. The ntuples in the file must have size $size. A pointer to memory for the current ntuple row $ntuple_data, which is an array reference, must be supplied—this is used to copy ntuples in and out of the file.
48 =item * <gsl_ntuple_create > - This function creates a new write-only ntuple file $filename for ntuples of size $size and returns a pointer to the newly created ntuple struct. Any existing file with the same name is truncated to zero length and overwritten. A pointer to memory for the current ntuple row $ntuple_data, which is an array reference, must be supplied—this is used to copy ntuples in and out of the file.
51 =item * <gsl_ntuple_write($ntuple)> - This function writes the current $ntuple $ntuple->{ntuple_data} of size $ntuple->{size} to the corresponding file.
53 =item * <gsl_ntuple_bookdata($ntuple)> - This function is a synonym for gsl_ntuple_write.
55 =item * <gsl_ntuple_read($ntuple)> - This function reads the current row of the ntuple file for ntuple and stores the values in $ntuple->{data}.
57 =item * <gsl_ntuple_project >
59 =item * <gsl_ntuple_close($ntuple)> - This function closes the ntuple file ntuple and frees its associated allocated memory.
61 =back
63 For more informations on the functions, we refer you to the GSL offcial
64 documentation: L<http://www.gnu.org/software/gsl/manual/html_node/>
66 Tip : search on google: site:http://www.gnu.org/software/gsl/manual/html_node/ name_of_the_function_you_want
69 =head1 AUTHORS
71 Jonathan Leto <jonathan@leto.net> and Thierry Moisan <thierry.moisan@gmail.com>
73 =head1 COPYRIGHT AND LICENSE
75 Copyright (C) 2008 Jonathan Leto and Thierry Moisan
77 This program is free software; you can redistribute it and/or modify it
78 under the same terms as Perl itself.
80 =cut