readme example functions and returned values