windows-nt-4.0/private/sdktools/wzmail/dh.new/lib/map.c

/***    map - apply functions to lists of documents
*
*       This file contains the code required to apply functions
*       to lists of documents.
*
*       A 'Document list' is a sequence of entries; each entry
*       specifies a folder and some documents in that folder.
*       The grammar for an entry is:
*               <entry> ::= <foldername> |
*                           <list> |
*                           <foldername> ':' <list>
*
*       The first production for <entry> specifies all of the
*       documents in the folder.
*
*       The second production for <entry> specifies the <list>
*       of documents in the current folder.
*
*       The third production for <entry> specified the <list>
*       of documents in <foldername>.
*       The foldername is the DH pathname of the folder.
*
*       The <list> is composed as follows:
*               <list> ::= <list> ',' <element> |
*                          <element> |
*               <element> ::= <num> |
*                             <num> '-' <num> |
*                             <num> '-' |
*                              '-' <num>
*
*       A list specifies all of the documents specified by its
*       component elements.
*
*       The first production for <element> specifies a single document.
*
*       The second production specifies all of the documents whose
*       docid is greater than or equal to the first num, and less
*       than or equal to the second num.
*
*       The third production specifies all the documents whose
*       docid is greater than or equal to the given number.
*
*       The fourth production specifies all the documents whose
*       docid is less than or equal to the given number.
*/

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "dh.h"

/* Static Functions */
static VOID     mapdoc(INT (*func)(Fhandle, Docid), Fhandle fh, PSTR list);
static VOID     maprange(Docid low, Docid high, Fhandle fh,
                              INT (*func)(Fhandle, Docid));
static BOOL     scan(PSTR *cpp, PSHORT ip);
static VOID     synerr(VOID);

#define LISTLEN 1024 * sizeof(CHAR)

/***    map - map a function over a document list
*
*       Function is called once for each document listed
*       by the document list passed as name.  Basically, we
*       break off the folder name, open the folder, and
*       pass the buck to mapdoc.  One special case
*       is that we handle the special document list '-'
*       here, reading the real document list from
*       stdin, and calling map recursively.  Note that
*       document lists read from stdin cannot use the
*       '-' list.
*
*       Entry:  first = ptr to function to call when folder is opened.
*               func = function to be called for each document
*               last = ptr to function to call before folder is closed.
*               doclist = string of documents to work on
*               oper = how to open folder (FLD_READONLY or FLD_READWRITE)
*       Exit:   none
*
*/
void map(INT (*first)(Fhandle), INT (*func)(Fhandle,Docid),
         INT (*last)(Fhandle), PSTR doclist, INT oper)
{
        /* ??? extern char *strchr(), *strrchr(); */
        static INT stdflg = 0;
        PSTR name, list;
        Fhandle fh;

        if ( (stdflg == 0) && strcmp(doclist, "-") == 0 ) {
                PSTR buf;

                stdflg = 1;
                buf = (PSTR)malloc(LISTLEN);
                while ( gets(buf) != NULL )
                        map(first, func, last, buf, oper);
                free(buf);
                stdflg = 0;
                return;
        }

        /* split apart the folder:list */
        list = strrchr(doclist, ':');
        if ( list == NULL ) {
                if ( strchr("01234567-", *doclist) == NULL ) {
                        /* just a folder */
                        name = doclist;
                        list = NULL;
                } else {
                        /* just a list */
                        fprintf(stderr,
                                "current folder not implemented yet, sorry\n");
                        return;
                        /*
                        name = curfolder();
                        list = doclist;
                        */
                }
        } else {
                name = doclist;
                *list = '\0';
                list += 1;
        }

        if ( (fh = getfolder(name, FLD_SPEC, oper)) == ERROR ) {
                fprintf(stderr, "Can't open folder '%s'.\n", name);
                return;
        }

        (*first)(fh);
        mapdoc(func, fh, list);
        (*last)(fh);

        putfolder(fh);
}



