code: private static boolean advanceToFind(Iterator<?> iterator, Object value) {
      while (iterator.hasNext()) {
        if (Objects.equal(iterator.next(), value)) {
          return true;
        }
      }
      return false;
    }
docs: Advances the iterator until it either returns value, or has no more elements.
  
  <p>Returns true if the value was found, false if the end was reached before finding it.
  
  <p>This is basically the same as {@link Iterables#contains}, but where the contract explicitly
  states that the iterator isn't advanced beyond the value if the value is found.