join

join [OPTION]... FICHIER1 FICHIER2

Pour chaque paire de lignes d’entrée avec des champs de jointure identiques, écrire une ligne sur la sortie standard. Le champ de jointure par défaut est le premier, délimité par des espaces.

Quand FILE1 ou FILE2 (mais pas les deux) est -, lire l’entrée standard.

Options

-a <FILENUM>

afficher aussi les lignes non appariables du fichier NUMÉRO_FICHIER, où
NUMÉRO_FICHIER est 1 ou 2, correspondant à FICHIER1 ou FICHIER2

-v <FILENUM>

comme -a NUMÉRO_FICHIER, mais supprimer les lignes de sortie jointes

-e <EMPTY>

remplacer les champs d’entrée manquants par VIDE

--ignore-case, -i

ignorer les différences de casse lors de la comparaison des champs

-j <FIELD>

équivalent à ‘-1 CHAMP -2 CHAMP’

-o <FORMAT>

obéir au FORMAT lors de la construction de la ligne de sortie

-t <CHAR>

utiliser CHAR comme séparateur de champ d’entrée et de sortie

-1 <FIELD>

joindre sur ce CHAMP du fichier 1

-2 <FIELD>

joindre sur ce CHAMP du fichier 2

--check-order

vérifier que l’entrée est correctement triée, même si toutes les lignes d’entrée sont appariables

--nocheck-order

ne pas vérifier que l’entrée est correctement triée

--header

traiter la première ligne de chaque fichier comme des en-têtes de champs, les imprimer sans essayer de les apparier

--zero-terminated, -z

le délimiteur de ligne est NUL, pas de nouvelle ligne

Examples

Join two files on the first (default) field:

join {{path/to/file1}} {{path/to/file2}}

Join two files using a comma (instead of a space) as the field separator:

join -t ',' {{path/to/file1}} {{path/to/file2}}

Join field3 of file1 with field1 of file2:

join -1 {{3}} -2 {{1}} {{path/to/file1}} {{path/to/file2}}

Produce a line for each unpairable line for file1:

join -a {{1}} {{path/to/file1}} {{path/to/file2}}

Join a file from stdin:

cat {{path/to/file1}} | join - {{path/to/file2}}

The examples are provided by the tldr-pages project under the CC BY 4.0 License.

Please note that, as uutils is a work in progress, some examples might fail.