commx
Compare two sorted files line by line.
Mirrors GNU comm. Run it as commx, or as gnux commx.
Synopsis
commx [OPTION]... FILE1 FILE2GNU reference
Description
commx compares two sorted files, FILE1 and FILE2, line by line. With no options it prints three columns: lines only in FILE1, lines only in FILE2, and lines in both, each column indented by one more TAB than the one before. -1, -2 and -3 suppress the matching column, so -12 prints the common lines and -23 the lines only in FILE1. Either FILE may be - for standard input. Both files must be sorted: by default commx warns once per file when it finds a line out of order after a line that appears in only one file, and then exits with status 1; --check-order fails at the first line out of order, and --nocheck-order never checks. --output-delimiter=STR separates the columns with STR (an empty STR writes a NUL byte), --total adds a final line with the three counts and the word 'total', and -z makes NUL the line delimiter. Lines are compared byte by byte, as in the C locale, whatever LANG says, so sort the inputs with sortx (or LC_ALL=C sort). The framework requires a long name for every option, so -1, -2 and -3 also answer to gnux's own --suppress-file1, --suppress-file2 and --suppress-common. When both --check-order and --nocheck-order are given, --check-order wins.
gnux's terminal view (BR-13): on a terminal, a header row names each column's file (cut to fit a tab stop, so it sits over its column), and every line is in its column's color, so the columns stay apart however long the lines are. The lines and their tabs are GNU's. --pretty[=WHEN] and --theme=NAME, options of gnux's own, choose the view (GNUX_PRETTY, GNUX_THEME); -z and piped or redirected output are always GNU's.
Permissions
Needs read permission on FILE1 and FILE2 and search permission on the directories leading to them. Nothing is ever modified.
Use cases
- Finding the lines two sorted lists have in common with -12.
- Finding what was added to or removed from a list between two versions.
- Comparing the files in two directories by comparing their sorted listings.
- Checking which required packages or users are missing from an inventory.
- Counting how many lines two lists share with
--total.
Flags
--check-order check that the input is correctly sorted, even if all input lines are pairable
--help display this help and exit
--nocheck-order do not check that the input is correctly sorted
--output-delimiter STR separate columns with STR
--pretty WHEN[="always"] the gnux terminal view WHEN: 'always' (the default when WHEN is omitted), 'auto' (the default: on a terminal only), or 'never'; GNUX_PRETTY sets the default
-3, --suppress-common suppress column 3 (lines that appear in both files)
-1, --suppress-file1 suppress column 1 (lines unique to FILE1)
-2, --suppress-file2 suppress column 2 (lines unique to FILE2)
--theme NAME color the view with the built-in theme NAME (gnux theme picks and saves one); GNUX_THEME sets the default
--total output a summary
--version output version information and exit
-z, --zero-terminated line delimiter is NUL, not newlineExamples
Show the three columns for two sorted files
commx old.txt new.txtPrint only the lines the files have in common
commx -12 old.txt new.txtPrint the lines only in the first file (removed lines)
commx -23 old.txt new.txtPrint the lines only in the second file (added lines)
commx -13 old.txt new.txtCompare two unsorted lists by sorting them first
sortx a.txt > a.sorted && sortx b.txt > b.sorted && commx a.sorted b.sortedCompare standard input with a file
lsx | commx - expected.txtSeparate the columns with a comma
commx --output-delimiter=, old.txt new.txtCount the lines unique to each file and common to both
commx --total -123 old.txt new.txtFail at the first line out of order
commx --check-order old.txt new.txt || echox 'not sorted'Skip the order check
commx --nocheck-order old.txt new.txtCompare NUL-terminated lists
commx -z -12 a.lst b.lstFind common lines in the portable gnux shell
gnux shell -c 'commx -12 old.txt new.txt | wcx -l'Options
Each option has a page of its own, with its usage and examples.
- --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.
- --output-delimiter: Separate columns with STR.
- --pretty: The
gnuxterminal view WHEN: 'always' (the default when WHEN is omitted), 'auto' (the default: on a terminal only), or 'never'; GNUX_PRETTY sets the default. - -3, --suppress-common: Suppress column 3 (lines that appear in both files).
- -1, --suppress-file1: Suppress column 1 (lines unique to FILE1).
- -2, --suppress-file2: Suppress column 2 (lines unique to FILE2).
- --theme: Color the view with the built-in theme NAME (
gnuxtheme picks and saves one); GNUX_THEME sets the default. - --total: Output a summary.
- -z, --zero-terminated: Line delimiter is NUL, not newline.
Exit status
| Status | Meaning |
|---|---|
| 0 | success: every operand was processed |
| 1 | failure: an operand could not be processed (diagnosed on standard error), or a command-line mistake |
Help in the terminal
commx --help # options, first examples, exit status
gnux help commx # this page: the full manual
gnux help commx --OPTION # one option in depth, with its examples