AIRES library reference: crogotorec.


c
c     Routine directly callable from C/C++ (it could be necessary to
c     append an underscore, "_", to its name depending on the C/C++
c     compiler used).
c
c
      function crogotorec(fileid, recnumber, vrb, irc)
c
c     Positioning the file after a given record.
c
c     Written by: S. J. Sciutto, La Plata 1997, 2010.
c
c
c     Arguments:
c     =========
c
c     fileid.......... (input, integer) Compressed file number. This
c                      parameter identifies the file to be used for
c                      reading, and is set by the file opening
c                      routine.
c     recnumber....... (input, integer) The record number. A negative
c                      value is taken as zero. If recnumber LE 0, the
c                      return code is always set to zero for
c                      successful operations.
c     vrb............. (input, integer) Verbosity control. If vrb is
c                      zero or negative then no error/informative
c                      messages are printed; error conditions are
c                      communicated to the calling program via the
c                      return code. If vrb is positive error messages
c                      will be printed: vrb = 1 means that messages
c                      will be printed even with successful operations.
c                      vrb = 2,3 means that only error messages will
c                      be printed. vrb > 3 is similar to vrb = 3, but
c                      with the additional action of stopping the
c                      program if a fatal error takes place.
c     irc............. (output, integer) Return code. 0 means that the
c                      last scanned record record was of default type. i
c                      (i > 0) means that the last scanned record was an
c                      alternative record of type i. -1 means that an
c                      end-of-file condition was got from the
c                      corresponding file before reaching the indicated
c                      record.  Any other value indicates a reading
c                      error (irc equals the system return code plus
c                      10000).
c
c     Return value: (logical) True if the positioning was successfully
c     ============  done. False otherwise.
c
c
c<--->

These pages are maintained by
Sergio J. Sciutto
Back to AIRES library index
Back to AIRES home [HOME]