mirror of
https://github.com/gbdev/rgbds.git
synced 2025-11-20 18:22:07 +00:00
37089ef940
The old error stack was fairly obtuse and hard to use for debugging. This improves it notably by ensuring all line numbers are relative to the file, and not, say, the macro definition. This is a breaking change if you were parsing the old stack, but the change should be painless, and the new stack only brings more info. The syntax is unchanged for files, macros see their name prefixed with the file they're defined in and a pair of colors, REPT blocks simply append a '::REPT~n' to the context they're in, where 'n' is the number of iterations the REPT has done. This is especially helpful in macro-heavy code such as rgbds-structs.
92 lines
2.8 KiB
C
92 lines
2.8 KiB
C
/*
|
|
* This file is part of RGBDS.
|
|
*
|
|
* Copyright (c) 1997-2018, Carsten Sorensen and RGBDS contributors.
|
|
*
|
|
* SPDX-License-Identifier: MIT
|
|
*/
|
|
|
|
#ifndef RGBDS_SYMBOL_H
|
|
#define RGBDS_SYMBOL_H
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "types.h"
|
|
|
|
#define HASHSIZE (1 << 16)
|
|
#define MAXSYMLEN 256
|
|
|
|
struct sSymbol {
|
|
char tzName[MAXSYMLEN + 1];
|
|
int32_t nValue;
|
|
uint32_t nType;
|
|
struct sSymbol *pScope;
|
|
struct sSymbol *pNext;
|
|
struct Section *pSection;
|
|
uint32_t ulMacroSize;
|
|
char *pMacro;
|
|
int32_t (*Callback)(struct sSymbol *);
|
|
char tzFileName[_MAX_PATH + 1]; /* File where the symbol was defined. */
|
|
uint32_t nFileLine; /* Line where the symbol was defined. */
|
|
};
|
|
|
|
/* Symbol will be relocated during linking, it's absolute value is unknown */
|
|
#define SYMF_RELOC 0x001
|
|
/* Symbol is defined using EQU, will not be changed during linking */
|
|
#define SYMF_EQU 0x002
|
|
/* Symbol is (re)defined using SET, will not be changed during linking */
|
|
#define SYMF_SET 0x004
|
|
/* Symbol should be exported */
|
|
#define SYMF_EXPORT 0x008
|
|
/* Symbol referenced in RPN expression */
|
|
#define SYMF_REF 0x010
|
|
/* Symbol is a local symbol */
|
|
#define SYMF_LOCAL 0x020
|
|
/* Symbol has been defined, not only referenced */
|
|
#define SYMF_DEFINED 0x040
|
|
/* Symbol is a macro */
|
|
#define SYMF_MACRO 0x080
|
|
/* Symbol is a stringsymbol */
|
|
#define SYMF_STRING 0x100
|
|
/* Symbol has a constant value, will not be changed during linking */
|
|
#define SYMF_CONST 0x200
|
|
|
|
uint32_t sym_CalcHash(const char *s);
|
|
void sym_SetExportAll(uint8_t set);
|
|
void sym_AddLocalReloc(char *tzSym);
|
|
void sym_AddReloc(char *tzSym);
|
|
void sym_Export(char *tzSym);
|
|
void sym_PrintSymbolTable(void);
|
|
struct sSymbol *sym_FindMacro(char *s);
|
|
void sym_InitNewMacroArgs(void);
|
|
void sym_AddNewMacroArg(char *s);
|
|
void sym_SaveCurrentMacroArgs(char *save[]);
|
|
void sym_RestoreCurrentMacroArgs(char *save[]);
|
|
void sym_UseNewMacroArgs(void);
|
|
void sym_AddEqu(char *tzSym, int32_t value);
|
|
void sym_AddSet(char *tzSym, int32_t value);
|
|
void sym_Init(void);
|
|
uint32_t sym_GetConstantValue(char *s);
|
|
uint32_t sym_isConstant(char *s);
|
|
struct sSymbol *sym_FindSymbol(char *tzName);
|
|
char *sym_FindMacroArg(int32_t i);
|
|
char *sym_GetStringValue(char *tzSym);
|
|
void sym_UseCurrentMacroArgs(void);
|
|
void sym_SetMacroArgID(uint32_t nMacroCount);
|
|
uint32_t sym_isString(char *tzSym);
|
|
void sym_AddMacro(char *tzSym, int32_t nDefLineNo);
|
|
void sym_Ref(char *tzSym);
|
|
void sym_ShiftCurrentMacroArgs(void);
|
|
void sym_AddString(char *tzSym, char *tzValue);
|
|
uint32_t sym_GetDefinedValue(char *s);
|
|
uint32_t sym_isDefined(char *tzName);
|
|
void sym_Purge(char *tzName);
|
|
uint32_t sym_isConstDefined(char *tzName);
|
|
int32_t sym_IsRelocDiffDefined(char *tzSym1, char *tzSym2);
|
|
|
|
/* Functions to save and restore the current symbol scope. */
|
|
struct sSymbol *sym_GetCurrentSymbolScope(void);
|
|
void sym_SetCurrentSymbolScope(struct sSymbol *pNewScope);
|
|
|
|
#endif /* RGBDS_SYMBOL_H */
|