net.sf.saxon.expr.number

Class AbstractNumberer

java.lang.Object

net.sf.saxon.expr.number.AbstractNumberer

All Implemented Interfaces:

Numberer

Direct Known Subclasses:

ICUNumbererPE, Numberer_da, Numberer_de, Numberer_en, Numberer_fr, Numberer_frBE, Numberer_it, Numberer_nl, Numberer_nlBE, Numberer_sv, Numberer_tr

public abstract class AbstractNumberer
extends java.lang.Object
implements Numberer

Class AbstractNumberer is a base implementation of Numberer that provides language-independent default numbering This supports the xsl:number element. Methods and data are declared as protected, and static is avoided, to allow easy subclassing.

Author:

Michael H. Kay

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	cyrillicLower
protected static java.lang.String	cyrillicUpper
protected static java.lang.String	greekLower
protected static java.lang.String	greekUpper
protected static java.lang.String	hebrew
protected static java.lang.String	hiraganaA
protected static java.lang.String	hiraganaI
protected static java.lang.String	katakanaA
protected static java.lang.String	katakanaI
protected static java.lang.String	latinLower
protected static java.lang.String	latinUpper
static int	LOWER_CASE
static int	TITLE_CASE
static int	UPPER_CASE
protected static int[]	westernDigits

Constructor Summary

Constructors

Constructor and Description
AbstractNumberer()

Method Summary

