nag_implementation_separated_details (a00adc) (PDF version)
a00 Chapter Contents
a00 Chapter Introduction
NAG C Library Manual

NAG Library Function Document

nag_implementation_separated_details (a00adc)

+ Contents

    1  Purpose
    7  Accuracy

1  Purpose

nag_implementation_separated_details (a00adc) prints information about the version of the NAG C Library in use.

2  Specification

#include <nag.h>
#include <naga00.h>
void  nag_implementation_separated_details (char *impl, char *prec, char *pcode, char *mkmaj, char *mkmin, char *hdware, char *opsys, char *ccomp, char *fcomp, char *vend, Nag_Boolean *licval)

3  Description

The NAG C 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 C Library, the target hardware and operating system, the compiler used, and the vendor library (if any) that is also required to be linked. nag_implementation_separated_details (a00adc) may be called to return, in separate arguments, these specific details of the NAG C Library implementation that is being used; it also returns whether a valid licence has been found for this implementation. This differs from nag_implementation_details (a00aac) which simply outputs the collected information in a readable form directly to the stdout (standard output) stream.

4  References

None.

5  Arguments

1:     implchar *Output
On exit: the implementation title which usually lists the target platform, operating system and compiler.
2:     precchar *Output
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:     pcodechar *Output
On exit: the product code for the NAG C 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:     mkmajchar *Output
On exit: the major mark of the NAG C Library implementation that is being used.
5:     mkminchar *Output
On exit: the minor mark of the NAG C Library implementation that is being used.
6:     hdwarechar *Output
On exit: the target hardware for the NAG C Library implementation that is being used.
7:     opsyschar *Output
On exit: the target operating system for the NAG C Library implementation that is being used.
8:     ccompchar *Output
On exit: the C compiler used to build the NAG C Library implementation that is being used.
9:     fcompchar *Output
On exit: the Fortran compiler used to build the NAG C Library implementation that is being used.
10:   vendchar *Output
On exit: the subsidiary library, if any, that must be linked with the NAG C 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:   licvalNag_Boolean *Output
On exit: specifies whether or not a valid licence has been found for the NAG C Library implementation that is being used.

6  Error Indicators and Warnings

None.

7  Accuracy

Not applicable.

8  Further Comments

None.

9  Example

This example makes a call of nag_implementation_separated_details (a00adc), collects information on the NAG C Library implementation that is being used and prints it out in a form that is similar to the output obtained by a call to nag_implementation_details (a00aac).

9.1  Program Text

Program Text (a00adce.c)

9.2  Program Data

None.

9.3  Program Results

Program Results (a00adce.r)


nag_implementation_separated_details (a00adc) (PDF version)
a00 Chapter Contents
a00 Chapter Introduction
NAG C Library Manual

© The Numerical Algorithms Group Ltd, Oxford, UK. 2012