User-supplied print routine.

Format

USER_PRINT_ROUTINE (context, buf, size)

Arguments

context

integer*4
Integer array of length determined by the user. This argument is passed by the user in CXML_ITSOL_SET_PRINT_ROUTINE to retain information for use by this routine.

buf

integer*4
Null-terminated string passed by iterative solver.

size

integer*4
Size of null-terminated string passed by iterative solver.

Description

USER_PRINT_ROUTINE is a user-supplied print routine that can be called by the iterative solvers to print messages. Iterative solvers send a null-terminated string to this routine.

Note: CXML provides a routine that can be called by USER_PRINT_ROUTINE to format the null-terminated strings returned to it by the iterative solvers. This routine, CXML_FORMAT_STRING, avoids the problems associated with passing character strings from C to Fortran on various platforms. It is highly recommended that you call CXML_FORMAT_STRING in your USER_PRINT_ROUTINE.

For further information and examples about how to use this routine, refer to the "Using Iterative Solvers for Sparse Linear Systems" chapter of the CXML Reference Guide.