# %setflush() function

The %setflush() function sets the flush
periods.

**For Windows:**Not Supported

Warning: The %setflush() function *cannot* be flash compiled.

## Syntax

```
oldp = %setflush(newp, newfp)
```

## Description

The normal flush period is set
to the number of seconds specified by *newp*, the
forced flush period to *newfp* and the previous values
are returned into *oldp*. The upper 16 bits of the
(int) *oldp* is the value of the forced flush period,
and the lower 16 bits, the value of the normal flush.

- If newp is null, no change is made to the normal flush.

- If newfp is equal to -2, no change is made to the forced flush.

- If newfp is equal to -1, the forced flush is disabled.

- If newfp is equal to 0, the forced flush is set into immediate write mode.

Note: The statement cfunction gm.builtin must
be included in the source. This function is a D3 extension. It is
not part of libc.a.

## See also

- [cfunction statement](https://d3codex.com/pickbasic-flashbasic/cfunction-statement/)
- [Flusher](https://d3codex.com/definitions/flusher/)
- [set-flush command](https://d3codex.com/tcl/set-flush-command/)

---
Source: https://d3codex.com/pickbasic-flashbasic/percent-setflush-function/ - part of the D3Codex reference.