Modifier and Type	Method and Description
protected void	alphaDefault(long number, char formchar, FastStringBuffer sb) Default processing with an alphabetic format token: use the contiguous range of Unicode letters starting with that token.
static FastStringBuffer	convertDigitSystem(long number, int[] digits, int requiredLength) Convert a number to use a given set of digits, to a required length.
abstract java.lang.String	dayName(int day, int minWidth, int maxWidth) Get a day name or abbreviation
java.util.Locale	defaultedLocale() Whether this numberer has had its locale defaulted, i.e.
java.lang.String	format(long number, UnicodeString picture, int groupSize, java.lang.String groupSeparator, java.lang.String letterValue, java.lang.String ordinal) Format a number into a string.
java.lang.String	format(long number, UnicodeString picture, NumericGroupFormatter numGroupFormatter, java.lang.String letterValue, java.lang.String ordinal) Format a number into a string
java.lang.String	getCalendarName(java.lang.String code) Get the name of a calendar
java.lang.String	getCountry() Get the country used by this numberer.
java.lang.String	getEraName(int year) Get the name for an era (e.g.
java.lang.String	getOrdinalSuffixForDateTime(java.lang.String component) Get an ordinal suffix for a particular component of a date/time.
java.lang.String	halfDayName(int minutes, int minWidth, int maxWidth) Get an am/pm indicator.
abstract java.lang.String	monthName(int month, int minWidth, int maxWidth) Get a month name or abbreviation
protected java.lang.String	ordinalSuffix(java.lang.String ordinalParam, long number) Construct the ordinal suffix for a number, for example "st", "nd", "rd".
void	setCountry(java.lang.String country) Set the country used by this numberer (currently used only for names of timezones)
protected java.lang.String	toAlpha(long number, int min, int max) Format the number as an alphabetic label using the alphabet consisting of consecutive Unicode characters from min to max
protected java.lang.String	toAlphaSequence(long number, java.lang.String alphabet) Convert the number into an alphabetic label using a given alphabet.
java.lang.String	toJapanese(long number) Format the number in Japanese.
abstract java.lang.String	toOrdinalWords(java.lang.String ordinalParam, long number, int wordCase) Show an ordinal number as English words in a requested case (for example, Twentyfirst)
static java.lang.String	toRoman(long n) Generate a Roman numeral (in lower case)
abstract java.lang.String	toWords(long number) Show the number as words in title case.
java.lang.String	toWords(long number, int wordCase) Format a number as English words with specified case options

Methods inherited from class java.lang.Object

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

Field Detail

UPPER_CASE

public static final int UPPER_CASE

See Also:

Constant Field Values

LOWER_CASE

public static final int LOWER_CASE

See Also:

Constant Field Values

TITLE_CASE

public static final int TITLE_CASE

See Also:

Constant Field Values

westernDigits

protected static final int[] westernDigits

latinUpper

protected static final java.lang.String latinUpper

See Also:

Constant Field Values

latinLower

protected static final java.lang.String latinLower

See Also:

Constant Field Values

greekUpper

protected static final java.lang.String greekUpper

See Also:

Constant Field Values

greekLower

protected static final java.lang.String greekLower

See Also:

Constant Field Values

cyrillicUpper

protected static final java.lang.String cyrillicUpper

See Also:

Constant Field Values

cyrillicLower

protected static final java.lang.String cyrillicLower

See Also:

Constant Field Values

hebrew

protected static final java.lang.String hebrew

See Also:

Constant Field Values

hiraganaA

protected static final java.lang.String hiraganaA

See Also:

Constant Field Values

katakanaA

protected static final java.lang.String katakanaA

See Also:

Constant Field Values

hiraganaI

protected static final java.lang.String hiraganaI

See Also:

Constant Field Values

katakanaI

protected static final java.lang.String katakanaI

See Also:

Constant Field Values

Constructor Detail

AbstractNumberer

public AbstractNumberer()

Method Detail

defaultedLocale

public java.util.Locale defaultedLocale()

Whether this numberer has had its locale defaulted, i.e. it's not using the language requested This can be used for situations, such as in fn:format-date(), where indication of use of defaults is required. Override for subclasses where this can happen

Specified by:

defaultedLocale in interface Numberer

Returns:

the locale used, null if it wasn't defaulted

setCountry

public void setCountry(java.lang.String country)

Set the country used by this numberer (currently used only for names of timezones)

Specified by:

setCountry in interface Numberer

Parameters:

country - The ISO two-letter country code.

getCountry

public java.lang.String getCountry()

Get the country used by this numberer.

Specified by:

getCountry in interface Numberer

Returns:

the country used by this numberer, or null if no country has been set

format

public final java.lang.String format(long number,
                                     UnicodeString picture,
                                     int groupSize,
                                     java.lang.String groupSeparator,
                                     java.lang.String letterValue,
                                     java.lang.String ordinal)

Format a number into a string. This method is provided for backwards compatibility. It merely calls the other format method after constructing a RegularGroupFormatter. The method is final; localization subclasses should implement the method Numberer.format(long, UnicodeString, NumericGroupFormatter, String, String) rather than this method.

Specified by:

format in interface Numberer

Parameters:

number - The number to be formatted

picture - The format token. This is a single component of the format attribute of xsl:number, e.g. "1", "01", "i", or "a"

groupSize - number of digits per group (0 implies no grouping)

groupSeparator - string to appear between groups of digits

letterValue - The letter-value specified to xsl:number: "alphabetic" or "traditional". Can also be an empty string or null.

ordinal - The value of the ordinal attribute specified to xsl:number The value "yes" indicates that ordinal numbers should be used; "" or null indicates that cardinal numbers

Returns:

the formatted number. Note that no errors are reported; if the request is invalid, the number is formatted as if the string() function were used.

format

public java.lang.String format(long number,
                               UnicodeString picture,
                               NumericGroupFormatter numGroupFormatter,
                               java.lang.String letterValue,
                               java.lang.String ordinal)

Format a number into a string

Specified by:

format in interface Numberer

Parameters:

number - The number to be formatted

picture - The format token. This is a single component of the format attribute of xsl:number, e.g. "1", "01", "i", or "a"

numGroupFormatter - object contains separators to appear between groups of digits

letterValue - The letter-value specified to xsl:number: "alphabetic" or "traditional". Can also be an empty string or null.

ordinal - The value of the ordinal attribute specified to xsl:number The value "yes" indicates that ordinal numbers should be used; "" or null indicates cardinal numbers. A value such as "-er" indicates ordinal with a particular gender.

Returns:

the formatted number. Note that no errors are reported; if the request is invalid, the number is formatted as if the string() function were used.

ordinalSuffix

protected java.lang.String ordinalSuffix(java.lang.String ordinalParam,
                                         long number)

Construct the ordinal suffix for a number, for example "st", "nd", "rd". The default (language-neutral) implementation returns a zero-length string

Parameters:

ordinalParam - the value of the ordinal attribute (used in non-English language implementations)

number - the number being formatted

Returns:

the ordinal suffix to be appended to the formatted number

alphaDefault

protected void alphaDefault(long number,
                            char formchar,
                            FastStringBuffer sb)

Default processing with an alphabetic format token: use the contiguous range of Unicode letters starting with that token.

Parameters:

number - the number to be formatted

formchar - the format character, for example 'A' for the numbering sequence A,B,C

sb - buffer to hold the result of the formatting

toAlpha

protected java.lang.String toAlpha(long number,
                                   int min,
                                   int max)

Format the number as an alphabetic label using the alphabet consisting of consecutive Unicode characters from min to max

Parameters:

number - the number to be formatted

min - the start of the Unicode codepoint range

max - the end of the Unicode codepoint range

Returns:

the formatted number

toAlphaSequence

protected java.lang.String toAlphaSequence(long number,
                                           java.lang.String alphabet)

Convert the number into an alphabetic label using a given alphabet. For example, if the alphabet is "xyz" the sequence is x, y, z, xx, xy, xz, ....

Parameters:

number - the number to be formatted

alphabet - a string containing the characters to be used, for example "abc...xyz"

Returns:

the formatted number

convertDigitSystem

public static FastStringBuffer convertDigitSystem(long number,
                                                  int[] digits,
                                                  int requiredLength)

Convert a number to use a given set of digits, to a required length. For example, if the digits are "01" the sequence is 1, 10, 11, 100, 101, 110, 111, ... More commonly, the digits will be "0123456789", giving the usual decimal numbering.

Parameters:

number - the number to be formatted

digits - the codepoints to be used for the digits

requiredLength - the length of the picture that is significant: for example "3" if the picture is "001"

Returns:

the converted number

toRoman

public static java.lang.String toRoman(long n)

Generate a Roman numeral (in lower case)

Parameters:

n - the number to be formatted

Returns:

the Roman numeral representation of the number in lower case

toJapanese

public java.lang.String toJapanese(long number)

Format the number in Japanese.

Parameters:

number - the number to be formatted: formatted in Western decimal style unless in the range 1 to 9999

Returns:

the Japanese Kanji representation of the number if in the range 1-9999

toWords

public abstract java.lang.String toWords(long number)

Show the number as words in title case. (We choose title case because the result can then be converted algorithmically to lower case or upper case).

Parameters:

number - the number to be formatted

Returns:

the number formatted as English words

toWords

public java.lang.String toWords(long number,
                                int wordCase)

Format a number as English words with specified case options

Parameters:

number - the number to be formatted

wordCase - the required case for example UPPER_CASE, LOWER_CASE, TITLE_CASE

Returns:

the formatted number

toOrdinalWords

public abstract java.lang.String toOrdinalWords(java.lang.String ordinalParam,
                                                long number,
                                                int wordCase)

Show an ordinal number as English words in a requested case (for example, Twentyfirst)

Parameters:

ordinalParam - the value of the "ordinal" attribute as supplied by the user

number - the number to be formatted

wordCase - the required case for example UPPER_CASE, LOWER_CASE, TITLE_CASE

Returns:

the formatted number

monthName

public abstract java.lang.String monthName(int month,
                                           int minWidth,
                                           int maxWidth)

Get a month name or abbreviation

Specified by:

monthName in interface Numberer

Parameters:

month - The month number (1=January, 12=December)

minWidth - The minimum number of characters

maxWidth - The maximum number of characters

Returns:

the month name or abbreviation as a string (for example, "September" or "Sep")

dayName

public abstract java.lang.String dayName(int day,
                                         int minWidth,
                                         int maxWidth)

Get a day name or abbreviation

Specified by:

dayName in interface Numberer

Parameters:

day - The day of the week (1=Monday, 7=Sunday)

minWidth - The minimum number of characters

maxWidth - The maximum number of characters

Returns:

the day name or abbreviation as a string (for example, "Monday" or "Mon")

halfDayName

public java.lang.String halfDayName(int minutes,
                                    int minWidth,
                                    int maxWidth)

Get an am/pm indicator. Default implementation works for English, on the basis that some other languages might like to copy this (most non-English countries don't actually use the 12-hour clock, so it's irrelevant).

Specified by:

halfDayName in interface Numberer

Parameters:

minutes - the minutes within the day

minWidth - minimum width of output

maxWidth - maximum width of output

Returns:

the AM or PM indicator

getOrdinalSuffixForDateTime

public java.lang.String getOrdinalSuffixForDateTime(java.lang.String component)

Get an ordinal suffix for a particular component of a date/time.

Specified by:

getOrdinalSuffixForDateTime in interface Numberer

Parameters:

component - the component specifier from a format-dateTime picture, for example "M" for the month or "D" for the day.

Returns:

a string that is acceptable in the ordinal attribute of xsl:number to achieve the required ordinal representation. For example, "-e" for the day component in German, to have the day represented as "dritte August".

getEraName

public java.lang.String getEraName(int year)

Get the name for an era (e.g. "BC" or "AD")

Specified by:

getEraName in interface Numberer

Parameters:

year - the proleptic gregorian year, using "0" for the year before 1AD

Returns:

the name of the era, for example "AD"

getCalendarName

public java.lang.String getCalendarName(java.lang.String code)

Get the name of a calendar

Specified by:

getCalendarName in interface Numberer

Parameters:

code - The code representing the calendar as in the XSLT 2.0 spec, e.g. AD for the Gregorian calendar

Returns:

the name of the calendar, for example "AD"