The current naming scheme for the C functions (emsAnnul
etc.) replaces the earlier one (ems_annul_c etc.),
but the old names will still be recognised.
There is no change to the argument lists.
(See Appendix for more details.)
Two additional functions are available for C programmers:
The function emsExpnd has the argument maxlen, not found in its equivalent Fortran call sequence. This argument represents the maximum allowable string length for the expanded message and is necessary for the use of returned C character strings where the declared length cannot be determined. Normally, the argument maxlen is given the global constant value EMS__SZMSG. There should be space for maxlen+1 characters in the output string.
The correspondence between ANSI Fortran 77 data types and ANSI C data types
is not defined: i.e. it is implementation dependent.
However, the most likely correspondence can be assumed and this has been coded
into the C/Fortran interface.
This correspondence is apparent from the C interface function prologues
provided in Appendix and is summarised in the following table:
C Type | Fortran Type |
---|---|
double | DOUBLE PRECISION |
float | REAL |
int | INTEGER |
int | LOGICAL |
char | CHARACTER |
Note that the interpretation of the int lvalue argument presented to the function emsSetl is that defined by the ANSI C language.
EMS Error Message Service