This is an automated email from the ASF dual-hosted git repository. aherbert pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-lang.git
commit 0cfc31b98778767cb2f8db93bc2f488abe058e2e Author: aherbert <aherb...@apache.org> AuthorDate: Fri Mar 5 11:46:15 2021 +0000 Fix formatting --- .../java/org/apache/commons/lang3/Streams.java | 12 +- .../java/org/apache/commons/lang3/StringUtils.java | 52 ++--- .../java/org/apache/commons/lang3/Validate.java | 216 ++++++++++----------- .../org/apache/commons/lang3/math/NumberUtils.java | 4 +- 4 files changed, 142 insertions(+), 142 deletions(-) diff --git a/src/main/java/org/apache/commons/lang3/Streams.java b/src/main/java/org/apache/commons/lang3/Streams.java index 258b9a2..8e27558 100644 --- a/src/main/java/org/apache/commons/lang3/Streams.java +++ b/src/main/java/org/apache/commons/lang3/Streams.java @@ -67,12 +67,12 @@ import org.apache.commons.lang3.Functions.FailablePredicate; @Deprecated public class Streams { - /** - * A reduced, and simplified version of a {@link Stream} with - * failable method signatures. - * @param <O> The streams element type. - * @deprecated Use {@link org.apache.commons.lang3.stream.Streams.FailableStream}. - */ + /** + * A reduced, and simplified version of a {@link Stream} with + * failable method signatures. + * @param <O> The streams element type. + * @deprecated Use {@link org.apache.commons.lang3.stream.Streams.FailableStream}. + */ @Deprecated public static class FailableStream<O extends Object> { diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java b/src/main/java/org/apache/commons/lang3/StringUtils.java index 284c202..056b167 100644 --- a/src/main/java/org/apache/commons/lang3/StringUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringUtils.java @@ -6923,32 +6923,32 @@ public class StringUtils { } /** - * <p>Case insensitively replaces all occurrences of a String within another String.</p> - * - * <p>A {@code null} reference passed to this method is a no-op.</p> - * - * <pre> - * StringUtils.replaceIgnoreCase(null, *, *) = null - * StringUtils.replaceIgnoreCase("", *, *) = "" - * StringUtils.replaceIgnoreCase("any", null, *) = "any" - * StringUtils.replaceIgnoreCase("any", *, null) = "any" - * StringUtils.replaceIgnoreCase("any", "", *) = "any" - * StringUtils.replaceIgnoreCase("aba", "a", null) = "aba" - * StringUtils.replaceIgnoreCase("abA", "A", "") = "b" - * StringUtils.replaceIgnoreCase("aba", "A", "z") = "zbz" - * </pre> - * - * @see #replaceIgnoreCase(String text, String searchString, String replacement, int max) - * @param text text to search and replace in, may be null - * @param searchString the String to search for (case insensitive), may be null - * @param replacement the String to replace it with, may be null - * @return the text with any replacements processed, - * {@code null} if null String input - * @since 3.5 - */ - public static String replaceIgnoreCase(final String text, final String searchString, final String replacement) { - return replaceIgnoreCase(text, searchString, replacement, -1); - } + * <p>Case insensitively replaces all occurrences of a String within another String.</p> + * + * <p>A {@code null} reference passed to this method is a no-op.</p> + * + * <pre> + * StringUtils.replaceIgnoreCase(null, *, *) = null + * StringUtils.replaceIgnoreCase("", *, *) = "" + * StringUtils.replaceIgnoreCase("any", null, *) = "any" + * StringUtils.replaceIgnoreCase("any", *, null) = "any" + * StringUtils.replaceIgnoreCase("any", "", *) = "any" + * StringUtils.replaceIgnoreCase("aba", "a", null) = "aba" + * StringUtils.replaceIgnoreCase("abA", "A", "") = "b" + * StringUtils.replaceIgnoreCase("aba", "A", "z") = "zbz" + * </pre> + * + * @see #replaceIgnoreCase(String text, String searchString, String replacement, int max) + * @param text text to search and replace in, may be null + * @param searchString the String to search for (case insensitive), may be null + * @param replacement the String to replace it with, may be null + * @return the text with any replacements processed, + * {@code null} if null String input + * @since 3.5 + */ + public static String replaceIgnoreCase(final String text, final String searchString, final String replacement) { + return replaceIgnoreCase(text, searchString, replacement, -1); + } /** * <p>Case insensitively replaces a String with another String inside a larger String, diff --git a/src/main/java/org/apache/commons/lang3/Validate.java b/src/main/java/org/apache/commons/lang3/Validate.java index 6a44d7f..7dc0d21 100644 --- a/src/main/java/org/apache/commons/lang3/Validate.java +++ b/src/main/java/org/apache/commons/lang3/Validate.java @@ -1000,18 +1000,18 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * inclusive values specified; otherwise, throws an exception. - * - * <pre>Validate.inclusiveBetween(0, 2, 1);</pre> - * - * @param start the inclusive start value - * @param end the inclusive end value - * @param value the value to validate - * @throws IllegalArgumentException if the value falls outside the boundaries (inclusive) - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * inclusive values specified; otherwise, throws an exception. + * + * <pre>Validate.inclusiveBetween(0, 2, 1);</pre> + * + * @param start the inclusive start value + * @param end the inclusive end value + * @param value the value to validate + * @throws IllegalArgumentException if the value falls outside the boundaries (inclusive) + * + * @since 3.3 + */ @SuppressWarnings("boxing") public static void inclusiveBetween(final long start, final long end, final long value) { // TODO when breaking BC, consider returning value @@ -1021,21 +1021,21 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * inclusive values specified; otherwise, throws an exception with the - * specified message. - * - * <pre>Validate.inclusiveBetween(0, 2, 1, "Not in range");</pre> - * - * @param start the inclusive start value - * @param end the inclusive end value - * @param value the value to validate - * @param message the exception message if invalid, not null - * - * @throws IllegalArgumentException if the value falls outside the boundaries - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * inclusive values specified; otherwise, throws an exception with the + * specified message. + * + * <pre>Validate.inclusiveBetween(0, 2, 1, "Not in range");</pre> + * + * @param start the inclusive start value + * @param end the inclusive end value + * @param value the value to validate + * @param message the exception message if invalid, not null + * + * @throws IllegalArgumentException if the value falls outside the boundaries + * + * @since 3.3 + */ public static void inclusiveBetween(final long start, final long end, final long value, final String message) { // TODO when breaking BC, consider returning value if (value < start || value > end) { @@ -1044,18 +1044,18 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * inclusive values specified; otherwise, throws an exception. - * - * <pre>Validate.inclusiveBetween(0.1, 2.1, 1.1);</pre> - * - * @param start the inclusive start value - * @param end the inclusive end value - * @param value the value to validate - * @throws IllegalArgumentException if the value falls outside the boundaries (inclusive) - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * inclusive values specified; otherwise, throws an exception. + * + * <pre>Validate.inclusiveBetween(0.1, 2.1, 1.1);</pre> + * + * @param start the inclusive start value + * @param end the inclusive end value + * @param value the value to validate + * @throws IllegalArgumentException if the value falls outside the boundaries (inclusive) + * + * @since 3.3 + */ @SuppressWarnings("boxing") public static void inclusiveBetween(final double start, final double end, final double value) { // TODO when breaking BC, consider returning value @@ -1065,21 +1065,21 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * inclusive values specified; otherwise, throws an exception with the - * specified message. - * - * <pre>Validate.inclusiveBetween(0.1, 2.1, 1.1, "Not in range");</pre> - * - * @param start the inclusive start value - * @param end the inclusive end value - * @param value the value to validate - * @param message the exception message if invalid, not null - * - * @throws IllegalArgumentException if the value falls outside the boundaries - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * inclusive values specified; otherwise, throws an exception with the + * specified message. + * + * <pre>Validate.inclusiveBetween(0.1, 2.1, 1.1, "Not in range");</pre> + * + * @param start the inclusive start value + * @param end the inclusive end value + * @param value the value to validate + * @param message the exception message if invalid, not null + * + * @throws IllegalArgumentException if the value falls outside the boundaries + * + * @since 3.3 + */ public static void inclusiveBetween(final double start, final double end, final double value, final String message) { // TODO when breaking BC, consider returning value if (value < start || value > end) { @@ -1138,18 +1138,18 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * exclusive values specified; otherwise, throws an exception. - * - * <pre>Validate.exclusiveBetween(0, 2, 1);</pre> - * - * @param start the exclusive start value - * @param end the exclusive end value - * @param value the value to validate - * @throws IllegalArgumentException if the value falls out of the boundaries - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * exclusive values specified; otherwise, throws an exception. + * + * <pre>Validate.exclusiveBetween(0, 2, 1);</pre> + * + * @param start the exclusive start value + * @param end the exclusive end value + * @param value the value to validate + * @throws IllegalArgumentException if the value falls out of the boundaries + * + * @since 3.3 + */ @SuppressWarnings("boxing") public static void exclusiveBetween(final long start, final long end, final long value) { // TODO when breaking BC, consider returning value @@ -1159,21 +1159,21 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * exclusive values specified; otherwise, throws an exception with the - * specified message. - * - * <pre>Validate.exclusiveBetween(0, 2, 1, "Not in range");</pre> - * - * @param start the exclusive start value - * @param end the exclusive end value - * @param value the value to validate - * @param message the exception message if invalid, not null - * - * @throws IllegalArgumentException if the value falls outside the boundaries - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * exclusive values specified; otherwise, throws an exception with the + * specified message. + * + * <pre>Validate.exclusiveBetween(0, 2, 1, "Not in range");</pre> + * + * @param start the exclusive start value + * @param end the exclusive end value + * @param value the value to validate + * @param message the exception message if invalid, not null + * + * @throws IllegalArgumentException if the value falls outside the boundaries + * + * @since 3.3 + */ public static void exclusiveBetween(final long start, final long end, final long value, final String message) { // TODO when breaking BC, consider returning value if (value <= start || value >= end) { @@ -1182,18 +1182,18 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * exclusive values specified; otherwise, throws an exception. - * - * <pre>Validate.exclusiveBetween(0.1, 2.1, 1.1);</pre> - * - * @param start the exclusive start value - * @param end the exclusive end value - * @param value the value to validate - * @throws IllegalArgumentException if the value falls out of the boundaries - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * exclusive values specified; otherwise, throws an exception. + * + * <pre>Validate.exclusiveBetween(0.1, 2.1, 1.1);</pre> + * + * @param start the exclusive start value + * @param end the exclusive end value + * @param value the value to validate + * @throws IllegalArgumentException if the value falls out of the boundaries + * + * @since 3.3 + */ @SuppressWarnings("boxing") public static void exclusiveBetween(final double start, final double end, final double value) { // TODO when breaking BC, consider returning value @@ -1203,21 +1203,21 @@ public class Validate { } /** - * Validate that the specified primitive value falls between the two - * exclusive values specified; otherwise, throws an exception with the - * specified message. - * - * <pre>Validate.exclusiveBetween(0.1, 2.1, 1.1, "Not in range");</pre> - * - * @param start the exclusive start value - * @param end the exclusive end value - * @param value the value to validate - * @param message the exception message if invalid, not null - * - * @throws IllegalArgumentException if the value falls outside the boundaries - * - * @since 3.3 - */ + * Validate that the specified primitive value falls between the two + * exclusive values specified; otherwise, throws an exception with the + * specified message. + * + * <pre>Validate.exclusiveBetween(0.1, 2.1, 1.1, "Not in range");</pre> + * + * @param start the exclusive start value + * @param end the exclusive end value + * @param value the value to validate + * @param message the exception message if invalid, not null + * + * @throws IllegalArgumentException if the value falls outside the boundaries + * + * @since 3.3 + */ public static void exclusiveBetween(final double start, final double end, final double value, final String message) { // TODO when breaking BC, consider returning value if (value <= start || value >= end) { diff --git a/src/main/java/org/apache/commons/lang3/math/NumberUtils.java b/src/main/java/org/apache/commons/lang3/math/NumberUtils.java index 50c0923..ab321b0 100644 --- a/src/main/java/org/apache/commons/lang3/math/NumberUtils.java +++ b/src/main/java/org/apache/commons/lang3/math/NumberUtils.java @@ -644,8 +644,8 @@ public class NumberUtils { * <p>If a type specifier is not found, it will check for a decimal point * and then try successively larger types from {@code Integer} to * {@code BigInteger} and from {@code Float} to - * {@code BigDecimal}.</p> - * + * {@code BigDecimal}.</p> + * * <p> * Integral values with a leading {@code 0} will be interpreted as octal; the returned number will * be Integer, Long or BigDecimal as appropriate.