join(1)

✨ join(1) ✨

okay bestie, sit down, we're doing join today 💖 this one's a General Commands Manual situation and it's lowkey one of the most underrated little utilities in the whole toolbox. fr fr.

---

🌸 NAME 🌸

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

and listen: when FILE1 or FILE2 (not both, bestie, pick one 😭) is -, it reads from standard input.

---

🎀 SYNOPSIS 🎀

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>

---

🦋 DESCRIPTION 🦋

okay so the whole vibe is this: for each pair of input lines with identical join fields, write a line to standard output. that's the main character move. the default join field is the first one, delimited by blanks. iconic behaviour honestly.

and when FILE1 or FILE2 (not both) is -, read standard input. yes it's that same - you already know and love. 💅

---

👑 OPTIONS 👑

• -a <FILENUM> — also print unpairable lines from file FILENUM, where FILENUM is 1 or 2, corresponding to FILE1 or FILE2. like, "even the lonely ones get to come to the party" energy 🫶

possible values:

1. 1
2. 2

• -v <FILENUM> — like -a FILENUM, but suppress joined output lines. so basically same energy, but the matched pairs don't show up at all. it's giving "solo era" 💀

possible values:

1. 1
2. 2

• -e <EMPTY> — replace missing input fields with EMPTY. no empty chairs at this table ✨
• -i, --ignore-case — ignore differences in case when comparing fields. HELLO and hello? same thing bestie, we don't discriminate 💖
• -j <FIELD> — equivalent to -1 FIELD -2 FIELD. one flag, two jobs, multitasking queen 👑
• -o <FORMAT> — obey FORMAT while constructing output line. you're the director now 🎬
• -t <CHAR> — use CHAR as input and output field separator. set the vibe, keep the vibe 🌈
• -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. yes, even then. it will look. 👀
• --nocheck-order — do not check that the input is correctly sorted. minding my own business, respectfully 🙈
• --header — treat the first line in each file as field headers, print them without trying to pair them. they're just the labels bestie, let them live 🏷️
• -z, --zero-terminated — line delimiter is NUL, not newline.
• -h, --help — print help.
• -V, --version — print version.

---

⭐ VERSION ⭐

v(uutils coreutils) 0.7.0

---

and that's the whole page, bestie 🧚 we did it. this was join from uutils coreutils, version 0.7.0, and that's the join(1) manual, no cap. go forth and pair some lines. mwah 💜💅