cs432_2024_08/p1-docs/token_8h_source.html

 #ifndef __TOKENS_H

 #define __TOKENS_H


 #include "common.h"


 typedef regex_t Regex;


 Regex* Regex_new (const char* regex);


 bool Regex_match (Regex *regex, const char *text, char *match);


 void Regex_free (Regex* regex);


 typedef enum TokenType {

     ID, DECLIT, HEXLIT, STRLIT, KEY, SYM

 } TokenType;


 typedef struct Token

 {

     TokenType type;


     char text[MAX_TOKEN_LEN];


     int line;


     struct Token* next;


 } Token;


 const char* TokenType_to_string(TokenType type);


 bool token_str_eq(const char* str1, const char* str2);


 Token* Token_new (TokenType type, const char* text, int line);


 void Token_free (Token* token);


 typedef struct TokenQueue

 {

     Token* head;


     Token* tail;


 } TokenQueue;


 TokenQueue* TokenQueue_new ();


 void TokenQueue_add (TokenQueue* queue, Token* token);


 Token* TokenQueue_peek (TokenQueue* queue);


 Token* TokenQueue_remove (TokenQueue* queue);


 bool TokenQueue_is_empty (TokenQueue* queue);


 size_t TokenQueue_size (TokenQueue* queue);


 void TokenQueue_print (TokenQueue* queue, FILE* out);


 void TokenQueue_free (TokenQueue* queue);


 #endif

common.h
Includes, constants, declarations, and macros used across the compiler.

MAX_TOKEN_LEN
#define MAX_TOKEN_LEN
Maximum length (in characters) of any single token.
Definition: common.h:47

Token
Single token.
Definition: token.h:79

Token::next
struct Token * next
Pointer to next token (used to store in a list)
Definition: token.h:98

Token::line
int line
Source line number.
Definition: token.h:93

Token::type
TokenType type
Type of the token.
Definition: token.h:83

Token::text
char text[256]
Raw text of the token.
Definition: token.h:88

TokenQueue
Linked list of tokens.
Definition: token.h:153

TokenQueue::tail
Token * tail
Back of list (or NULL if list is empty)
Definition: token.h:162

TokenQueue::head
Token * head
Front of list (or NULL if list is empty)
Definition: token.h:157

TokenQueue_remove
Token * TokenQueue_remove(TokenQueue *queue)
Remove a token from a queue (first-in-first-out)
Definition: token.c:90

TokenQueue_print
void TokenQueue_print(TokenQueue *queue, FILE *out)
Print a queue to the given file descriptor (debug output)
Definition: token.c:120

TokenType_to_string
const char * TokenType_to_string(TokenType type)
Convert a token type to a string for output.
Definition: token.c:31

TokenQueue_size
size_t TokenQueue_size(TokenQueue *queue)
Calculate size of the queue.
Definition: token.c:111

TokenQueue_peek
Token * TokenQueue_peek(TokenQueue *queue)
Return the next token from a queue without removing it (first-in-first-out)
Definition: token.c:85

Token_new
Token * Token_new(TokenType type, const char *text, int line)
Allocate and initialize a new token.
Definition: token.c:49

Token_free
void Token_free(Token *token)
Deallocate a token.
Definition: token.c:60

TokenQueue_new
TokenQueue * TokenQueue_new()
Allocate and initialize a new, empty queue of tokens.
Definition: token.c:65

Regex_match
bool Regex_match(Regex *regex, const char *text, char *match)
Match a regular expression against some text.
Definition: token.c:12

TokenQueue_free
void TokenQueue_free(TokenQueue *queue)
Deallocate a token queue.
Definition: token.c:129

token_str_eq
bool token_str_eq(const char *str1, const char *str2)
Check string equality for tokens. Limits comparison to MAX_TOKEN_LEN for safety.
Definition: token.c:44

TokenQueue_is_empty
bool TokenQueue_is_empty(TokenQueue *queue)
Check whether a queue is empty.
Definition: token.c:106

TokenType
TokenType
Valid token types.
Definition: token.h:69

Regex
regex_t Regex
Compiled regular expression.
Definition: token.h:25

Regex_free
void Regex_free(Regex *regex)
Deallocate a regular expression.
Definition: token.c:25

Token
struct Token Token
Single token.

TokenQueue
struct TokenQueue TokenQueue
Linked list of tokens.

TokenQueue_add
void TokenQueue_add(TokenQueue *queue, Token *token)
Add a token to a queue.
Definition: token.c:72

Regex_new
Regex * Regex_new(const char *regex)
Allocate and compile a new regular expression.
Definition: token.c:3