Carbon


SRChangeLanguageObject

Header: SpeechRecognition.h Carbon status: Supported

Changes the contents of a language object.

OSErr SRChangeLanguageObject (
    SRLanguageObject languageObject, 
    const void *text, 
    Size textLength
);
Parameter descriptions
languageObject

A language object.

text

A pointer to a buffer that contains the words or phrase to which the contents of the specified language object are to be changed.

textLength

The size, in bytes, of the specified text.

function result

A result code.

DISCUSSION

SRChangeLanguageObject is a convenient shortcut for calling SREmptyLanguageObject and then SRAddText.

SRChangeLanguageObject does not alter the value of the reference constant property of the language object specified by the lmObject parameter.

If there are no other references to the language object specified by the languageObject parameter, calling SRChangeLanguageObject causes that object to be released.

If you want to swap rapidly among several language models, you should use the SRSetLanguageObject function instead of SRChangeLanguageObject. Or, you could use the kSREnabled property to rapidly enable and disable parts of the current language model to reflect the current context.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/10/2000)