Sample

int-8094fc88b801-I13

Lower every eligible classic and enhanced for loop to a while loop

Matched original source

Lines82

Scores

MethodScoreScale
Posnett0.0460–1; higher is more readable
Scalabrino0.8530–1; higher is more readable
Dorn0.7660–1; higher is more readable
Mi0.3820–1; higher is more readable
LLOC15Logical lines; fewer is more readable
DeepSeek V4 Pro180–20; mean of three runs
GPT-6.1 Sol190–20; mean of three runs
BTTF0.6870–1; higher is more readable

Views

Source code

package com.google.common.io; import com.google.common.annotations.GwtIncompatible; import com.google.common.annotations.J2ktIncompatible; import com.google.errorprone.annotations.CanIgnoreReturnValue; import java.io.DataInput; import java.io.IOException; import org.jspecify.annotations.Nullable; /** * An extension of {@code DataInput} for reading from in-memory byte arrays; its methods offer * identical functionality but do not throw {@link IOException}. * * <p><b>Warning:</b> The caller is responsible for not attempting to read past the end of the * array. If any method encounters the end of the array prematurely, it throws {@link * IllegalStateException} to signify <i>programmer error</i>. This behavior is a technical violation * of the supertype's contract, which specifies a checked exception. * * @author Kevin Bourrillion * @since 1.0 */ @J2ktIncompatible @GwtIncompatible public interface ByteArrayDataInput extends DataInput { @Override void readFully(byte[] b); @Override void readFully(byte[] b, int off, int len); // not guaranteed to skip n bytes so result should NOT be ignored // use ByteStreams.skipFully or one of the read methods instead @Override int skipBytes(int n); @CanIgnoreReturnValue // to skip a byte @Override boolean readBoolean(); @CanIgnoreReturnValue // to skip a byte @Override byte readByte(); @CanIgnoreReturnValue // to skip a byte @Override int readUnsignedByte(); @CanIgnoreReturnValue // to skip some bytes @Override short readShort(); @CanIgnoreReturnValue // to skip some bytes @Override int readUnsignedShort(); @CanIgnoreReturnValue // to skip some bytes @Override char readChar(); @CanIgnoreReturnValue // to skip some bytes @Override int readInt(); @CanIgnoreReturnValue // to skip some bytes @Override long readLong(); @CanIgnoreReturnValue // to skip some bytes @Override float readFloat(); @CanIgnoreReturnValue // to skip some bytes @Override double readDouble(); @CanIgnoreReturnValue // to skip a line @Override @Nullable String readLine(); @CanIgnoreReturnValue // to skip a field @Override String readUTF(); }

Loading feature diagnosis…

Source regions

Feature contributions

Feature contributions

FeatureValueContribution
(log-odds)
Halstead volumeHow much symbolic information the code contains. It combines the total number of operators and values with the number of distinct ones.1135.35−37.467
Source linesThe number of non-empty source lines.82+32.8
Byte entropyHow varied the bytes in the source text are. Repeated bytes give a lower value; a more even mixture gives a higher value.4.828−7.241

Intercept 8.87 + feature contributions = -3.038 (log-odds).
Score = sigmoid(-3.038) = 0.046.

Score0.853

Feature contributions

FeatureValueContribution
(log-odds)
Comment layout frequencyHow frequently the layout switches between lines containing only comments or whitespace and lines containing code.83−1.902
Indentation frequencyHow rapidly indentation changes from line to line.57+1.234
Comment layout (horizontal)How rapidly the visual pattern of comment characters changes from left to right.98.699+0.788
Identifier layout (vertical)How rapidly the visual pattern of identifier characters changes from top to bottom.81.832+0.734
Identifier layout (horizontal)How rapidly the visual pattern of identifier characters changes from left to right. It measures spatial frequency, not the meaning of the names.99.88−0.565
Operator visual areaThe share of the code’s visual area occupied by operators such as +, =, and *.0.053+0.431
Number layout frequencyHow rapidly the number of numeric values per line changes through the code.1+0.398

Intercept 0.07 + feature contributions = 1.188 (log-odds).
Score = sigmoid(1.188) = 0.766.

Score0.382
Score15
Run 1

The code is highly readable due to its logical structure and clear intent. The interface declaration is straightforward, with a concise yet informative Javadoc explaining the behavior and contract deviations. Method declarations are flat, with no nesting, and each method is presented on a single line, making the structure easy to scan. The use of @Override and @CanIgnoreReturnValue annotations is consistent, and the brief comments for each method clarify the intended use when return values are ignored. Imports are organized and limited. The code avoids unnecessary length, with only essential methods and documentation. Reading flow is natural, grouping related read methods logically. Overall, this is an exemplary implementation of a well-documented, minimal interface.

Run 2

The code is highly readable due to its clear logical organization, flat structure, and concise method declarations. The interface extends DataInput with a well-documented purpose, explaining the behavioral difference (no IOException, IllegalStateException for programmer errors) in a clear Javadoc. Each method is declared on a single line with @Override and @CanIgnoreReturnValue annotations, maintaining one action per line and consistent formatting. The comments on skipBytes and return-value annotations clarify intent without adding unnecessary verbosity. The only minor deduction is the repetition of @CanIgnoreReturnValue comments, which could be slightly condensed, but this repetition aids in documenting each method's purpose. Overall, the code is structured for immediate comprehension.

Run 3

This code is highly readable. It has a clear, logical structure: imports are grouped, followed by a comprehensive Javadoc explaining the class's purpose and its exception behavior. The interface extends DataInput with straightforward method declarations. Nesting is non-existent—the code is completely flat. Clarity of intent is strong; each override method is documented with a concise comment explaining the return value's purpose (e.g., 'to skip a byte'), which is particularly helpful for methods with ignorable return values. Code length is appropriate, not unnecessarily verbose, with each method declaration on a single line. Action granularity is one method per line, making it easy to scan. Reading flow is natural, progressing from class-level documentation to individual method signatures in a predictable order. The only minor drawback is the repetitive comment style for methods, but this is a common and acceptable pattern for interface documentation. Overall, the code is an exemplary model of readable Java interface design.

Run 1

Code Structure: The interface is logically organized, with imports, documentation, annotations, and related method declarations clearly separated. Nesting: Only the interface scope is present, so the code is effectively flat. Clarity of intent: The Javadoc clearly explains the purpose and exception behavior; standard DataInput method names and targeted comments reinforce intent. Code length: Concise for the API it defines, although repeated annotations and similar comments add minor visual repetition. Action granularity: Each method declaration occupies its own line, with annotations consistently separated; there are no bundled actions. Reading flow: Consistent formatting and progression from bulk reads to primitive and string reads make scanning natural. Minor drawbacks include abbreviated parameter names and the lack of a blank line after the package declaration.

Run 2

Code Structure: Well-organized interface with consistently formatted declarations and logically grouped reading methods. Nesting: Flat, with no nested control flow. Clarity of intent: Interface documentation clearly explains its purpose and exception behavior; standard method names and annotations reinforce the contract. Code length: Concise for the required API, although repeated annotations and skip comments add minor visual repetition. Action granularity: Each method declaration occupies its own line, with annotations separated consistently; no bundled operations. Reading flow: Predictable ordering and spacing make the interface easy to scan. Minor shortcomings include abbreviated parameter names and the lack of separation between the package declaration and imports.

Run 3

Code Structure: A well-organized interface with consistent spacing and logically ordered method declarations. Nesting: Completely flat apart from the interface scope, making scanning easy. Clarity of intent: The documentation clearly explains the purpose, exception behavior, and caller responsibilities; annotations and comments clarify return-value handling. Abbreviated parameter names slightly reduce clarity. Code length: Concise for the API it exposes; repeated annotations are appropriate rather than unnecessary verbosity. Action granularity: Each declaration occupies its own line, with no bundled operations. Reading flow: Consistent formatting and progression through read methods support natural reading, though separating the package declaration from imports would improve visual organization.