/**     mapdoc - map a function to each document in a document list
*
*       mapdoc calls the specified function for each document in
*       the passed document list.  The document list is passed as
*       a handle to the folder, and the list of document id's.
*       The specified function is called with the folder handle
*       and the document id as arguments.
*
*       This procedure just parses the given list into ranges;
*       a range may contain only one value, in which case
*       the low and high values will be the same.
*       Once the range has been determined, the work is farmed
*       out to the routine 'maprange' which does all of the
*       calling.
*
*       Entry: name = ptr to string containing the list of docid's
*               fh = handle to folder containing documents
*               func = ptr to function to be called for each document
*       Return: none
*/
static VOID mapdoc(INT (*func)(Fhandle, Docid), Fhandle fh, PSTR list)
{
        Docid low, high;
        INT flags;

        /* name is "all" */
        if ( list == NULL ) {
                high = getfldlen(fh);
                maprange(MINDOCID, high, fh, func);
                return;
        }


        while ( *list != '\0' ) {
                flags = 0;
                /* get beginning of range */
                if ( *list == '-' ) {
                        low = MINDOCID;
                        flags = 1;
                } else {
                        if ( scan(&list, (PSHORT)&low) ) {
                                synerr();
                                return;
                        }
                }

                /* check for only one number */
                switch(*list) {
                case ',':
                case '\0':
                        /* only one number in range */
                        high = low;
                        break;
                case '-':
                        /* trailer in range */
                        list += 1;
                        switch(*list) {
                        case '\0':
                        case ',':
                                if ( flags ) {
                                        synerr();
                                        return;
                                }
                                high = getfldlen(fh);
                                break;
                        default:
                                if ( scan(&list, (PSHORT)&high) ) {
                                        synerr();
                                        return;
                                }
                        }
                        break;
                default:
                        synerr();
                        return;
                }
                if ( *list == ',' )
                        list += 1;

                if ( low > high)
                        synerr();
                else
                        maprange(low, high, fh, func);
        }
}

/**     synerr - moan about a syntax error
*
*       Used to indicate a syntax error in a document list
*       just print the error on stderr.
*
*       Entry:  none
*       Return: none
*/
static VOID synerr(VOID)
{
        fprintf(stderr, "Syntax error in document list.\n");
}

/**     maprange - map a function to a range of document id's
*
*       Call the given function once for each document whose
*       id's lies between the low and high values, inclusive.
*       The given function is called with two arguments:
*       the folder handle that is passed to us, and the
*       document id.
*
*       Entry:  low = low document id for range
*               high = high document id for range
*               fh = folder handle to pass to called routine
*               func = routine to call
*       Exit:   none
*/
static VOID maprange( Docid low, Docid high, Fhandle fh,
                          INT (*func)(Fhandle, Docid))
{
        Docid docid;

        docid = scanfolder(fh, DOC_SET, low);
        for ( ; docid != ERROR && docid <= high; docid = scanfolder(fh, DOC_NEXT, 0))
                (*func)(fh, docid);
}

/**     scan - scan for a short integer
*
*       Scan for a short integer in the given string.  We scan
*       across the string, gathering up decimal digits.
*       We stop when we hit a non-digit character.
*
*       Entry: cpp = pointer to pointer to string to scan.
*               ip = pointer to place to store integer we find.
*       Exit:   TRUE iff we didn't find an integer
*               FALSE iff we did find an integer
*       Side effect:
*               pointer is advanced to character after number found
*               number found is stored a location pointed to by ip
*/
static BOOL scan(PSTR *cpp, PSHORT ip)
{
        PSTR cp = *cpp;
        BOOL flg = TRUE;
        INT rv = 0;

        while ( (*cp >= '0') && (*cp <= '9') ) {
                rv *= 10;
                rv += (INT)(*cp) - '0';
                flg = FALSE;
                cp += 1;
        }
        *cpp = cp;
        *ip = (SHORT)rv;
        return flg;
}



/***    null - do nothing function to satisfy 'map()'
*
*       Map expects to get a function to call when each folder
*       is first gotten, and another to call just before it is
*       put back.  This function is made available for programs
*       that wish to do nothing at those points.
*
*       Entry:  fh = handle of folder
*       Return: nothing
*/
VOID null(Fhandle fh)
{

fh;  /* satisfy the compiler */

}