WC
Section: User Commands (1)
Index
Return to Main Contents
BSD mandoc
NAME
wc
- word, line, and byte count
SYNOPSIS
[-c | -m
]
[-lw
]
[file ...
]
DESCRIPTION
The
utility displays the number of lines, words, and bytes contained in each
input
file
(or standard input, by default) to the standard output.
A line is defined as a string of characters delimited by a <newline>
character,
and a word is defined as a string of characters delimited by white space
characters.
White space characters are the set of characters for which the
isspace(3)
function returns true.
If more than one input file is specified, a line of cumulative counts
for all the files is displayed on a separate line after the output for
the last file.
The following options are available:
- -c
-
The number of bytes in each input file
is written to the standard output.
- -l
-
The number of lines in each input file
is written to the standard output.
- -m
-
The number of characters in each input file
is written to the standard output.
- -w
-
The number of words in each input file
is written to the standard output.
When an option is specified,
only
reports the
information requested by that option. The
default action is equivalent to all the
flags
-clw
having been specified.
The following operands are available:
- file
-
A pathname of an input file.
If no file names
are specified, the standard input is used and
no file name is displayed.
By default, the standard output contains a line for each
input file of the form:
lines words bytes file_name
The
utility exits 0 on success, and >0 if an error occurs.
SEE ALSO
isspace(3)
COMPATIBILITY
Historically, the
utility was documented to define a word as a ``maximal string of
characters delimited by <space>, <tab> or <newline> characters''.
The implementation, however, didn't handle non-printing characters
correctly so that `` ^D^E '' counted as 6 spaces, while ``foo^D^Ebar''
counted as 8 characters.
BSD 4
systems after
BSD 4.3
modified the implementation to be consistent
with the documentation.
This implementation defines a ``word'' in terms of the
isspace(3)
function, as required by
St -p1003.2 .
STANDARDS
The
utility conforms to
St -p1003.2-92 .
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- SEE ALSO
-
- COMPATIBILITY
-
- STANDARDS
-
This document was created by
man2html,
using the manual pages.
Time: 04:30:04 GMT, April 24, 2025