Home page  
Help >
ddlMpick() - multiple pick
Version 7.11
ddlMpick() - multiple pick
ddlMpick() - multiple pick

Prototype:
   void ddlMpick(
      CONTROL *ctl,
      char *OptnStr,
      char *ArgList);

Permitted values in OptnStr:
   /D - delete specified record(s) from collection
   /R - OR specified record(s) into collection


Form of ArgList:
       <cx> [<table-name>] <rec1> <nrec1> [<rec2> <nrec2> ...]

Description:
If neither the /R option or the /D option is present, ddlMpick():
       1) Clears the target collection
       2) Stores the indicated records into the collection
       3) ANDs the resulting collection with the deleted record collection

If the /R option is present, ddlMpick():
       1) ORs the indicated records into the collection
       2) ANDs the resulting collection with the deleted record collection

If the /D option is present, ddlMpick():
       1) Performs AND NOT of indicated records with the collection

A table-specific ddlMpick() (a call that contains a specific <table-name>) clears existing sorted collections for
       . the sorted collection for <cx> <table-name>
       . the global sorted collection for <cx>

A global ddlMpick() (a call that does not contain a specific <table-name>) clears existing sorted collections for
       . all table-specific sorted collection for <cx>
       . the global sorted collection for <cx>

Values returned in Control Structure:

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.

Control.Ans1 Total number of records placed into target collection (32 bit).
In the case of the /D option, this is the net number of records that were unselected.
In the case of the /R option, this is the net number of records that were added.
Control.Ans1L Total number of records placed into target collection (64 bit).
In the case of the /D option, this is the net number of records that were unselected.
In the case of the /R option, this is the net number of records that were added.