Error Handling

On success, S3L_trans returns S3L_SUCCESS.

S3L_trans checks the arrays it accepts as arguments. If an array argument contains an invalid or corrupted value, the function terminates and an error code indicating which value of the array handle was invalid is returned. See Appendix A of this manual for a detailed list of these error codes.

In addition, the following condition will cause the function to terminate and return the associated code:

• S3L_ERR_MATCH_RANK - The ranks of a and b do not match.

• S3L_ERR_MATCH_EXTENTS - The extents of a and b are not compatible with the transpose operation requested. That is, the following relationship is not satisfied for all array axes i.

ext(a,axis_perm[i])=ext(b,i)

• S3L_ERR_TRANS_PERMAX - The supplied permutation is not valid (every axis must appear exactly once).

• S3L_ERR_ARG_AXISNUM - The axis argument has an invalid value. The correct values for axis are

  • 0 <= axis < rank of the array (C/C++)

  • 0 < axis <= rank of the array (F77/F90)