DMGetWorkArray — PETSc 3.21.4 documentation

Skip to main content
`Ctrl`+`K`

# DMGetWorkArray

Gets a work array guaranteed to be at least the input size, restore with `DMRestoreWorkArray()`

## Synopsis

    #include "petscdm.h"
    #include "petscdmlabel.h"
    #include "petscds.h"
    PetscErrorCode DMGetWorkArray(DM dm, PetscInt count, MPI_Datatype dtype, void *mem)

Not Collective

## Input Parameters

- dm - the `DM` object

- count - The minimum size

- dtype - MPI data type, often `MPIU_REAL`, `MPIU_SCALAR`, or `MPIU_INT`)

## Output Parameter

- mem - the work array

## Notes

A `DM` may stash the array between instantiations so using this routine may be more efficient than calling `PetscMalloc()`

The array may contain nonzero values

## See Also

DM Basics, `DM`, `DMDestroy()`, `DMCreate()`, `DMRestoreWorkArray()`, `PetscMalloc()`

## Level

developer

## Location

src/dm/interface/dm.c

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