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) Deprecated. use FormatUtils.formatApproaches(List)
static java.lang.String	formatBearing(java.util.List<java.lang.Double[]> bearings) Deprecated. use FormatUtils.formatBearing(List)
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) Deprecated. use FormatUtils.formatDistributions(List)
static java.lang.String	formatRadiuses(double[] radiuses) Deprecated. use FormatUtils.formatRadiuses(List)
static java.lang.String	formatWaypointNames(java.lang.String[] waypointNames) Deprecated. use FormatUtils.formatWaypointNames(List)
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

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

Deprecated. use FormatUtils.formatRadiuses(List)

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

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

Deprecated. use FormatUtils.formatBearing(List)

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

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

Deprecated. use FormatUtils.formatDistributions(List)

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

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

Deprecated. use FormatUtils.formatApproaches(List)

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

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

Deprecated. use FormatUtils.formatWaypointNames(List)

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