convert/english - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Data Types : Conversion : convert/english

convert/english

convert to English

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

convert(n, english, opt)

convert(n, english, cardinal, opt)

convert(p, english, ordinal)

Parameters

n

-

integer

opt

-

(optional) equation of the form And = true or And = false

p

-

nonnegative integer

Description

• 

The calling sequence convert(n, english) converts the integer n to a string representation in words. For example, convert(5, english) will return the string "five".

• 

The calling sequence convert(n, english, cardinal) does exactly the same as convert(n, english).

• 

These calling sequences use the so-called short scale: that is, "one billion" represents the number109 rather than1012.

• 

If the option And = true is specified, then this command includes the word "and" after the hundreds in numbers such as six hundred and eighty-four. Specifying just And is equivalent to specifying And = true. If And = false is specified, then that same number is spelled as six hundred eighty-four. The default is And = false.

• 

Numbers greater than or equal to one thousand vigintillion (1066) in absolute sense are not supported.

• 

The calling sequence convert(p, english, ordinal), for a nonnegative integer p, returns a string with the number p followed by a suffix to indicate an ordinal number in English. For example, convert(5, english, ordinal) returns the string "5th".

Examples

Cardinal numbers

• 

Not supplying a third argument is the same as using the argument cardinal.

convert0,'english'

zero

(1)

convert0,'english','cardinal'

zero

(2)
• 

Negative numbers are supported.

convert5,'english'

minus five

(3)
• 

The And option specifies whether the word and is included.

convert905684,'english'

nine hundred five thousand six hundred eighty-four

(4)

convert905684,'english','And'

nine hundred and five thousand six hundred and eighty-four

(5)
• 

Large numbers are also supported.

convert12345678901234567890,'english'

twelve quintillion three hundred forty-five quadrillion six hundred seventy-eight trillion nine hundred one billion two hundred thirty-four million five hundred sixty-seven thousand eight hundred ninety

(6)
• 

Very large numbers are not supported:

convert10661,'english'

nine hundred ninety-nine vigintillion nine hundred ninety-nine novemdecillion nine hundred ninety-nine octodecillion nine hundred ninety-nine septendecillion nine hundred ninety-nine sexdecillion nine hundred ninety-nine quindecillion nine hundred ninety-nine quattuordecillion nine hundred ninety-nine tredecillion nine hundred ninety-nine duodecillion nine hundred ninety-nine undecillion nine hundred ninety-nine decillion nine hundred ninety-nine nonillion nine hundred ninety-nine octillion nine hundred ninety-nine septillion nine hundred ninety-nine sextillion nine hundred ninety-nine quintillion nine hundred ninety-nine quadrillion nine hundred ninety-nine trillion nine hundred ninety-nine billion nine hundred ninety-nine million nine hundred ninety-nine thousand nine hundred ninety-nine

(7)

convert1066,'english'

Error, (in positive) number 1000000000000000000000000000000000000000000000000000000000000000000 is too big

Ordinal numbers

• 

Supplying ordinal as the third argument gives ordinal numbers.

convert0,'english','ordinal'

0th

(8)

convert1001,'english','ordinal'

1001st

(9)

convert123456789012345678902,'english','ordinal'

123456789012345678902nd

(10)
• 

Negative numbers are not supported.

convert3,'english','ordinal'

Error, (in `convert/english`) only nonnegative numbers can be converted to ordinal form

Compatibility

• 

The convert/english command was introduced in Maple 17.

• 

For more information on Maple 17 changes, see Updates in Maple 17.


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam