Java Arrays compareUnsigned() Method

Previous
Quiz

Description

The Java Arrays compareUnsigned(byte[] a, byte[] b) method compares the two arrays of bytes lexicographically, numerically treating them as unsigned. In case of null arrays comparison, arrays are considered equals and a null array is lexicographically less than a not null array.

Declaration

Following is the declaration for java.util.Arrays.compareUnsigned(byte[] a, byte[] b) method

 public static int compareUnsigned(byte[] a, byte[] b)

Parameters

  • a − This is the first array to be compared.

  • b − This is the second array to be compared.

Return Value

This method returns the value 0 if the first and second array are equal and contain the same elements in the same order; a value less than 0 if the first array is lexicographically less than the second array; and a value greater than 0 if the first array is lexicographically greater than the second array.

Exception

NA

Java Arrays compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex) Method

Description

The Java Arrays compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex) method compares the two arrays of bytes in the given ranges lexicographically ,numerically treating them as unsigned. In case of any array null, a NullPointerException is thrown.

Declaration

Following is the declaration for java.util.Arrays.compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex) method

 public static int compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex)

Parameters

  • a − This is the first array to be compared.

  • aFromIndex − This is the index of the first element (inclusive) of first array to be compared.

  • aToIndex − This is the index of the last element (exclusive) of first array to be compared.

  • b − This is the second array to be compared.

  • bFromIndex − This is the index of the first element (inclusive) of second array to be compared.

  • bToIndex − This is the index of the last element (exclusive) of second array to be compared.

Return Value

This method returns the value 0 if, over the specified ranges, the first and second array are equal and contain the same elements in the same order; a value less than 0 if, over the specified ranges, the first array is lexicographically less than the second array; and a value greater than 0 if, over the specified ranges, the first array is lexicographically greater than the second array.

Exception

  • IllegalArgumentException − if aFromIndex > aToIndex or if bFromIndex > bToIndex

  • ArrayIndexOutOfBoundsException − if aFromIndex < 0 or aToIndex > a.length or if bFromIndex < 0 or bToIndex > b.length

  • NullPointerException − if either array is null

Comparing Two Arrays of Same byte Values Example

The following example shows the usage of Java Arrays compareUnsigned(byte[], byte[]) method. First, we've created two arrays of same bytes, and compared them using compareUnsigned() method. As per the result, the comparison is printed.

 package com.tutorialspoint; import java.util.Arrays; public class ArrayDemo { public static void main(String[] args) { // initialize first byte array byte array1[] = { 5, 10, 3, 14, 23 }; // initialize second byte array byte array2[] = { 5, 10, 3, 14, 23 }; int result = Arrays.compareUnsigned(array1, array2); if(result > 0) { System.out.println("First array is greater than second array."); } else if (result == 0) { System.out.println("Arrays are same."); } else { System.out.println("First array is less than second array."); } } }

Output

Let us compile and run the above program, this will produce the following result −

 Arrays are same.

Comparing Two Sub-Arrays of byte Values Example

The following example shows the usage of Java Arrays compareUnsigned(byte[] a, int aFromIndex, int aToIndex, byte[] b, int bFromIndex, int bToIndex) method. First, we've created two arrays of different bytes, and compared them using compareUnsigned() method. As per the result, the comparison is printed.

 package com.tutorialspoint; import java.util.Arrays; public class ArrayDemo { public static void main(String[] args) { // initialize first byte array byte array1[] = { 5, 10, 3, 14, 23 }; // initialize second byte array byte array2[] = { 5, 15, 3, 14, 23 }; int result = Arrays.compareUnsigned(array1, 0, 2, array2, 0, 2); if(result > 0) { System.out.println("First array is greater than second array."); } else if (result == 0) { System.out.println("Arrays are same."); } else { System.out.println("First array is less than second array."); } } }

Output

Let us compile and run the above program, this will produce the following result −

 First array is less than second array.

Comparing Two Arrays of Different byte Values Example

The following example shows the usage of Java Arrays compareUnsigned(byte[], byte[]) method. First, we've created two arrays of different bytes, and compared them using compareUnsigned() method. As per the result, the comparison is printed.

 package com.tutorialspoint; import java.util.Arrays; public class ArrayDemo { public static void main(String[] args) { // initialize first byte array byte array1[] = { 5, 15, 3, 14, 23 }; // initialize second byte array byte array2[] = { 5, 10, 3, 14, 23 }; int result = Arrays.compareUnsigned(array1, array2); if(result > 0) { System.out.println("First array is greater than second array."); } else if (result == 0) { System.out.println("Arrays are same."); } else { System.out.println("First array is less than second array."); } } }

Output

Let us compile and run the above program, this will produce the following result −

 First array is greater than second array.
java_util_arrays.htm
Print Page
Previous
Next
Advertisements