Format null-terminated strings.

Format

cxml_format_string (buf, size, new_buf)

Arguments

buf

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

size

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

new_buf

character*cxml_itsol_max_message_length
Formatted character string consisting of message from iterative solver.

Description

CXML_FORMAT_STRING formats null-terminated strings returned by the iterative solvers. This routine is specifically designed for Fortran users who wish to write a USER_PRINT_ROUTINE. CXML_FORMAT_STRING can be called by USER_PRINT_ROUTINE to avoid problems that may occur when character strings are passed from C to Fortran on various platforms. The use of this routine is highly recommended.

Note: 'cxml_itsol_print.for' must be included in 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.