Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Speech Recognition Manager /

Chapter 1 - Speech Recognition Manager / Speech Recognition Manager Reference

Speech Recognition Manager Routines / Creating Language Objects

SRNewPhrase
You can use the SRNewPhrase function to create a new phrase.
pascal OSErr SRNewPhrase (
SRRecognitionSystem system, 
SRPhrase *phrase, 
const void *text, 
Size textLength);
system
A recognition system.
phrase
On exit, a reference to a new phrase associated with the specified recognition system.
text
The address of a buffer that contains the words that comprise the phrase.
textLength
The size, in bytes, of the specified text.

DESCRIPTION
The SRNewPhrase function returns, in the phrase parameter, a reference to a new phrase associated with the recognition system specified by the system parameter. The phrase's contents (that is, the words that comprise the phrase) is specified by the text and textLength parameters. You can, if you wish, create a new empty phrase and then add words to it by calling the SRAddText or SRAddLanguageObject functions.

SPECIAL CONSIDERATIONS
You should call the SRReleaseObject function to release the phrase reference returned by SRNewPhrase when you're done using it.