VectorAPI documentation: wrapIndex and wrapIndexes should not be called "validation function"

XMLWordPrintable

    • Type: Bug
    • Resolution: Unresolved
    • Priority: P4
    • None
    • Affects Version/s: 27
    • Component/s: core-libs

      Found while working on JDK-8369699.

      https://download.java.net/java/early_access/jdk26/docs/api/jdk.incubator.vector/jdk/incubator/vector/VectorShuffle.html#wrapIndex(int)

      While "checkIndex" and "checkIndexes" can be called "validation functions", it makes less sense for the "wrapIndex" and "wrapIndexes" counterparts. An suggested alternative could be "normalization function".

      [~psandoz] reacted like this when I brought it up:
      re: wrap index. I think it was a copying error, taking the same text from checkIndex - it should be normalized. We placed them on shuffle because they are very shuffle specific and compositionally they pair with the shuffle returning equivalents.

            Assignee:
            Xueming Shen
            Reporter:
            Emanuel Peter
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated: