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

Details and Options

  • 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"Infinitymaximal number of elements of an array or arguments of a function
    "DetailedGraphics"Falsecontrols the description of graphics primitives
    "ExpressionDepthLimit"Infinitymaximal depth of an expression allowed in the output
    "IncludeParentheses"Falsecontrols the delimiting of subexpressions
    "IntegerLimit"Infinitymaximal integer that will be given with all its digits
    "PostProcess"Truewhether to remove special formatting used by Speak from the output
    "RealPrecisionLimit"3how many significant digits to include in approximate numbers
    "StringLengthLimit"Infinitymaximal number of characters in strings and symbol names
  • "ArraySizeLimit" and "ExpressionDepthLimit" 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["str"] always returns "str". 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.


open all close all

Basic Examples  (2)

Give a spoken representation of a formula:

Click for copyable input

Give a spoken description of a graphic:

Click for copyable input

Scope  (4)

Options  (8)

Properties & Relations  (1)

Neat Examples  (1)

Introduced in 2008
Updated in 2010