1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
%perlcode %{
@EXPORT_OK = qw/
gsl_error gsl_stream_printf gsl_strerror gsl_set_error_handler
gsl_set_error_handler_off gsl_set_stream_handler gsl_set_stream
$GSL_SUCCESS $GSL_FAILURE $GSL_CONTINUE $GSL_EDOM
$GSL_ERANGE $GSL_EFAULT $GSL_EINVAL $GSL_EFAILED
$GSL_EFACTOR $GSL_ESANITY $GSL_ENOMEM $GSL_EBADFUNC
$GSL_ERUNAWAY $GSL_EMAXITER $GSL_EZERODIV $GSL_EBADTOL
$GSL_ETOL $GSL_EUNDRFLW $GSL_EOVRFLW $GSL_ELOSS
$GSL_EROUND $GSL_EBADLEN $GSL_ENOTSQR $GSL_ESING
$GSL_EDIVERGE $GSL_EUNSUP $GSL_EUNIMPL $GSL_ECACHE
$GSL_ETABLE $GSL_ENOPROG $GSL_ENOPROGJ $GSL_ETOLF
$GSL_ETOLX $GSL_ETOLG $GSL_EOF
/;
%EXPORT_TAGS = ( all => \@EXPORT_OK );
__END__
=encoding utf8
=head1 NAME
Math::GSL::Errno - Error Handling
=cut
=head1 SYNOPSIS
use Math::GSL::Errno qw/:all/;
gsl_set_error_handler_off();
print gsl_strerror($GSL_EDOM) . "\n";
=head1 STATUS CODES
=over 4
=item * $GSL_SUCCESS
Success
=item * $GSL_FAILURE
General Failure
=item * $GSL_CONTINUE
Iteration has not converged
=item * $GSL_EDOM
Domain error; used by mathematical functions when an argument value does not fall into the domain over which the function is defined (like EDOM in the C library)
=item * $GSL_ERANGE
Range error; used by mathematical functions when the result value is not representable because of overflow or underflow (like ERANGE in the C library)
=item * $GSL_EFAULT
Invalid Pointer
=item * $GSL_EINVAL
Invalid argument. This is used to indicate various kinds of problems with passing the wrong argument to a library function (like EINVAL in the C library).Invalid argument. This is used to indicate various kinds of problems with passing the wrong argument to a library function (like EINVAL in the C library).
=item * $GSL_EFAILED
Generic Failure
=item * $GSL_EFACTOR
Factorization Failed
=item * $GSL_ESANITY
Sanity Check Failed
=item * $GSL_ENOMEM
No memory available. The system cannot allocate more virtual memory because its capacity is full (like ENOMEM in the C library). This error is reported when a GSL routine encounters problems when trying to allocate memory with malloc.
=item * $GSL_EBADFUNC
Problem with user-supplied function
=item * $GSL_ERUNAWAY
Iterative process is our of control
=item * $GSL_EMAXITER
Exceeded max number of iterations
=item * $GSL_EZERODIV
Division by zero
=item * $GSL_EBADTOL
Invalid user-specified tolerance
=item * $GSL_ETOL
Failed to reach the specified tolerance
=item * $GSL_EUNDRFLW
Underflow
=item * $GSL_EOVRFLW
Overflow
=item * $GSL_ELOSS
Loss of accuracy
=item * $GSL_EROUND
Failed due to roundoff error
=item * $GSL_EBADLEN
Matrix/vector lengths not compatible
=item * $GSL_ENOTSQR
Not a square matrix
=item * $GSL_ESING
Singularity Detected
=item * $GSL_EDIVERGE
Integral/Series is divergent
=item * $GSL_EUNSUP
Not supported by hardware
=item * $GSL_EUNIMPL
Not implemented
=item * $GSL_ECACHE
Cache limit exceeded
=item * $GSL_ETABLE
Table limit exceeded
=item * $GSL_ENOPROG
Iteration not converging
=item * $GSL_ENOPROGJ
Jacobian not improving solution
=item * $GSL_ETOLF
Cannot reach tolerance in F
=item * $GSL_ETOLX
Cannot reach tolerance in X
=item * $GSL_ETOLG
Cannot reach tolerance in Gradient
=item * $GSL_EOF
End of file
=back
=head1 FUNCTIONS
=over
=item * gsl_error
=item * gsl_stream_printf
=item * gsl_strerror($gsl_errno) - This function returns a pointer to a string describing the error code gsl_errno. For example, print ("error: gsl_strerror ($status)\n"); would print an error message like error: output range error for a status value of GSL_ERANGE.
=item * gsl_set_error_handler
=item * gsl_set_error_handler_off() - This function turns off the error handler by defining an error handler which does nothing. This will cause the program to continue after any error, so the return values from any library routines must be checked. This is the recommended behavior for production programs. The previous handler is returned (so that you can restore it later).
=item * gsl_set_stream_handler
=item * gsl_set_stream
=back
=cut
1;
%}
|
