home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Developer CD v1.2
/
amidev_cd_12.iso
/
inc&ad2.0
/
text_autodocs
/
translator.doc
< prev
next >
Wrap
Text File
|
1992-09-01
|
1KB
|
46 lines
TABLE OF CONTENTS
translator.library/Translate
translator.library/Translate translator.library/Translate
NAME
Translate -- Convert an English string into narrator device phonemes.
SYNOPSIS
rtnCode = Translate(inString, inLength, outBuffer, outLength)
D0 A0 D0 A1 D1
LONG Translate( STRPTR inString, LONG inLength, STRPTR outBuffer,
LONG outlen );
FUNCTION
The translate function converts an English string into
a string of phonetic codes suitable as input to the
narrator device.
INPUTS
inString - pointer to English string
inLength - length of English string
outBuffer - a char array which will hold the phonetic codes
outLength - the length of the output array
RESULTS
rtnCode - zero if no error has occured.
The only error that can occur is overflowing the outBuffer.
If Translate() determines that an overflow will occur, it
will stop the translation at a word boundary before the
overflow happens. If this occurs, rtnCode will be a
negative number whose absolute value indicates where in
inString Translate() stopped. The user can then use the
offset -rtnCode from the beginning of inString in a
subsequent Translate() call to continue the translation.
SEE ALSO
narrator.device/CMD_WRITE