Visitar URL original
SpokenString—Wolfram Documentation

WOLFRAM

Wolfram Language & System Documentation Center

SpokenString[expr]

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

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
"ArraySizeLimit"  
"DetailedGraphics"  
"ExpressionDepthLimit"  
Show More Show More
"IncludeParentheses"  
"IntegerLimit"  
"PostProcess"  
"RealPrecisionLimit"  
"StringLengthLimit"  
Properties & Relations  
Neat Examples  
See Also
Related Guides
History
Cite this Page

SpokenString

SpokenString[expr]

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.

Examples

open all close all

Basic Examples  (2)

Give a spoken representation of a formula:

Wolfram Language code: SpokenString[a + b ^ 2]

Give a spoken description of a graphic:

Wolfram Language code: SpokenString[Graphics[{Red, Disk[]}]]

Scope  (4)

Describe mathematical expressions and functions:

Wolfram Language code: SpokenString[Sqrt[x / (y + z)]]
Wolfram Language code: SpokenString[Sin[x] + O[x] ^ 4]
Wolfram Language code: SpokenString[D[f[x, y], x, y]]
Wolfram Language code: SpokenString[HoldForm[Solve[{x + y == 1, x - 2y == 2}]]]

Describe programming constructs:

Wolfram Language code: SpokenString[x_ /; x > 0]
Wolfram Language code: SpokenString[HoldForm[i = 0;While[RandomReal[] < .5, Print[++i]]]]

Describe a plot:

Wolfram Language code: SpokenString[HoldForm[Plot[x, {x, 0, 1}]]]

Describe a graphics object:

Wolfram Language code: SpokenString[Graphics3D[Cylinder[]]]

Options  (8)

"ArraySizeLimit"  (1)

Limit the number of arguments included in the text:

Wolfram Language code: SpokenString[HoldForm[1 2 3 4 5 6 7 8 9 10], "ArraySizeLimit" -> 4]

"DetailedGraphics"  (1)

Include a detailed description of graphics primitives:

Wolfram Language code: SpokenString[Graphics3D[Sphere[{{0, 0, 0}, {1, 1, 1}}]], "DetailedGraphics" -> True]

"ExpressionDepthLimit"  (1)

Limit the depth of subexpressions included in the text:

Wolfram Language code: SpokenString[{{{x}}}, "ExpressionDepthLimit" -> 2]

"IncludeParentheses"  (1)

Use simplified delimiting of subexpressions:

Wolfram Language code: SpokenString[Sqrt[x / (y + z)]]

Include left and right parentheses in the text:

Wolfram Language code: SpokenString[Sqrt[x / (y + z)], "IncludeParentheses" -> True]

"IntegerLimit"  (1)

Set a threshold for exact integers and rationals:

Wolfram Language code: SpokenString[123457 / 234567, "IntegerLimit" -> 1000]

"PostProcess"  (1)

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

Wolfram Language code: SpokenString[{1, 2, 3}, "PostProcess" -> False]

"RealPrecisionLimit"  (1)

Set a threshold for number of digits in reals:

Wolfram Language code: SpokenString[N[Pi], "RealPrecisionLimit" -> 6]

"StringLengthLimit"  (1)

Limit the length of strings in the text:

Wolfram Language code: SpokenString[HoldForm["string one string two string three"], "StringLengthLimit" -> 6]

Properties & Relations  (1)

Use Speak to hear the string produced by SpokenString:

Wolfram Language code: SpokenString[a + b ^ 2]
Wolfram Language code: Speak[a + b ^ 2]

Neat Examples  (1)

Describe a mathematical expression:

Wolfram Language code: SpokenString[HoldForm[Integrate[Sin[x], x]]]

Use the result as a Wolfram|Alpha query:

Wolfram Language code: WolframAlpha[%]
Wolfram Research (2008), SpokenString, Wolfram Language function, https://reference.wolfram.com/language/ref/SpokenString.html (updated 2012).

Text

Wolfram Research (2008), SpokenString, Wolfram Language function, https://reference.wolfram.com/language/ref/SpokenString.html (updated 2012).

CMS

Wolfram Language. 2008. "SpokenString." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2012. https://reference.wolfram.com/language/ref/SpokenString.html.

APA

Wolfram Language. (2008). SpokenString. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SpokenString.html

BibTeX

@misc{reference.wolfram_2026_spokenstring, author="Wolfram Research", title="{SpokenString}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/SpokenString.html}", note=[Accessed: 14-November-2026]}

BibLaTeX

@online{reference.wolfram_2026_spokenstring, organization={Wolfram Research}, title={SpokenString}, year={2012}, url={https://reference.wolfram.com/language/ref/SpokenString.html}, note=[Accessed: 14-November-2026]}