public class

GsmCellLocation

extends CellLocation
java.lang.Object
   ↳ android.telephony.CellLocation
     ↳ android.telephony.gsm.GsmCellLocation

Class Overview

Represents the cell location on a GSM phone.

Summary

Public Constructors
GsmCellLocation()
Empty constructor.
GsmCellLocation(Bundle bundle)
Initialize the object from a bundle.
Public Methods
boolean equals(Object o)
Compares this instance with the specified object and indicates if they are equal.
void fillInNotifierBundle(Bundle m)
Set intent notifier Bundle based on service state
int getCid()
int getLac()
int hashCode()
Returns an integer hash code for this object.
void setLacAndCid(int lac, int cid)
Set the location area code and the cell id.
void setStateInvalid()
Invalidate this object.
String toString()
Returns a string containing a concise, human-readable description of this object.
[Expand]
Inherited Methods
From class android.telephony.CellLocation
From class java.lang.Object

Public Constructors

public GsmCellLocation ()

Empty constructor. Initializes the LAC and CID to -1.

public GsmCellLocation (Bundle bundle)

Initialize the object from a bundle.

Public Methods

public boolean equals (Object o)

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be both transitive and reflexive.

The implementation in Object returns true only if o is the exact same object as the receiver (using the == operator for comparison). Subclasses often implement equals(Object) so that it takes into account the two object's types and states.

The general contract for the equals(Object) and hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or none of them.

Parameters
o the object to compare this instance with.
Returns
  • true if the specified object is equal to this Object; false otherwise.

public void fillInNotifierBundle (Bundle m)

Set intent notifier Bundle based on service state

Parameters
m intent notifier Bundle

public int getCid ()

Returns
  • gsm cell id, -1 if unknown, 0xffff max legal value

public int getLac ()

Returns
  • gsm location area code, -1 if unknown, 0xffff max legal value

public int hashCode ()

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Returns
  • this object's hash code.

public void setLacAndCid (int lac, int cid)

Set the location area code and the cell id.

public void setStateInvalid ()

Invalidate this object. The location area code and the cell id are set to -1.

public String toString ()

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation simply concatenates the class name, the '@' sign and a hexadecimal representation of the object's hashCode(), that is, it is equivalent to the following expression: 

 getClass().getName() + '@' + Integer.toHexString(hashCode())

Returns
  • a printable representation of this object.