chiark - git - mdw - disorder/blob - lib/hreader.h

   1 /*
   2  * This file is part of DisOrder
   3  * Copyright (C) 2010 Richard Kettlewell
   4  *
   5  * This program is free software: you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation, either version 3 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18 /** @file lib/hreader.h
  19  * @brief Hands-off reader - read files without keeping them open
  20  */
  21 #ifndef HREADER_H
  22 #define HREADER_H
  23
  24 #include <unistd.h>
  25
  26 /** @brief A hands-off reader
  27  *
  28  * Allows files to be read without holding them open.
  29  */
  30 struct hreader {
  31   const char *path;             /* file to read */
  32   off_t read_offset;            /* for next hreader_read() */
  33   off_t buf_offset;             /* offset of start of buffer */
  34   char *buffer;                 /* input buffer */
  35   size_t bufsize;               /* buffer size */
  36   size_t bytes;                 /* size of last read */
  37 };
  38
  39 /** @brief Initialize a hands-off reader
  40  * @param path File to read
  41  * @param h Reader to initialize
  42  */
  43 void hreader_init(const char *path, struct hreader *h);
  44
  45 /** @brief Read some bytes
  46  * @param h Reader to read from
  47  * @param buffer Where to store bytes
  48  * @param n Maximum bytes to read
  49  * @return Bytes read, or 0 at EOF, or -1 on error
  50  */
  51 int hreader_read(struct hreader *h, void *buffer, size_t n);
  52
  53 /** @brief Read some bytes at a given offset
  54  * @param h Reader to read from
  55  * @param offset Offset to read at
  56  * @param buffer Where to store bytes
  57  * @param n Maximum bytes to read
  58  * @return Bytes read, or 0 at EOF, or -1 on error
  59  */
  60 int hreader_pread(struct hreader *h, void *buffer, size_t n, off_t offset);
  61
  62 #endif /* HREADER_H */
  63
  64 /*
  65 Local Variables:
  66 c-basic-offset:2
  67 comment-column:40
  68 fill-column:79
  69 indent-tabs-mode:nil
  70 End:
  71 */