SerialNumber

java.lang.Object
- com.qualcomm.robotcore.util.SerialNumber

All Implemented Interfaces:

java.io.Serializable
```
public class SerialNumber
extends java.lang.Object
implements java.io.Serializable
```
Instances of SerialNumber represent serial numbers of devices on the USB bus. 'Fake' serial numbers are serial numbers that will *never* appear for a real device; they are useful, for example, as the serial number of a ControllerConfiguration that has not yet been associated with a actual USB controller device. Note that *all* serial numbers loaded in memory at any given instant are guaranteed unique and different, even the fake ones; this allows code that processes USB-device-bound ControllerConfigurations to operate easily on unbound ones as well, a significant coding simplification. The technology used in fake serial numbers, UUIDs, in fact guarantees uniqueness across space and time, so fake serial numbers can be recorded persistently and still maintain uniqueness. Historically, non-unique 'fake' serial numbers were also used: these appeared int the form of "-1" or "N/A". When loaded from persistent storage, such legacy fake serial numbers are converted to unique ones to maintain the uniqueness guarantee.

See Also:
Serialized Form

Constructor Summary

Constructors
Constructor and Description
`SerialNumber()` Constructs a new unique, fake serial number
`SerialNumber(java.lang.String initializer)` Constructs a serial number using the supplied initialization string.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object object)`
`java.lang.String`	`getSerialNumber()` Deprecated. no need to use; use toString() if string form is sought
`int`	`hashCode()`
`boolean`	`isFake()` Returns whether or not this serial number is a fake one or not
`static boolean`	`isLegacyFake(java.lang.String initializer)` Returns whether the indicated serial number initialization string is one of the legacy fake serial number forms or not.
`boolean`	`isReal()` Returns whether or not this serial number is a real one or not
`java.lang.String`	`toString()`
`java.lang.String`	`toString(Context context)`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - SerialNumber
```
public SerialNumber()
```
    Constructs a new unique, fake serial number
  - SerialNumber
```
public SerialNumber(java.lang.String initializer)
```
    Constructs a serial number using the supplied initialization string. If the initialization string is a legacy form of fake serial number, a unique fake serial number is created.
    
    Parameters:
    initializer - the initialization string for the serial number.
- Method Detail
  - isFake
```
public boolean isFake()
```
    Returns whether or not this serial number is a fake one or not
    
    Returns:
    whether or not this serial number is a fake one or not
  - isReal
```
public boolean isReal()
```
    Returns whether or not this serial number is a real one or not
    
    Returns:
    whether or not this serial number is a real one or not
  - isLegacyFake
```
public static boolean isLegacyFake(java.lang.String initializer)
```
    Returns whether the indicated serial number initialization string is one of the legacy fake serial number forms or not.
    
    Parameters:
    initializer - the serial number initialization string to test
    
    Returns:
    whether the the serial number initialization string is a legacy fake form of serial number
  - equals
```
public boolean equals(java.lang.Object object)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - toString
```
public java.lang.String toString(Context context)
```
  - getSerialNumber
```
@Deprecated
public java.lang.String getSerialNumber()
```
    Deprecated. no need to use; use toString() if string form is sought

Class SerialNumber

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SerialNumber

SerialNumber

Method Detail

isFake

isReal

isLegacyFake

equals

hashCode

toString

toString

getSerialNumber