1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148
|
/*
* BRLTTY - A background process providing access to the console screen (when in
* text mode) for a blind person using a refreshable braille display.
*
* Copyright (C) 1995-2014 by The BRLTTY Developers.
*
* BRLTTY comes with ABSOLUTELY NO WARRANTY.
*
* This is free software, placed under the terms of the
* GNU General Public License, as published by the Free Software
* Foundation; either version 2 of the License, or (at your option) any
* later version. Please see the file LICENSE-GPL for details.
*
* Web Page: http://mielke.cc/brltty/
*
* This software is maintained by Dave Mielke <dave@mielke.cc>.
*/
#ifndef BRLTTY_INCLUDED_DATAFILE
#define BRLTTY_INCLUDED_DATAFILE
#include <stdio.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
extern int setGlobalDataVariable (const char *name, const char *value);
extern int setGlobalTableVariables (const char *tableExtension, const char *subtableExtension);
extern FILE *openDataFile (const char *path, const char *mode, int optional);
typedef struct DataFileStruct DataFile;
#define DATA_OPERANDS_PROCESSOR(name) int name (DataFile *file, void *data)
typedef DATA_OPERANDS_PROCESSOR(DataOperandsProcessor);
extern int processDataFile (const char *name, DataOperandsProcessor *processLine, void *data);
extern void reportDataError (DataFile *file, char *format, ...) PRINTF(2, 3);
extern int processDataStream (
DataFile *includer,
FILE *stream, const char *name,
DataOperandsProcessor *processLine, void *data
);
extern int compareKeyword (const wchar_t *keyword, const wchar_t *characters, size_t count);
extern int compareKeywords (const wchar_t *keyword1, const wchar_t *keyword2);
extern int isKeyword (const wchar_t *keyword, const wchar_t *characters, size_t count);
extern int isNumber (int *number, const wchar_t *characters, int length);
extern int isHexadecimalDigit (wchar_t character, int *value, int *shift);
extern int isOctalDigit (wchar_t character, int *value, int *shift);
extern int findDataOperand (DataFile *file, const char *description);
extern int getDataCharacter (DataFile *file, wchar_t *character);
extern int ungetDataCharacters (DataFile *file, unsigned int count);
typedef struct {
const wchar_t *characters;
unsigned int length;
} DataOperand;
extern int getDataOperand (DataFile *file, DataOperand *operand, const char *description);
extern int getDataText (DataFile *file, DataOperand *text, const char *description);
typedef struct {
unsigned char length;
wchar_t characters[0XFF];
} DataString;
extern int parseDataString (DataFile *file, DataString *string, const wchar_t *characters, int length, int noUnicode);
extern int getDataString (DataFile *file, DataString *string, int noUnicode, const char *description);
extern int writeHexadecimalCharacter (FILE *stream, wchar_t character);
extern int writeEscapedCharacter (FILE *stream, wchar_t character);
extern int writeEscapedCharacters (FILE *stream, const wchar_t *characters, size_t count);
typedef struct {
unsigned char length;
unsigned char bytes[0XFF];
} ByteOperand;
#define CELLS_OPERAND_DELIMITER WC_C('-')
#define CELLS_OPERAND_SPACE WC_C('0')
extern int parseCellsOperand (DataFile *file, ByteOperand *cells, const wchar_t *characters, int length);
extern int getCellsOperand (DataFile *file, ByteOperand *cells, const char *description);
extern int writeDots (FILE *stream, unsigned char cell);
extern int writeDotsCell (FILE *stream, unsigned char cell);
extern int writeDotsCells (FILE *stream, const unsigned char *cells, size_t count);
extern int writeUtf8Cell (FILE *stream, unsigned char cell);
extern int writeUtf8Cells (FILE *stream, const unsigned char *cells, size_t count);
typedef struct {
const wchar_t *name;
DataOperandsProcessor *processor;
unsigned unconditional:1;
} DataDirective;
extern int processDirectiveOperand (DataFile *file, const DataDirective *directives, const char *description, void *data);
#define DATA_CONDITION_TESTER(name) int name (DataFile *file, const DataOperand *identifier, void *data)
typedef DATA_CONDITION_TESTER(DataConditionTester);
extern int processConditionOperands (
DataFile *file,
DataConditionTester *testCondition, int negateCondition,
const char *description, void *data
);
extern int processIncludeOperands (DataFile *file, void *data);
extern int includeDataFile (DataFile *file, const wchar_t *name, unsigned int length);
#define DATA_NESTING_DIRECTIVES \
{.name=WS_C("include"), .processor=processIncludeOperands}
extern int processElseOperands (DataFile *file, void *data);
extern int processEndIfOperands (DataFile *file, void *data);
#define DATA_CONDITION_DIRECTIVES \
{.name=WS_C("else"), .processor=processElseOperands, .unconditional=1}, \
{.name=WS_C("endif"), .processor=processEndIfOperands, .unconditional=1}
extern int processIfVarOperands (DataFile *file, void *data);
extern int processIfNotVarOperands (DataFile *file, void *data);
extern int processAssignOperands (DataFile *file, void *data);
#define DATA_VARIABLE_DIRECTIVES \
{.name=WS_C("ifvar"), .processor=processIfVarOperands, .unconditional=1}, \
{.name=WS_C("ifnotvar"), .processor=processIfNotVarOperands, .unconditional=1}, \
{.name=WS_C("assign"), .processor=processAssignOperands}
#define BRL_DOT_COUNT 8
extern const wchar_t brlDotNumbers[BRL_DOT_COUNT];
extern const unsigned char brlDotBits[BRL_DOT_COUNT];
extern int brlDotNumberToIndex (wchar_t number, int *index);
extern int brlDotBitToIndex (unsigned char bit, int *index);
extern int getDotOperand (DataFile *file, int *index);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* BRLTTY_INCLUDED_DATAFILE */
|