com.mapbox.core.utils

Class TextUtils

java.lang.Object

com.mapbox.core.utils.TextUtils

public final class TextUtils
extends java.lang.Object

We avoid including a full library like org.apache.commons:commons-lang3 to avoid an unnecessary large number of methods, which is inconvenient to Android devs.

Since:

1.0.0

See Also:

Some code came from this source.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	formatApproaches(java.lang.String[] approaches) Converts String array with approaches values to a string ready for API consumption.
static java.lang.String	formatBearing(java.util.List<java.lang.Double[]> bearings) Formats the bearing variables from the raw values to a string which can than be used for the request URL.
static java.lang.String	formatCoordinate(double coordinate) Useful to remove any trailing zeros and prevent a coordinate being over 7 significant figures.
static java.lang.String	formatCoordinate(double coordinate, int precision) Allows the specific adjusting of a coordinates precision.
static java.lang.String	formatDistributions(java.util.List<java.lang.Integer[]> distributions) converts the list of integer arrays to a string ready for API consumption.
static java.lang.String	formatRadiuses(double[] radiuses) Used in various APIs to format the user provided radiuses to a String matching the APIs format.
static java.lang.String	formatWaypointNames(java.lang.String[] waypointNames) Converts String array with waypoint_names values to a string ready for API consumption.
static boolean	isEmpty(java.lang.CharSequence str) Returns true if the string is null or 0-length.
static java.lang.String	join(java.lang.CharSequence delimiter, java.lang.Object[] tokens) Returns a string containing the tokens joined by delimiters.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isEmpty

public static boolean isEmpty(java.lang.CharSequence str)

Returns true if the string is null or 0-length.

Parameters:

str - the string to be examined

Returns:

true if str is null or zero length

Since:

1.0.0

join

public static java.lang.String join(java.lang.CharSequence delimiter,
                                    java.lang.Object[] tokens)

Returns a string containing the tokens joined by delimiters.

Parameters:

delimiter - the delimeter on which to split.

tokens - An array objects to be joined. Strings will be formed from the objects by calling object.toString().

Returns:

String

Since:

1.0.0

formatCoordinate

public static java.lang.String formatCoordinate(double coordinate)

Useful to remove any trailing zeros and prevent a coordinate being over 7 significant figures.

Parameters:

coordinate - a double value representing a coordinate.

Returns:

a formatted string.

Since:

2.1.0

formatCoordinate

public static java.lang.String formatCoordinate(double coordinate,
                                                int precision)

Allows the specific adjusting of a coordinates precision.

Parameters:

coordinate - a double value representing a coordinate.

precision - an integer value you'd like the precision to be at.

Returns:

a formatted string.

Since:

2.1.0

formatRadiuses

public static java.lang.String formatRadiuses(double[] radiuses)

Used in various APIs to format the user provided radiuses to a String matching the APIs format.

Parameters:

radiuses - a double array which represents the radius values

Returns:

a String ready for being passed into the Retrofit call

Since:

3.0.0

formatBearing

public static java.lang.String formatBearing(java.util.List<java.lang.Double[]> bearings)

Formats the bearing variables from the raw values to a string which can than be used for the request URL.

Parameters:

bearings - a List of doubles representing bearing values

Returns:

a string with the bearing values

Since:

3.0.0

formatDistributions

public static java.lang.String formatDistributions(java.util.List<java.lang.Integer[]> distributions)

converts the list of integer arrays to a string ready for API consumption.

Parameters:

distributions - the list of integer arrays representing the distribution

Returns:

a string with the distribution values

Since:

3.0.0

formatApproaches

public static java.lang.String formatApproaches(java.lang.String[] approaches)

Converts String array with approaches values to a string ready for API consumption. An approach could be unrestricted, curb or null.

Parameters:

approaches - a string representing approaches to each coordinate.

Returns:

a formatted string.

Since:

3.2.0

formatWaypointNames

public static java.lang.String formatWaypointNames(java.lang.String[] waypointNames)

Converts String array with waypoint_names values to a string ready for API consumption.

Parameters:

waypointNames - a string representing approaches to each coordinate.

Returns:

a formatted string.

Since:

3.3.0