#ifndef _STDIO_H
#define _STDIO_H

#include <stdarg.h>

typedef struct __sFILE FILE;
typedef unsigned long size_t;

#ifndef NULL
# define NULL ((void *)0)
#endif

extern FILE *stdin;
extern FILE *stdout;
extern FILE *stderr;

int  putchar(int c);
int  puts(const char *s);
int  printf(const char *fmt, ...);
int  vprintf(const char *fmt, va_list ap);
int  sprintf(char *buf, const char *fmt, ...);
int  snprintf(char *buf, size_t n, const char *fmt, ...);
int  vsprintf(char *buf, const char *fmt, va_list ap);
int  vsnprintf(char *buf, size_t n, const char *fmt, va_list ap);
int  fprintf(FILE *stream, const char *fmt, ...);
int  vfprintf(FILE *stream, const char *fmt, va_list ap);
void perror(const char *prefix);
int  fputc(int c, FILE *stream);
int  fputs(const char *s, FILE *stream);
int  fflush(FILE *stream);
int  fclose(FILE *stream);

FILE *fopen(const char *path, const char *mode);
size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream);
size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);
int    fseek(FILE *stream, long offset, int whence);
long   ftell(FILE *stream);
int    feof(FILE *stream);
int    ferror(FILE *stream);
void   clearerr(FILE *stream);

// fgetpos / fsetpos — alternative seek API.  fpos_t holds the same
// information as ftell's long return, so the implementation is a thin
// wrapper.  Provided for source-compat with portable code.
typedef long fpos_t;
int    fgetpos(FILE *stream, fpos_t *pos);
int    fsetpos(FILE *stream, const fpos_t *pos);

// Buffer-control surface — no-ops in our buffer-less I/O model (mfs
// is direct memory, stdout flushes per putchar).  The functions exist
// so portable code compiles.
#define _IOFBF 0
#define _IOLBF 1
#define _IONBF 2
#define BUFSIZ 256
int    setvbuf(FILE *stream, char *buf, int mode, size_t size);
void   setbuf (FILE *stream, char *buf);

// File-system operations — stubs that route to mfsUnregister and
// hand-rolled rename.  Return 0 on success, -1 on failure.
int    remove(const char *path);
int    rename(const char *old, const char *neu);

// Temporary-file helpers — stubs returning NULL / (char *)0.  Real
// temp-file support requires writable storage on disk which the IIgs
// runtime doesn't provide by default.
FILE  *tmpfile(void);
char  *tmpnam(char *s);
#define L_tmpnam 16
#define TMP_MAX  1   // we can only produce 1 unique name (always fail)

#define SEEK_SET 0
#define SEEK_CUR 1
#define SEEK_END 2

#define EOF (-1)

int   getchar(void);
int   fgetc(FILE *stream);
char *fgets(char *buf, int n, FILE *stream);
int   ungetc(int c, FILE *stream);
#define getc(s) fgetc(s)

// scanf family — sscanf/vsscanf parse a string; fscanf/vfscanf parse
// from a FILE* via fgetc/ungetc.  scanf/vscanf read from stdin (which
// returns EOF on the IIgs because there is no integrated keyboard
// stdin) so they're rarely useful but the surface compiles.  Supports
// %d %i %u %x %X %o %s %c %ld %lu %lx %li %lo %% with optional `l`.
int sscanf (const char *str, const char *fmt, ...);
int vsscanf(const char *str, const char *fmt, va_list ap);
int fscanf (FILE *stream, const char *fmt, ...);
int vfscanf(FILE *stream, const char *fmt, va_list ap);
int scanf  (const char *fmt, ...);
int vscanf (const char *fmt, va_list ap);
void  rewind(FILE *stream);  // = fseek(s, 0, SEEK_SET) + clearerr

// Memory-backed FS: register a memory region as a named file so
// fopen can open it.  `cap` should be >= size; use cap > size for
// files that may grow on write.  `writable` controls whether
// fopen("...", "w") / "a" / "r+" succeeds.  Returns 0 on success,
// -1 on duplicate name or table full.
int  mfsRegister(const char *path, void *buf, size_t size, size_t cap,
                 int writable);
int  mfsUnregister(const char *path);

#endif