CXML

USER_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.


CXML Home Page

Index of CXML Routines