Error Handling

On success, S3L_gen_lsq returns S3L_SUCCESS.

S3L_gen_lsq checks the validity of the array arguments. If an array argument is found to be corrupted or invalid, an error code is returned. See Appendix A of this manual for a detailed list of these error codes.

In addition, the following conditions will cause the function to terminate and return the associated error code.

• S3L_ERR_ARG_AXISNUM - An axis argument is invalid; that is, it is either:

  • Less than 0 (C/C++) or less than 1 (F77/F90).

  • Greater than the rank of the referenced array.

  • axis1 is equal to axis2.

• S3L_ERR_MATCH_DTYPE - The array arguments are not all of the same type, as required.

• S3L_ERR_MATCH_RANK - Corresponding ranks of the array arguments do not match.

• S3L_ERR_MATCH_EXTENTS - The extents of the arrays are not compatible.

• S3L_ERR_ARG_DTYPE - The array arguments are not float or double, complex, or double precision complex.