NCEPLIBS-bufr  12.0.1
exitbufr.f File Reference

Reset the NCEPLIBS-bufr software for potential dynamic reallocation of memory. More...

Go to the source code of this file.

Functions/Subroutines

recursive subroutine exitbufr
 This subroutine frees all dynamically-allocated memory, closes all logical units that are open within the NCEPLIBS-bufr software, and resets the library to all of its default settings as though it had never been called. More...
 

Detailed Description

Reset the NCEPLIBS-bufr software for potential dynamic reallocation of memory.

Author
J. Ator
Date
2015-03-02

Definition in file exitbufr.f.

Function/Subroutine Documentation

◆ exitbufr()

recursive subroutine exitbufr

This subroutine frees all dynamically-allocated memory, closes all logical units that are open within the NCEPLIBS-bufr software, and resets the library to all of its default settings as though it had never been called.

Remarks
  • Calling this subroutine allows an application program to potentially resize arrays and reallocate memory all over again with a new subsequent series of calls to subroutines isetprm() and openbf(). However, if and when this subroutine is called, there is no longer any internal memory available within the NCEPLIBS-bufr software, and the remainder of the library becomes essentially unusable within the application program, unless and until subroutine openbf() is called once again to dynamically allocate new array space. This may be a useful capability for application programs that are finished with using the NCEPLIBS-bufr software and wish to move on to other unrelated tasks without continuing to tie up all of the allocated memory space within the library. Otherwise, and unless there's a need to change parameter sizes following the first call to subroutine openbf(), then there's no need to ever call this subroutine within an application program, since all allocated memory will automatically get freed anyway by the operating system once the application program terminates.
Author
J. Ator
Date
2015-03-02

Definition at line 33 of file exitbufr.f.

References ardllocf(), closbf(), modv_ifopbf::ifopbf, modv_im8b::im8b, moda_stbfr::iolun, modv_nfiles::nfiles, and moda_s01cm::ns01v.

Referenced by bufr_c2f_interface::exitbufr_c().