Files
Sprinter-SDCC/libc/file/_file.h
T
snark13 60373930fb libc: Solid-C совместимость (П3) + rename/isatty (П4); scanf-семейство
- <dos.h>: getdate/gettime/setdate/settime (структуры Turbo-C, обёртки
  над getdatetime), getdisk/setdisk (ESTEX $02/$01), absread/abswrite
  (BIOS $55/$56, rst 8 — номера найдены в solid-c DOS.ASM; сектор 0 =
  boot логического диска)
- scanf/fscanf/sscanf: своё C-ядро _scanf_core (%d %u %x %o %c %s,
  модификатор l, ширина, подавление '*', %%); в SDCC z80 scanf нет,
  asm solid-c не портируем из-за чужого ABI; 22 хост-теста ядра
- хвост П2: fdopen/freopen/fclosall/fgetpos/fsetpos поверх таблицы
  FILE; парсер режима и выдача слота вынесены в _file_mode/_file_slot
- rename() — ESTEX RENAME $10; isatty(fd) = fd <= 0 (tty только
  псевдо-fd 0/-1/-2: из CLI DSS манипуляторы идут с 1 — verified,
  fd 1 не резерв, под Flex Navigator его держит навигатор)
- errno.h: Solid-C имена ошибок (EZERO/EINVFNC/ENOFILE/...) как алиасы
- <sprinter_solid.h> — зонтичный заголовок для портирования;
  ltell/_setargv в sprinter_compat.h; div/ldiv — из SDCC (проверено)
- tests/solidt — smoke всех П3/П4 API, зелёный в MAME (вкл. absread
  boot-сектора с сигнатурой 55AA)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 16:35:58 +03:00

51 lines
2.8 KiB
C

/*
* _file.h — внутренности буферизованного FILE* (вариант B+, НЕ
* публичный заголовок). Дизайн: docs/file-buffering-design.md.
*
* Инварианты:
* - слот таблицы свободен, когда flags == 0;
* - level < BUFSIZ на входе в любую операцию записи (конвенция
* «сброс ПЕРЕД записью в буфер»);
* - hold != EOF означает отложенный байт ungetc; логическая позиция
* потока на 1 меньше учтённой в level;
* - консольные псевдопотоки (_F_CONIN/_F_CONOUT) буфер не заводят
* и в _file_sync не попадают.
*/
#ifndef _FILE_INTERNAL_H
#define _FILE_INTERNAL_H
#include <stdio.h>
/* Таблица потоков (_file_slots.c); свободный слот: flags == 0. */
extern FILE _file_slots[OPEN_MAX];
/* Найти свободный слот и взвести atexit(_fclosall) при первом
* использовании. Слот НЕ помечается занятым — вызывающий заполняет
* поля и последним ставит flags. NULL + errno=EMFILE, если все
* заняты. (_file_slot.c; используют fopen и fdopen.) */
FILE *_file_slot_take(void);
/* Транслировать строку режима fopen ("r/w/a", '+' в любом месте
* хвоста, 'b'/'t' игнорируются) в флаги open() (возврат) и наши
* _F_-флаги (*ff). -1 + errno=EINVAL при плохом режиме.
* (_file_mode.c; используют fopen, fdopen, freopen.) */
int _file_mode_flags(const char *mode, uint8_t *ff);
/* Обеспечить буфер: вернуть fp->buf, при необходимости malloc(BUFSIZ).
* NULL = malloc не дал — вызывающий уходит на небуферизованный путь
* (прямой syscall на 1 байт), поток продолжает работать. */
uint8_t *_file_buf(FILE *fp);
/* Нейтрализовать буфер (перед seek/tell/close и при смене направления):
* - направление «запись»: write() несброшенного хвоста;
* - направление «чтение»: lseek(fd, -(level + hold), SEEK_CUR) —
* откат непрочитанного readahead и ungetc-байта.
* После вызова: level = 0, hold = EOF, _F_DIROUT снят, curp = buf.
* Возврат 0 или EOF (ставит _F_ERROR). */
int _file_sync(FILE *fp);
/* fclose всех открытых слотов; вешается на atexit первым fopen. */
void _fclosall(void);
#endif