PetscOptionsCreateViewers

Create multiple viewers from a comma-separated list of viewer specifications in the options database

Synopsis

#include "petscviewer.h" 
PetscErrorCode PetscOptionsCreateViewers(MPI_Comm comm, PetscOptions options, const char prefix[], const char name[], PetscInt *n_max, PetscViewer viewers[], PetscViewerFormat formats[], PetscBool *set)

Collective

Input Parameters

• comm - the communicator to own the viewers

• options - options database, use NULL for default global database

• prefix - the string to prepend to the name (may be NULL)

• name - the options database name that will be checked for

• n_max - on input: the maximum number of viewers; on output: the number of viewers found in the comma-separated list

Output Parameters

• viewers - an array to hold at least n_max PetscViewers, or NULL if not needed; on output: if not NULL, the first n_max entries are initialized PetscViewers

• formats - an array to hold at least n_max PetscViewerFormats, or NULL if not needed; on output: if not NULL, the first n_max entries are valid PetscViewewFormats

• set - PETSC_TRUE if found, else PETSC_FALSE

Notes

See PetscOptionsCreateViewer() for how the viewer specifications are interpreted.

Use PetscViewerDestroy() on each viewer.

See Also

Viewers: Looking at PETSc Objects, PetscOptionsCreateViewer()

Level

intermediate

Location

src/sys/classes/viewer/interface/viewreg.c

---

Index of all Viewer routines
Table of Contents for all manual pages
Index of all manual pages