Gnuplotfortran 0.2.2

Node: gnuplot_resetsession, Next: gnuplot_set, Previous: gnuplot_settitle, Up: Atomic Routines

GNUPLOT_RESETSESSION

INPUTS :
- ptr_gctrl : Pointer to structure of type gnuplot_ctrl.
OUTPUTS :
- status : Integer (error flag).
PURPOSE :
Resets the session¹. Gnuplotfortran internally keeps a count of number of plots currently active. This function sets that count to zero. This might be useful in a situation where real time data is being plotted, and the user is certain that a large number of user plots do not correspond to a calling program that is in a runaway state. If you are looking for a way to issue the reset command, see gnuplot-reset.
DIAGNOSTICS :
- status = 0 : Success.
- status = BAD_SIGNAL : Called with a dissociated pointer.
- status = 22 : Failed to delete temporary file.

INTERFACE :

          interface
            integer function gnuplot_resetsession(ptr_gctrl) result(status)
              type(gnuplot_ctrl), pointer :: ptr_gctrl
            end function gnuplot_resetsession
          end interface

Footnotes

This function is not truly an atomic function, as it does not correspond to any gnuplot session action.