Begins speaking a text string.
- macOS 10.0–10.8Deprecated
The string to be spoken.
A result code. See Result Codes.
attempts to speak the Pascal-style text string contained in the string
Speech is produced asynchronously using the default system voice.
When an application calls this function, the Speech Synthesis Manager
makes a copy of the passed string and creates any structures required
to speak it. As soon as speaking has begun, control is returned
to the application. The synthesized speech is generated asynchronously to
the application so that normal processing can continue while the
text is being spoken. No further interaction with the Speech Synthesis
Manager is required at this point, and the application is free to
release the memory that the original string occupied.
called while a prior string is still being spoken, the sound currently
being synthesized is interrupted immediately. Conversion of the
new text into speech is then begun. If you pass a zero-length string
(or, in C, a
Speak, the Speech Synthesis
Manager stops any speech previously being synthesized by
Speak without generating
additional speech. If your application uses
it is often a good idea to stop any speech in progress whenever
your application receives a suspend event. Calling
a zero-length string has no effect on speech channels other than the
one managed internally by the Speech Synthesis Manager for the
The text passed to the
may contain embedded speech commands.