Leaving a Sun S3L Environment

S3L_exit

Description

When an application is finished using Sun S3L functions, it must call S3L_exit to perform various cleanup tasks associated with the current S3L environment.

S3L_exit checks to see if the S3L environment is in the initialized state--S3L_init has been called more recently than S3L_exit. If not, S3L_exit returns the error message S3L_ERR_NOT_INIT and exits.

Syntax

The C and Fortran syntax for S3L_exit are illustrated below.

C/C++ Syntax

Example 7-3

#include <s3l/s3l-c.h>
#include <s3l/s3l_errno-c.h>
int
S3L_exit()

F77/F90 Syntax

Example 7-4

include `s3l/s3l-f.h'
include s3l/s3l_errno-f.h'
subroutine
S3L_exit(ier)
    integer*4          ier

Input

S3L_exit takes no input arguments.

Output

When called from a Fortran program, S3L_exit returns error status in ier.

Error Handling

On successful completion, S3L_exit returns S3L_SUCCESS.

The following condition will cause S3L_exit to terminate and return the associated error value:

• S3L_ERR_NOT_INIT - S3L has not been initialized.

Examples

../examples/s3l/dense_matrix_ops/inner_prod.c 
../examples/s3l/dense_matrix_ops-f/inner_prod.f
../examples/s3l/utils/copy_array.f

Related Functions

S3L_init(3)