Important: The information in this document is obsolete and should not be used for new development.
DBResultsToText
After retrieving a results record fromDBGetQueryResults
, you can use theDBResultsToText
function to convert the returned data to text.
FUNCTION DBResultsToText (results: ResultsRecord; VAR theText: Handle): OSErr;
results
- The results record returned by the
DBGetQueryResults
function.theText
- The
DBResultsToText
function returns a handle to the converted text in this parameter. This handle is allocated by the Data Access Manager.DESCRIPTION
TheDBResultsToText
function calls result handlers to convert to text the data retrieved by theDBGetQueryResults
function.SPECIAL CONSIDERATIONS
TheDBResultsToText
function may move or purge memory. You should not call this routine from within an interrupt, such as in a completion routine or a VBL task.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theDBResultsToText
function are
Trap macro Selector _DBResultsToText $0413 RESULT CODES
noErr 0 No error rcDBPackNotInited -813 The InitDBPack
function has not yet been calledSEE ALSO
See Listing 12-1 begining on page 12-18 for an example of the use of theDBResultsToText
function. See "Converting Query Results to Text" beginning on page 12-43 for a discussion of result handlers.