rust-join(1)

rust-join1

For each pair of input lines with identical join fields, write a line to standard output. the default join field is the first, delimited by blanks. when `file1` or `file2` (not both) is `-`, read standard input.

Usage

join [-a] [-v] [-e] [{-i | --ignore-case}] [-j] [-o] [-t] [-1] [-2] [--check-order] [--nocheck-order] [--header] [{-z | --zero-terminated}] [{-h | --help}] [{-V | --version}] <FILE1> <FILE2>

Overview

For each pair of input lines with identical join fields, write a line to standard output. The default join field is the first, delimited by blanks.

When `FILE1` or `FILE2` (not both) is `-`, read standard input.

Options

-a=FILENUM

also print unpairable lines from file FILENUM, where FILENUM is 1 or 2, corresponding to FILE1 or FILE2

[possible values: 1, 2]

-v=FILENUM

like -a FILENUM, but suppress joined output lines

[possible values: 1, 2]

-e=EMPTY

replace missing input fields with EMPTY

-i, --ignore-case

ignore differences in case when comparing fields

-j=FIELD

equivalent to '-1 FIELD -2 FIELD'

-o=FORMAT

obey FORMAT while constructing output line

-t=CHAR

use CHAR as input and output field separator

-1=FIELD

join on this FIELD of file 1

-2=FIELD

join on this FIELD of file 2

--check-order

check that the input is correctly sorted, even if all input lines are pairable

--nocheck-order

do not check that the input is correctly sorted

--header

treat the first line in each file as field headers, print them without trying to pair them

-z, --zero-terminated

line delimiter is NUL, not newline

-h, --help

Print help

-V, --version

Print version

Version

v0.0.30

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13

-V since Debian 13 (Trixie); -h since Debian 13 (Trixie).

From rust-coreutils 0.0.30-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.