Mathematica 9 is now available

THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

DOCUMENTATION CENTER SEARCH

New to Mathematica? Find your learning path »

Mathematica > Visualization and Graphics > Sound and Sonification > SpokenString >

BUILT-IN MATHEMATICA SYMBOL

See Also »|More About »

SpokenString

SpokenString[expr]
gives a string of text corresponding to a spoken representation of the expression expr.

MORE INFORMATION

SpokenString[expr] works with mathematical expressions, programs, graphics, and other constructs.

SpokenString[HoldForm[expr]] gives a representation of the held form of expr, without evaluation.

SpokenString attempts to give naturally worded speech rather than literal representations of expression structure.

The following options can be given:

	"ArraySizeLimit"	Infinity	maximal number of elements of an array or arguments of a function
	"DetailedGraphics"	False	controls the description of graphics primitives
	"ExpressionDepthLimit"	Infinity	maximal depth of an expression allowed in the output
	"IntegerLimit"	Infinity	maximal integer that will be given with all its digits
	"PostProcess"	True	whether to remove special formatting used by Speak from the output
	"RealPrecisionLimit"	3	how many significant digits to include in approximate numbers
	"StringLengthLimit"	Infinity	maximal number of characters in strings and symbol names

and control the size of all output expressions, including the representation of graphics.

The options controlling the size specify the level of complexity at which to begin eliding parts of the output rather than the exact count of elements in the output.

SpokenString always returns . SpokenString[HoldForm["str"]] returns a processed version of the string, affected by the options.

SpokenString[Unevaluated[expr]] also gives a representation of the held form of expr.

Basic Examples (2)

Give a spoken representation of a formula:

Give a spoken description of a graphic:

Give a spoken representation of a formula:

Out[1]=

Give a spoken description of a graphic:

Out[1]=

Describe mathematical expressions and functions:

Describe programming constructs:

Describe a plot:

Describe a graphics object:

Limit the number of arguments included in the text:

Include a detailed description of graphics primitives:

Limit the depth of subexpressions included in the text:

Set a threshold for exact integers and rationals:

Show the text with the markup used by the speech engine:

Set a threshold for number of digits in reals:

Limit the length of strings in the text:

Properties & Relations (1)

Use Speak to hear the string produced by SpokenString:

Neat Examples (1)

Describe a mathematical expression:

Use the result as a Wolfram|Alpha query:

Speak TraditionalForm

New in 7 | Last modified in 8

Ask a question about this page | Suggest an improvement | Leave a message for the team

Format: HTML | CDF