Path: utzoo!attcan!uunet!pdn!boake2!jc3b21!fgd3
From: fgd3@jc3b21.UUCP (Fabbian G. Dufoe)
Newsgroups: comp.sys.amiga.tech
Subject: Re: Lattice C
Message-ID: <490@jc3b21.UUCP>
Date: 7 Nov 88 03:06:25 GMT
References: <6013@killer.DALLAS.TX.US>
Organization: St. Petersburg Jr. College, FL
Lines: 72

From article <6013@killer.DALLAS.TX.US>, by jdp@killer.DALLAS.TX.US (Jim Pritchett):
> 
>      Could someone please give me a short description of the following Lattice
> functions (parameters, function, etc.)?
> 
>      getfnl()
>      strbpl()
> 
> Also, does the Unix (tm) function system() return to the caller when the
> external program is completed?
> 
> 
>                                     Thank you,
> 
>                                                Jim Pritchett
> 
>                                     uucp:  killer!gtmvax!dms3b1!caleb!jdp

     NAME: getfnl	Get filename list
     SYNOPSIS:
	  #include <stdlib.h>
	  n = getfnl(fnp, fna, fnasize, attr);

	  int n; number of matching file names
	  char *fnp; file name pattern
	  char *fna; file name array
	  unsigned fnasize; size of file name array
	  int attr; file attribute

     DESCRIPTION
	  This function gets all file names that match the specified
	  pattern and attribute, and it places them into the file name
	  array.  Each name is stored as a null-terminated string, and the
	  file name array is terminated by a null string (i.e. a string
	  consisting of only one null byte).  If the file name pattern
	  includes a path prefix, that prefix is placed in front of each
	  matching file name.

	  The function return value is the number of strings stored in the
	  array, not including the terminating null string.
     
     -------------------------------------------------------------------
     NAME: strbpl	Build string pointer list

     SYNOPSIS
	  #include <string.h>

	  n = strbpl(s, max, t);

	  int n; number of pointers
	  char *s[]; pointer to string pointer list
	  int max; maximum number of pointers
	  char *t; text pointer

     DESCRIPTION

	  This function constructs a list of pointers to the strings
	  contained within the specified text array.  Each string must be
	  null-terminated, and the text array must be terminated by a null
	  string.  In other workds, array t must end with two null bytes,
	  one to terminate the final string and another to terminated the
	  array.  The string pointer list s is terminated by a null
	  pointer.


--Fabbian Dufoe
  350 Ling-A-Mor Terrace South
  St. Petersburg, Florida  33705
  813-823-2350

UUCP: ...codas!usfvax2!jc3b21!fgd3 
      ...uunet!pdn!jc3b21!fgd3