NAG Library Function Document

nag_implementation_separated_details (a00adc)

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: $impl$ – char *Output

On exit: the implementation title which usually lists the target platform, operating system and compiler.

2: $prec$ – char *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: $pcode$ – char *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: $mkmaj$ – char *Output

On exit: the major mark of the NAG C Library implementation that is being used.

5: $mkmin$ – char *Output

On exit: the minor mark of the NAG C Library implementation that is being used.

6: $hdware$ – char *Output

On exit: the target hardware for the NAG C Library implementation that is being used.

7: $opsys$ – char *Output

On exit: the target operating system for the NAG C Library implementation that is being used.

8: $ccomp$ – char *Output

On exit: the C compiler used to build the NAG C Library implementation that is being used.

9: $fcomp$ – char *Output

On exit: the Fortran compiler used to build the NAG C Library implementation that is being used.

10: $vend$ – char *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: $licval$ – Nag_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 Parallelism and Performance

Not applicable.

9 Further Comments

None.

10 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).