petsc-3.14.5 2021-03-03
Report Typos and Errors

# PetscObjectGetNewTag

Gets a unique new tag from a PETSc object. All processors that share the object MUST call this routine EXACTLY the same number of times. This tag should only be used with the current objects communicator; do NOT use it with any other MPI communicator.

### Synopsis

    #include "petscsys.h"
    PetscErrorCode  PetscObjectGetNewTag(PetscObject obj,PetscMPIInt *tag)

Collective on PetscObject

### Input Parameter

| obj | - the PETSc object; this must be cast with a (PetscObject), for example, PetscObjectGetNewTag((PetscObject)mat,&tag);

### Output Parameter

| tag | - the new tag

### See Also

PetscCommGetNewTag()

### Level

developer

### Location

src/sys/objects/tagm.c
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages