bool runic_atom_read(runic_obj_t ro, char* c);

The above function signature outlines the operation for reading the value of an ATOM.

Arguments:

ro – A runic_obj_t object which is of type ATOM that was returned as a result of a successful runic_root() or any runic_alloc operation. Attempting to use any other object is an invalid operation. The program will almost certainly return false and the input buffer will remain unaltered. Attempting read from an invalid runic_obj_t is not encouraged.

c – A buffer with space enough to read the contents of ro. If the buffer is too small, it is undefined behavior. The program may fail.

Returns:

On a success, the ATOM value of ro is deposited into the buffer c, and the function returns true. On a failure, the function returns false.