improve example search functions
update README with new macro and example