:orphan:
# PetscOptionsCreate
Creates an empty options database. 
## Synopsis
```
#include "petscsys.h"   
PetscErrorCode PetscOptionsCreate(PetscOptions *options)
```
Logically Collective


## Output Parameter

- ***options -*** Options database object





## Note
Though PETSc has a concept of multiple options database the current code uses a single default `PetscOptions` object


## Developer Notes
We may want eventually to pass a `MPI_Comm` to determine the ownership of the object

This object never got developed after being introduced, it is not clear that supporting multiple `PetscOptions` objects is useful


## See Also
 `PetscOptionsDestroy()`, `PetscOptionsPush()`, `PetscOptionsPop()`, `PetscOptionsInsert()`, `PetscOptionsSetValue()`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/sys/objects/options.c.html#PetscOptionsCreate">src/sys/objects/options.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/sys/tutorials/ex19.c.html">src/sys/tutorials/ex19.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/sys/tutorials/ex20.c.html">src/sys/tutorials/ex20.c</A><BR>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/sys/objects/options.c)


[Index of all Sys routines](index.md)  
[Table of Contents for all manual pages](/manualpages/index.md)  
[Index of all manual pages](/manualpages/singleindex.md)  
