added note that null is returned on error