Merge "Update Location.convert() javadocs to reflect their inconsistency with locales."
This commit is contained in:
committed by
Android (Google) Code Review
commit
16bce33af6
@@ -170,6 +170,9 @@ public class Location implements Parcelable {
|
||||
* Converts a coordinate to a String representation. The outputType
|
||||
* may be one of FORMAT_DEGREES, FORMAT_MINUTES, or FORMAT_SECONDS.
|
||||
* The coordinate must be a valid double between -180.0 and 180.0.
|
||||
* This conversion is performed in a method that is dependent on the
|
||||
* default locale, and so is not guaranteed to round-trip with
|
||||
* {@link #convert(String)}.
|
||||
*
|
||||
* @throws IllegalArgumentException if coordinate is less than
|
||||
* -180.0, greater than 180.0, or is not a number.
|
||||
@@ -217,7 +220,9 @@ public class Location implements Parcelable {
|
||||
/**
|
||||
* Converts a String in one of the formats described by
|
||||
* FORMAT_DEGREES, FORMAT_MINUTES, or FORMAT_SECONDS into a
|
||||
* double.
|
||||
* double. This conversion is performed in a locale agnostic
|
||||
* method, and so is not guaranteed to round-trip with
|
||||
* {@link #convert(double, int)}.
|
||||
*
|
||||
* @throws NullPointerException if coordinate is null
|
||||
* @throws IllegalArgumentException if the coordinate is not
|
||||
|
||||
Reference in New Issue
Block a user