runic_obj_t runic_alloc_atom_str(runic_t* r, const char* value);

The above function signature outlines the operation regarding allocating an ATOM with a length equal to the string passed in argument value. The argument is then written to the atom. This is a compound function which uses runic_alloc_atom() and runic_atom_write().

Arguments:

r – A runic_t object that was returned as a result of a successful open operation. Attempting to use any other object is an invalid operation. The program will almost certainly return an invalid runic_obj_t. Attempting to allocate objects with invalid runic_t objects is not encouraged.

value – A null-terminated c-string which is less than 255 bytes long. Using a string of a larger size will cause this operation to fail, print to console, and return an invalid runic_obj_t.

Returns:

A runic_obj_t object which is of type ATOM and contains the string described in value. In the event that file memory is full, no objects can be garbage collected, and there is no additional disk space, this operation may fail. If so, the runic_obj_t returned will have an offset of 0 and a base pointer equal to NULL.