Home page  
Help >
ddlGetMemo() - read the contents of a MEMO field
Version 7.11
ddlGetMemo() - read the contents of a MEMO field
ddlGetMemo() - read the contents of a MEMO field
    
   ddlGetMemo()
    
      Prototype:
         void ddlGetMemo(
            CONTROL *ctl,
            char *OptnStr,
            char *ArgList,        /* command argument list */
            char *Image,          /* destination for memo field image */
            long ImageMax)        /* size of Image memory block */
                                  /* ImageMax must be >= 512 */
                                  /* ImageMax must be a multiple of 512 */
                                  /* For most efficient operation, ... */
                                  /* ImageMax should be >= anticipated block size + 512 */
    
      Permitted values in OptnStr:
         B  - Read BLOB data
    
      The format of 'ArgList' is:
         <dgname> <fieldname> <rec>
            where <dgname> is the ascii name of the desired data group
                           in the data base.
                  <fieldname> is the name of the desired Memo field
                  <rec>    is the ascii representation of the record number
                           to be read.
    
      Description:
         Read a memo field from an open data base. If the 'B' option is not
         present, read an existing MEMO field and return in Image. If the
         resulting object length exceeds ImageMax-1, only the first ImageMax-1 
         characters are returned, followed by the null character.
    
         If the 'B' option is present, read an existing BLOB and return 
         in Image. If the resulting object length exceeds ImageMax,
         only the first ImageMax characters are returned; no null character
         is supplied.
          
      Values returned in Control Structure:
         ctl->Ans2 is the ImageLength being returned (including terminating zero)
         ctl->Ans3 is stored image length (including terminating zero); if ctl->Ans3 > ctl->Ans2, some data
            has not been returned

Copyright © 2019 , WhamTech, Inc.  All rights reserved. This document is provided for information purposes only and the contents hereof are subject to change without notice. Names may be trademarks of their respective owners.