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 / Manipulating Language Objects

SRAddLanguageObject
You can use the SRAddLanguageObject function to add a language object to some other language object.
pascal OSErr SRAddLanguageObject (
SRLanguageObject base, 
SRLanguageObject addon);
base
A language object.
addon
A language object.

DESCRIPTION
The SRAddLanguageObject function adds the language object specified by the addon parameter to the language object specified by the base parameter. For example, if addon specifies a word and base specifies a phrase, then SRAddLanguageObject appends that word to the end of that phrase.
The SRAddLanguageObject function is useful for adding language objects to phrases, paths, and language models. For a phrase or a path, SRAddLanguageObject appends the specified object to the end of the phrase or path. For a language model, SRAddLanguageObject adds the specified object to the list of alternative recognizable utterances.
The language object to which you add an object acquires a new reference to that object. Accordingly, any changes you subsequently make to the added object are reflected in any object to which you added it. The base object releases its reference to the added object when the base object is disposed of.

SPECIAL CONSIDERATIONS
SRAddLanguageObject does not alter the value of the reference constant property of the language object specified by the base parameter.

SEE ALSO
See SRAddText (page 1-71) for a useful shortcut function.