From d367918916baf9290816aa8657cc78878b68c1ef Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sat, 22 Nov 2014 12:10:37 +0100 Subject: Starting on some rework MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- src/mds-kbdc/parsed.h | 144 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 144 insertions(+) create mode 100644 src/mds-kbdc/parsed.h (limited to 'src/mds-kbdc/parsed.h') diff --git a/src/mds-kbdc/parsed.h b/src/mds-kbdc/parsed.h new file mode 100644 index 0000000..d16af62 --- /dev/null +++ b/src/mds-kbdc/parsed.h @@ -0,0 +1,144 @@ +/** + * mds — A micro-display server + * Copyright © 2014 Mattias Andrée (maandree@member.fsf.org) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ +#ifndef MDS_MDS_KBDC_PARSED_H +#define MDS_MDS_KBDC_PARSED_H + + +#include "tree.h" +#include "raw-data.h" +#include "parse-error.h" + +#include + +#include +#include + + + + +/** + * @param RESULT:mds_kbdc_parsed_t* The parsing result + * @param SEVERITY:int * in `MDS_KBDC_PARSE_ERROR_*` to indicate severity + * @param ERROR_IS_IN_FILE:int Whether the error is in the layout code + * @param LINE:size_t The line where the error occurred, zero-based + * @param START:size_t The byte where the error started, on the line, inclusive, zero-based + * @param END:size_t The byte where the error ended, on the line, exclusive, zero-based + * @param ...:const char*, ... Error description format string and arguments + * @scope error:mds_kbdc_parse_error_t* Variable where the new error will be stored + */ +#define NEW_ERROR_(RESULT, SEVERITY, ERROR_IS_IN_FILE, LINE, START, END, ...) \ + do \ + { \ + error = mds_kbdc_parsed_new_error(RESULT, SEVERITY, ERROR_IS_IN_FILE, LINE, START, END); \ + fail_if (error == NULL); \ + fail_if (xasprintf(error->description, __VA_ARGS__)); \ + } \ + while (0) + + + +/** + * Structure with parsed tree, error list + * source code and the file's pathname + */ +typedef struct mds_kbdc_parsed +{ + /** + * The parsed tree + */ + mds_kbdc_tree_t* tree; + + /** + * The source code of the parsed file + */ + mds_kbdc_source_code_t* source_code; + + /** + * A non-relative pathname to the parsed file. + * Relative filenames can be misleading as the + * program can have changed working directory + * to be able to resolve filenames. + */ + char* pathname; + + /** + * `NULL`-terminated list of found errors + * `NULL` if no errors that could be listed + * were found + */ + mds_kbdc_parse_error_t** errors; + + /** + * The number of elements allocated to `errors` + */ + size_t errors_size; + + /** + * The number of elements stored in `errors` + */ + size_t errors_ptr; + + /** + * The level of the severest countered error, + * 0 if none has been encountered. + */ + int severest_error_level; + +} mds_kbdc_parsed_t; + + + +/** + * Initialise a `mds_kbdc_parsed_t*` + * + * @param this The `mds_kbdc_parsed_t*` + */ +void mds_kbdc_parsed_initialise(mds_kbdc_parsed_t* restrict this); + +/** + * Release all resources allocated in a `mds_kbdc_parsed_t*` + * + * @param this The `mds_kbdc_parsed_t*` + */ +void mds_kbdc_parsed_destroy(mds_kbdc_parsed_t* restrict this); + +/** + * Print all encountered errors + * + * @param this The parsing result + * @param output The output file + */ +void mds_kbdc_parsed_print_errors(mds_kbdc_parsed_t* restrict this, FILE* output); + +/** + * Add a new error to the list + * + * @param this The parsing result + * @param severity A `MDS_KBDC_PARSE_ERROR_*` to indicate severity + * @param error_is_in_file Whether the error is in the layout code + * @param line The line where the error occurred, zero-based + * @param start The byte where the error started, on the line, inclusive, zero-based + * @param end The byte where the error ended, on the line, exclusive, zero-based + * @return The new error on success, `NULL` on error + */ +mds_kbdc_parse_error_t* mds_kbdc_parsed_new_error(mds_kbdc_parsed_t* restrict this, int severity, + int error_is_in_file, size_t line, size_t start, size_t end); + + +#endif + -- cgit v1.2.3-70-g09d2