72 lines
2.6 KiB
HTML
72 lines
2.6 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>join(1)</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>join(1)</H1>
|
|
<HR>
|
|
<PRE>
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
join - relational database operator
|
|
|
|
|
|
</PRE>
|
|
<H2>SYNOPSIS</H2><PRE>
|
|
<STRONG>join</STRONG> [<STRONG>-a</STRONG><EM>n</EM>] [<STRONG>-e</STRONG> <EM>s</EM>] [<STRONG>-o</STRONG> <EM>list</EM>] [<STRONG>-t</STRONG><EM>c</EM>] file1 file2
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
<STRONG>Join</STRONG> forms, on the standard output, a join of the two relations specified
|
|
by the lines of <EM>file1</EM> and <EM>file2</EM>. If <EM>file1</EM> is `-', the standard input is
|
|
used.
|
|
|
|
<EM>File1</EM> and <EM>file2</EM> must be sorted in increasing ASCII collating sequence on
|
|
the fields on which they are to be joined, normally the first in each
|
|
line.
|
|
|
|
There is one line in the output for each pair of lines in <EM>file1</EM> and <EM>file2</EM>
|
|
that have identical join fields. The output line normally consists of
|
|
the common field, then the rest of the line from <EM>file1</EM>, then the rest of
|
|
the line from <EM>file2</EM>.
|
|
|
|
Fields are normally separated by blank, tab or newline. In this case,
|
|
multiple separators count as one, and leading separators are discarded.
|
|
|
|
These options are recognized:
|
|
|
|
<STRONG>-a</STRONG><EM>n</EM> In addition to the normal output, produce a line for each unpairable
|
|
line in file <EM>n</EM>, where <EM>n</EM> is 1 or 2.
|
|
|
|
<STRONG>-e</STRONG> <EM>s</EM> Replace empty output fields by string <EM>s</EM>.
|
|
|
|
<STRONG>-o</STRONG> <EM>list</EM>
|
|
Each output line comprises the fields specified in <EM>list</EM>, each
|
|
element of which has the form <EM>n</EM>.<EM>m</EM>, where <EM>n</EM> is a file number and <EM>m</EM> is
|
|
a field number.
|
|
|
|
<STRONG>-t</STRONG><EM>c</EM> Use character <EM>c</EM> as a separator (tab character). Every appearance of
|
|
<EM>c</EM> in a line is significant.
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<STRONG><A HREF="../man1/sort.1.html">sort(1)</A></STRONG>, <STRONG><A HREF="../man1/comm.1.html">comm(1)</A></STRONG>, <STRONG><A HREF="../man1/awk.1.html">awk(1)</A></STRONG>.
|
|
|
|
|
|
</PRE>
|
|
<H2>BUGS</H2><PRE>
|
|
With default field separation, the collating sequence is that of <STRONG>sort</STRONG> <STRONG>-b</STRONG>;
|
|
with <STRONG>-t</STRONG>, the sequence is that of a plain sort.
|
|
|
|
The conventions of <STRONG>join</STRONG>, <STRONG>sort</STRONG>, <STRONG>comm</STRONG>, <STRONG>uniq</STRONG>, <STRONG>look</STRONG> and <STRONG><A HREF="../man1/awk.1.html">awk(1)</A></STRONG> are wildly
|
|
incongruous.
|
|
|
|
|
|
|
|
</PRE>
|
|
</BODY>
|
|
</HTML>
|