home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / MISC / who.lzh / Join.doc < prev    next >
Text File  |  1994-03-13  |  2KB  |  67 lines
  1.  
  2.     join    -    Relational database operator
  3.  
  4. Syntax
  5.  
  6.     join [options]... file1 file2
  7.  
  8. Description
  9.  
  10.     Join forms, on the standard output, a join of two relations represented 
  11.     by file1 and file2. If only one file is specified the standard input is 
  12.     used as file1.
  13.  
  14.     The files must be sorted on the field that is to join them; usually this
  15.     is the first field.
  16.  
  17.     There is one output line for each pair of lines in file1 and file2 that
  18.     have identical join fields. The output normally consists of the join
  19.     field followed by the rest of the line from file 1 then the rest of the 
  20.     line from file2
  21.  
  22.     Fields are normally separated by white space. Multiple separators count
  23.     as one and leading separators are discarded.
  24.  
  25. Options
  26.  
  27.     -a=n    In addition to the normal output, produce a line for each 
  28.             unpairable line in file n.
  29.  
  30.     -e=s    Replace empty output fields with string s.
  31.  
  32.     -j=n.m    Join file n on field m. This option may appear twice.
  33.  
  34.     -f=n.m    The output line contains field m from file n. 
  35.             The -f parameter may appear up to 256 times.
  36.             A field may occur more than once in the list.
  37.     
  38.     -i=n.c    Input fields in file n are separated by c. Each ocurrence
  39.             of c delimits a field. The default is whitespace.
  40.  
  41.     -o=c    Output fields are separated by c. The default is a tab.
  42.  
  43. Bugs
  44.  
  45.     There may be no more than 256 fields in a record. 
  46.     The maximum size of a record is 4096 characters.
  47.  
  48.     The options available differ somewhat from the UNIX version:
  49.     
  50.     -j    parameter format is different.
  51.     -f    replaces the unix -o parameter and has a different parameter format.
  52.     -i    )
  53.     -o    ) both replace the -t parameter and use a different parameter format.
  54.  
  55.     These changes were made to add flexibility to the file formats and to 
  56.     allow more flexibility in option specification.
  57.  
  58. Author
  59.  
  60.     Martin Gregorie
  61.     10 Sadlers Mead
  62.     Harlow
  63.     Essex    CM18 6HG
  64.  
  65.     Gregorie@LFGMS.logica.com
  66.  
  67.