PetscOptionsInt — PETSc 3.25.0 documentation

Skip to main content
`Ctrl`+`K`

# PetscOptionsInt

Gets the integer value for a particular option in the database.

## Synopsis

    #include <petscoptions.h>
    PetscErrorCode PetscOptionsInt(const char opt[], const char text[], const char man[], PetscInt currentvalue, PetscInt *value, PetscBool *set)

Logically Collective on the communicator passed in `PetscOptionsBegin()`

## Input Parameters

- opt - option name

- text - short string that describes the option

- man - manual page with additional information on option

- currentvalue - the current value; caller is responsible for setting this value correctly. Normally this is done with either

                     PetscOptionsInt(..., obj->value, &obj->value, ...) or
                     value = defaultvalue
                     PetscOptionsInt(..., value, &value, &set);
                     if (set) {

## Output Parameters

- value - the integer value to return

- set - `PETSC_TRUE` if found, else `PETSC_FALSE`

## Notes

If the user does not supply the option at all `value` is NOT changed. Thus you should ALWAYS initialize `value` if you access it without first checking that `set` is `PETSC_TRUE`.

The `currentvalue` passed into this routine does not get transferred to the output `value` variable automatically.

Must be between a `PetscOptionsBegin()` and a `PetscOptionsEnd()`

## See Also

`PetscOptionsBoundedInt()`, `PetscOptionsGetReal()`, `PetscOptionsHasName()`, `PetscOptionsGetString()`, `PetscOptionsGetInt()`, `PetscOptionsGetIntArray()`, `PetscOptionsGetRealArray()`, `PetscOptionsGetBool()`, `PetscOptionsRangeInt()`, `PetscOptionsInt()`, `PetscOptionsString()`, `PetscOptionsReal()`, `PetscOptionsBool()`, `PetscOptionsName()`, `PetscOptionsBegin()`, `PetscOptionsEnd()`, `PetscOptionsHeadBegin()`, `PetscOptionsStringArray()`, `PetscOptionsRealArray()`, `PetscOptionsScalar()`, `PetscOptionsBoolGroupBegin()`, `PetscOptionsBoolGroup()`, `PetscOptionsBoolGroupEnd()`, `PetscOptionsFList()`, `PetscOptionsEList()`, `PetscOptionsBoundedReal()`, `PetscOptionsRangeReal()`

## Level

beginner

## Location

include/petscoptions.h

## Examples

src/dm/impls/plex/tutorials/ex5.c
src/ksp/ksp/tutorials/ex18.c
src/dm/impls/plex/tutorials/ex11.c
src/dm/impls/plex/tutorials/ex15.c
src/ksp/ksp/tutorials/ex56.c
src/ksp/ksp/tutorials/ex51.c
src/ksp/ksp/tutorials/ex71.c
src/dm/tutorials/ex2.c
src/dm/impls/plex/tutorials/ex13.c
src/ksp/ksp/tutorials/ex64.c

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