50 lines
894 B
C
50 lines
894 B
C
|
/*
|
||
|
|
* Copyright (c) 2026, Chloe M.
|
||
|
|
* Provided under the BSD-3 clause
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef CESCAL_READBUF_H
|
||
|
|
#define CESCAL_READBUF_H 1
|
||
|
|
|
||
|
|
#include <sys/types.h>
|
||
|
|
#include <stdint.h>
|
||
|
|
#include <stddef.h>
|
||
|
|
|
||
|
|
#define READBUF_CAP 128
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Represents a read buffer that reduces system call
|
||
|
|
* overhead.
|
||
|
|
*
|
||
|
|
* @buf: Read buffer
|
||
|
|
* @size: Total populated size of offer
|
||
|
|
* @tail: Tail pointer from start of buffer
|
||
|
|
*/
|
||
|
|
struct readbuf {
|
||
|
|
char buf[READBUF_CAP];
|
||
|
|
size_t size;
|
||
|
|
size_t tail;
|
||
|
|
};
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Initialize a read buffer
|
||
|
|
*
|
||
|
|
* @rb: Readbuffer to initialize
|
||
|
|
*
|
||
|
|
* Returns zero on success
|
||
|
|
*/
|
||
|
|
int readbuf_init(struct readbuf *rb);
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Read from a read buffer and populate if needed
|
||
|
|
*
|
||
|
|
* @rb: Target readbuffer
|
||
|
|
* @fd: File descriptor to read from
|
||
|
|
*
|
||
|
|
* Returns the character read on success, '\0' on
|
||
|
|
* failure.
|
||
|
|
*/
|
||
|
|
char readbuf_read(struct readbuf *rb, int fd);
|
||
|
|
|
||
|
|
#endif /* !CESCAL_READBUF_H */
|