The
NAG Library is available for use on a number of different computer systems. For each distinct system an implementation of the Library is prepared and this implementation is given a unique code. The specifics that define the implementation are: the working precision, the major and minor marks of the
NAG Library, the target hardware and operating system, the compiler used, and the vendor library (if any) that is also required to be linked.
a00adc may be called to return, in separate arguments, these specific details of the
NAG Library implementation that is being used; it also returns whether a valid licence has been found for this implementation. This differs from
a00aac which simply outputs the collected information in a readable form directly to the
stdout (standard output) stream.
None.
-
1:
– char *
Output
-
Note: the string returned in
impl will be at most
characters in length.
On exit: the implementation title which usually lists the target platform, operating system and compiler.
-
2:
– char *
Output
-
Note: the string returned in
prec will be at most
characters in length.
On exit: the working or basic precision of the implementation. Some functions may perform operations in reduced precision or additional precision, but the great majority will perform all operations in basic precision.
-
3:
– char *
Output
-
Note: the string returned in
pcode will be at most
characters in length.
On exit: the product code for the NAG Library implementation that is being used. The code has a discernible structure, but it is not necessary to know the details of this structure. The product code can be used to differentiate between individual product licence codes.
-
4:
– char *
Output
-
On exit: the major mark of the NAG Library implementation that is being used.
-
5:
– char *
Output
-
On exit: the minor mark of the NAG Library implementation that is being used.
-
6:
– char *
Output
-
Note: the string returned in
hdware will be at most
characters in length.
On exit: the target hardware for the NAG Library implementation that is being used.
-
7:
– char *
Output
-
Note: the string returned in
opsys will be at most
characters in length.
On exit: the target operating system for the NAG Library implementation that is being used.
-
8:
– char *
Output
-
On exit: the C compiler used to build the NAG Library implementation that is being used.
-
9:
– char *
Output
-
Note: the string returned in
fcomp will be at most
characters in length.
On exit: the Fortran compiler used to build the NAG Library implementation that is being used.
-
10:
– char *
Output
-
Note: the string returned in
vend will be at most
characters in length.
On exit: the subsidiary library, if any, that must be linked with the
NAG Library implementation that is being used. If the implementation does not require a subsidiary library then the string
'(self-contained)'
will be returned in
vend.
-
11:
– Nag_Boolean *
Output
-
On exit: specifies whether or not a valid licence has been found for the NAG Library implementation that is being used.
None.
Not applicable.
Background information to multithreading can be found in the
Multithreading documentation.
Not applicable.
None.
This example makes a call of
a00adc, collects information on the
NAG Library implementation that is being used and prints it out in a form that is similar to the output obtained by a call to
a00aac.
None.