symrepr.h File Reference

#include <stdint.h>
#include <stdbool.h>
#include "lbm_types.h"
#include "lbm_defines.h"

Include dependency graph for symrepr.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef void(*	symrepr_name_iterator_fun) (const char *)

Functions
void	lbm_symrepr_set_symlist (lbm_uint *ls)
bool	store_symbol_name_flash (char *name, lbm_uint *res)
int	lbm_symrepr_init (void)
void	lbm_symrepr_name_iterator (symrepr_name_iterator_fun f)
int	lbm_add_symbol_base (char *name, lbm_uint *id)
int	lbm_add_symbol (char *name, lbm_uint *id)
int	lbm_str_to_symbol (char *name, lbm_uint *sym_id)
int	lbm_add_symbol_const_base (char *name, lbm_uint *id, bool link)
int	lbm_add_symbol_const (char *name, lbm_uint *id)
lbm_uint *	lbm_get_symbol_list_entry_by_name (char *name)
int	lbm_get_symbol_by_name (char *name, lbm_uint *id)
const char *	lbm_get_name_by_symbol (lbm_uint id)
lbm_uint	lbm_get_symbol_table_size (void)
lbm_uint	lbm_get_symbol_table_size_flash (void)
lbm_uint	lbm_get_symbol_table_size_names (void)
lbm_uint	lbm_get_symbol_table_size_names_flash (void)
bool	lbm_symbol_in_flash (char *str)
bool	lbm_symbol_list_entry_in_flash (char *str)

Variables
lbm_value	symbol_x
lbm_value	symbol_y
lbm_value	symbol_rest_args

Detailed Description

symrepr.h implements the symbol table and symbol creation and lookup functions.

The symbol table is implemented as a linked list in the arrays and symbols memory defined in lispbm_memory.h. So lbm_memory_init must be run before the symbol table is initialized and used.

Typedef Documentation

symrepr_name_iterator_fun

typedef void(* symrepr_name_iterator_fun) (const char *)

Function Documentation

lbm_add_symbol()

int lbm_add_symbol	(	char *	name,
		lbm_uint *	id
	)

Add a symbol to the symbol table. The symbol name string is copied to arrays and symbols memory.

Parameters

name	String representation of the symbol.
id	Resulting id is returned through this argument.

Returns

1 for success and 0 for failure.

lbm_add_symbol_base()

int lbm_add_symbol_base	(	char *	name,
		lbm_uint *	id
	)

lbm_add_symbol_const()

int lbm_add_symbol_const	(	char *	name,
		lbm_uint *	id
	)

Add a symbol to the symbol table. The name is assumed to be a statically allocated string.

Parameters

name	Statically allocated name string.
id	Resulting id is returned through this argument.

Returns

1 for success and 0 for failure.

lbm_add_symbol_const_base()

int lbm_add_symbol_const_base	(	char *	name,
		lbm_uint *	id,
		bool	link
	)

Add a symbol to the symbol table. The name is assumed to be a statically allocated string.

Parameters

name	Statically allocated name string.
id	Resulting id is returned through this argument.
link	If The variable assigned the ID is restored upon an image-boot.

Returns

1 for success and 0 for failure.

lbm_get_name_by_symbol()

const char * lbm_get_name_by_symbol

(

lbm_uint

id

)

Look up a symbol name from the symbol table given an id.

Parameters

id	The id to look up in the symbol table.

Returns

pointer to the name string if success otherwise NULL.

lbm_get_symbol_by_name()

int lbm_get_symbol_by_name	(	char *	name,
		lbm_uint *	id
	)

Look up an id from the symbol table given a name.

Parameters

name	Name string to look up.
id	Resulting id is returned through this argument.

Returns

1 on success (name was found) and 0 for failure.

lbm_get_symbol_list_entry_by_name()

lbm_uint * lbm_get_symbol_list_entry_by_name

(

char *

name

)

Get a pointer to the list entry holding a symbol name, id mapping.

Parameters

name	Name string to look up.

Returns

Pointer to list entry or NULL.

lbm_get_symbol_table_size()

lbm_uint lbm_get_symbol_table_size

(

void

)

Returns

The total amount of lbm_memory space occupied by the symbol table in bytes.

lbm_get_symbol_table_size_flash()

lbm_uint lbm_get_symbol_table_size_flash

(

void

)

Returns

The total amount of flash space occupied by the symbol table in bytes.

lbm_get_symbol_table_size_names()

lbm_uint lbm_get_symbol_table_size_names

(

void

)

Returns

The size in bytes of all symbol strings stored in the symbol table.

lbm_get_symbol_table_size_names_flash()

lbm_uint lbm_get_symbol_table_size_names_flash

(

void

)

Returns

The size in bytes of all symbol strings stored in flash from the symbol table.

lbm_str_to_symbol()

int lbm_str_to_symbol	(	char *	name,
		lbm_uint *	sym_id
	)

Name of symbol to symbol. If the symbol exists the ID of the symbol is returned. If the name does not match any existing symbol, one is created and that ID is returned.

Parameters

name	String name of symbol.
id	Resulting ID is returned through this argument.

Returns

1 for success and 0 for failure.

lbm_symbol_in_flash()

bool lbm_symbol_in_flash

(

char *

str

)

Check if a symbol name is stored in flash.

Parameters

str	Symbol name string.

Returns

True if symbol name is stored in flash, otherwise False.

lbm_symbol_list_entry_in_flash()

bool lbm_symbol_list_entry_in_flash

(

char *

str

)

Check if a symbol name id mapping list entry is stored in flash.

Parameters

str	Symbol name string.

Returns

True if symbol name/id mapping list entry is stored in flash, otherwise False.

lbm_symrepr_init()

int lbm_symrepr_init

(

void

)

Initialize the symbol table.

Returns

1

lbm_symrepr_name_iterator()

void lbm_symrepr_name_iterator

(

symrepr_name_iterator_fun

f

)

Iterate over all symbol names as strings

Parameters

symrepr_name_iterator_fun

function taking a string

lbm_symrepr_set_symlist()

void lbm_symrepr_set_symlist

(

lbm_uint *

ls

)

Sets the symlist root element.

Parameters

ls	Root element to set as the symlist.

store_symbol_name_flash()

bool store_symbol_name_flash	(	char *	name,
		lbm_uint *	res
	)

Store a symbol name on the constant heap (flash).

Parameters

name	Symbol name.
res	Pointer where result address in flash is returned.

Returns

true on success and false otherwise.

Variable Documentation

symbol_rest_args

lbm_value symbol_rest_args

extern

symbol_x

lbm_value symbol_x

extern

symbol_y

lbm_value symbol_y

extern