public final class LocaleQualifier extends ResourceQualifier
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
BCP_47_PREFIX |
static java.lang.String |
FAKE_VALUE |
static java.lang.String |
NAME |
Constructor and Description |
---|
LocaleQualifier() |
LocaleQualifier(java.lang.String language) |
LocaleQualifier(java.lang.String full,
java.lang.String language,
java.lang.String region,
java.lang.String script) |
Modifier and Type | Method and Description |
---|---|
boolean |
checkAndSet(java.lang.String value,
FolderConfiguration config)
Check if the value is valid for this qualifier, and if so sets the value into a Folder
Configuration.
|
boolean |
equals(java.lang.Object o)
Returns
true if both objects are equal. |
java.lang.String |
getFolderSegment()
Returns the string used to represent this qualifier in the folder name.
|
java.lang.String |
getFull() |
java.lang.String |
getLanguage() |
java.lang.String |
getLongDisplayValue()
Returns a string formatted for display purpose.
|
java.lang.String |
getName()
Returns the human readable name of the qualifier.
|
static LocaleQualifier |
getQualifier(java.lang.String segment)
Creates and returns a qualifier from the given folder segment.
|
java.lang.String |
getRegion() |
java.lang.String |
getScript() |
java.lang.String |
getShortDisplayValue()
BCP 47 tag or "language,region", or language
|
java.lang.String |
getShortName()
Returns a shorter human readable name for the qualifier.
|
java.lang.String |
getTag()
Tag: language, or language-region, or BCP-47 tag
|
java.lang.String |
getValue() |
boolean |
hasFakeValue()
Returns whether the qualifier has a fake value.
|
int |
hashCode()
Returns a hash code value for the object.
|
boolean |
hasLanguage() |
boolean |
hasRegion() |
boolean |
isMatchFor(ResourceQualifier qualifier)
Returns whether the given qualifier is a match for the receiver.
|
static boolean |
isRegionSegment(java.lang.String segment) |
boolean |
isValid()
Returns whether the qualifier has a valid filter value.
|
static java.lang.String |
normalizeCase(java.lang.String segment)
Given a BCP-47 string, normalizes the case to the recommended casing
|
static LocaleQualifier |
parseBcp47(java.lang.String qualifier)
Parse an Android BCP-47 string (which differs from BCP-47 in that
it has the prefix "b+" and the separator character has been changed from
- to +.
|
int |
since()
Returns the API level when this qualifier was added to Android.
|
compareTo, deprecated, getNullQualifier, isBetterMatchThan, isValid, toString
public static final java.lang.String FAKE_VALUE
public static final java.lang.String NAME
public static final java.lang.String BCP_47_PREFIX
public LocaleQualifier()
public LocaleQualifier(@NonNull java.lang.String language)
public LocaleQualifier(@Nullable java.lang.String full, @NonNull java.lang.String language, @Nullable java.lang.String region, @Nullable java.lang.String script)
public static boolean isRegionSegment(@NonNull java.lang.String segment)
@Nullable public static LocaleQualifier getQualifier(@NonNull java.lang.String segment)
null
is returned.segment
- the folder segment from which to create a qualifier.LocaleQualifier
object or null
@NonNull public static java.lang.String normalizeCase(@NonNull java.lang.String segment)
@NonNull public java.lang.String getValue()
public java.lang.String getName()
ResourceQualifier
getName
in class ResourceQualifier
public java.lang.String getShortName()
ResourceQualifier
getShortName
in class ResourceQualifier
ResourceQualifier.getName()
public int since()
ResourceQualifier
since
in class ResourceQualifier
public boolean isValid()
ResourceQualifier
isValid
in class ResourceQualifier
public boolean hasFakeValue()
ResourceQualifier
hasFakeValue
in class ResourceQualifier
public boolean hasLanguage()
public boolean hasRegion()
public boolean checkAndSet(@NonNull java.lang.String value, @NonNull FolderConfiguration config)
ResourceQualifier
checkAndSet
in class ResourceQualifier
value
- The value to check and set. Must not be null.config
- The folder configuration to receive the value. Must not be null.public boolean equals(java.lang.Object o)
ResourceQualifier
true
if both objects are equal.
This is declared as abstract to force children classes to implement it.equals
in class ResourceQualifier
public int hashCode()
ResourceQualifier
hashCode
in class ResourceQualifier
public java.lang.String getFolderSegment()
getFolderSegment
in class ResourceQualifier
public java.lang.String getShortDisplayValue()
getShortDisplayValue
in class ResourceQualifier
public java.lang.String getTag()
public java.lang.String getLongDisplayValue()
ResourceQualifier
getLongDisplayValue
in class ResourceQualifier
@Nullable public static LocaleQualifier parseBcp47(@NonNull java.lang.String qualifier)
qualifier
- the folder name to parse@NonNull public java.lang.String getLanguage()
@Nullable public java.lang.String getRegion()
@Nullable public java.lang.String getScript()
@NonNull public java.lang.String getFull()
public boolean isMatchFor(ResourceQualifier qualifier)
ResourceQualifier
ResourceQualifier.equals(Object)
.
Children class that re-implements this must implement (ResourceQualifier, ResourceQualifier)
too.isMatchFor
in class ResourceQualifier
qualifier
- the reference qualifier