wc (Unix)

wc
The `wc` command
Original author(s)	Joe Ossanna (AT&T Bell Laboratories)
Developer(s)	Various open-source and commercial developers
Initial release	November 3, 1971; 52 years ago (1971-11-03)
Written in	C
Operating system	Unix, Unix-like, V, Plan 9, Inferno, MSX-DOS, IBM i
Platform	Cross-platform
Type	Command
License	Plan 9, Inferno: MIT coreutils: GPL-3.0-or-later

wc (short for word count) is a command in Unix, Plan 9, Inferno, and Unix-like operating systems. The program reads either standard input or a list of computer files and generates one or more of the following statistics: newline count, word count, and byte count. If a list of files is provided, both individual file and total statistics follow.

YouTube Encyclopedic

1/5
Views:
3 697
10 237
1 829
3 944
33 116

Transcription

Example

Sample execution of wc:

 $ wc foo bar
      40     149     947 foo
    2294   16638   97724 bar
    2334   16787   98671 total

The first column is the count of newlines, meaning that the text file foo has 40 newlines while bar has 2294 newlines- resulting in a total of 2334 newlines. The second column indicates the number of words in each text file showing that there are 149 words in foo and 16638 words in bar – giving a total of 16787 words. The last column indicates the number of characters in each text file, meaning that the file foo has 947 characters while bar has 97724 characters – 98671 characters all in all.

Newer versions of wc can differentiate between byte and character count. This difference arises with Unicode which includes multi-byte characters. The desired behaviour is selected with the -c or -m options.

Through a pipeline, it can also be used to preview the output size of a command with a potentially large output, without it printing the text into the console:

$ grep -r "example" |wc
    1071   23337  101349

History

wc is part of the X/Open Portability Guide since issue 2 of 1987. It was inherited into the first version of POSIX.1 and the Single Unix Specification.^[1] It appeared in Version 1 Unix.^[2]

GNU wc used to be part of the GNU textutils package; it is now part of GNU coreutils. The version of wc bundled in GNU coreutils was written by Paul Rubin and David MacKenzie.^[3]

A wc command is also part of ASCII's MSX-DOS2 Tools for MSX-DOS version 2.^[4]

The command is available as a separate package for Microsoft Windows as part of the GnuWin32 project^[5] and the UnxUtils collection of native Win32 ports of common GNU Unix-like utilities.^[6]

The wc command has also been ported to the IBM i operating system.^[7]

Usage

wc -c <filename> prints the byte count
wc -l <filename> prints the line count
wc -m <filename> prints the character count
wc -w <filename> prints the word count
wc -L <filename> prints the length of the longest line (GNU extension)

References

^ wc – Shell and Utilities Reference, The Single UNIX Specification, Version 4 from The Open Group
^ wc(1) – FreeBSD General Commands Manual
^ "wc(1) - Linux man page".
^ MSX-DOS2 Tools User's Manual by ASCII Corporation
^ CoreUtils for Windows
^ Native Win32 ports of some GNU utilities
^ IBM. "IBM System i Version 7.2 Programming Qshell" (PDF). IBM. Retrieved 2020-09-05.

External links

The Wikibook Guide to Unix has a page on the topic of: Commands

wc(1) - Original Unix First Edition manual page for wc.
wc(1) – Linux User Commands Manual
wc(1) – Plan 9 Programmer's Manual, Volume 1
wc(1) – Inferno General commands Manual
The wc Command by The Linux Information Project (LINFO)

v t e Unix command-line interface programs and shell builtins
File system	cat chattr chmod chown chgrp cksum cmp cp dd du df file fuser ln ls mkdir mv pax pwd rm rmdir split tee touch type umask
Processes	at bg crontab fg kill nice ps time
User environment	env exit logname mesg talk tput uname who write
Text processing	awk basename comm csplit cut diff dirname ed ex fold head iconv join m4 more nl paste patch printf read sed sort strings tail tr troff uniq vi wc xargs
Shell builtins	alias cd echo test unset wait
Searching	find grep
Documentation	man
Software development	ar ctags lex make nm strip yacc
Miscellaneous	bc cal expr lp od sleep true and false
Categories Standard Unix programs Unix SUS2008 utilities List

v t e Plan 9 command-line interface programs and shell builtins
File system	chmod chgrp cmp cp dd du file gzip ls mkdir pwd rm split tee touch
Processes	kill ps
User environment	passwd who
Text processing	awk basename comm diff ed eqn join sed sort spell strings tail tr troff uniq wc
Shell builtins	echo test
Networking	ip/ipconfig ip/ping netstat
Searching	grep
Software development	ar hoc lex nm strip yacc
Miscellaneous	bc cal fortune sleep
Category

v t e GNU Core Utilities command-line interface programs
File system	chcon chmod chown chgrp cksum cp dd df dir dircolors install ln ls mkdir mkfifo mknod mktemp mv realpath rm rmdir shred sync touch truncate vdir
Text utilities	b2sum base32 base64 cat cksum comm csplit cut expand fmt fold head join md5sum nl numfmt od paste ptx pr sha1sum shuf sort split sum tac tail tr tsort unexpand uniq wc
Shell utilities	arch basename chroot date dirname du echo env expr factor false groups hostid id link logname nice nohup nproc pathchk pinky printenv printf pwd readlink runcon seq sleep stat stdbuf stty tee test timeout true tty uname unlink uptime users who whoami yes

This page was last edited on 27 December 2023, at 13:46

From Wikipedia, the free encyclopedia