usr.bin/wc/wc.1

   1 .\" Copyright (c) 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" This code is derived from software contributed to Berkeley by
   5 .\" the Institute of Electrical and Electronics Engineers, Inc.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\" 3. Neither the name of the University nor the names of its contributors
  16 .\"    may be used to endorse or promote products derived from this software
  17 .\"    without specific prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .\"     @(#)wc.1        8.2 (Berkeley) 4/19/94
  32 .\" $FreeBSD$
  33 .\"
  34 .Dd August 2, 2018
  35 .Dt WC 1
  36 .Os
  37 .Sh NAME
  38 .Nm wc
  39 .Nd word, line, character, and byte count
  40 .Sh SYNOPSIS
  41 .Nm
  42 .Op Fl -libxo
  43 .Op Fl Lclmw
  44 .Op Ar
  45 .Sh DESCRIPTION
  46 The
  47 .Nm
  48 utility displays the number of lines, words, and bytes contained in each
  49 input
  50 .Ar file ,
  51 or standard input (if no file is specified) to the standard output.
  52 A line is defined as a string of characters delimited by a
  53 .Aq newline
  54 character.
  55 Characters beyond the final
  56 .Aq newline
  57 character will not be included
  58 in the line count.
  59 .Pp
  60 A word is defined as a string of characters delimited by white space
  61 characters.
  62 White space characters are the set of characters for which the
  63 .Xr iswspace 3
  64 function returns true.
  65 If more than one input file is specified, a line of cumulative counts
  66 for all the files is displayed on a separate line after the output for
  67 the last file.
  68 .Pp
  69 The following options are available:
  70 .Bl -tag -width indent
  71 .It Fl -libxo
  72 Generate output via
  73 .Xr libxo 3
  74 in a selection of different human and machine readable formats.
  75 See
  76 .Xr xo_parse_args 3
  77 for details on command line arguments.
  78 .It Fl L
  79 Write the length of the line containing the most bytes (default) or characters
  80 (when
  81 .Fl m
  82 is provided)
  83 to standard output.
  84 When more than one
  85 .Ar file
  86 argument is specified, the longest input line of
  87 .Em all
  88 files is reported as the value of the final
  89 .Dq total .
  90 .It Fl c
  91 The number of bytes in each input file
  92 is written to the standard output.
  93 This will cancel out any prior usage of the
  94 .Fl m
  95 option.
  96 .It Fl l
  97 The number of lines in each input file
  98 is written to the standard output.
  99 .It Fl m
 100 The number of characters in each input file is written to the standard output.
 101 If the current locale does not support multibyte characters, this
 102 is equivalent to the
 103 .Fl c
 104 option.
 105 This will cancel out any prior usage of the
 106 .Fl c
 107 option.
 108 .It Fl w
 109 The number of words in each input file
 110 is written to the standard output.
 111 .El
 112 .Pp
 113 When an option is specified,
 114 .Nm
 115 only reports the information requested by that option.
 116 The order of output always takes the form of line, word,
 117 byte, and file name.
 118 The default action is equivalent to specifying the
 119 .Fl c , l
 120 and
 121 .Fl w
 122 options.
 123 .Pp
 124 If no files are specified, the standard input is used and no
 125 file name is displayed.
 126 The prompt will accept input until receiving EOF, or
 127 .Bq ^D
 128 in most environments.
 129 .Sh ENVIRONMENT
 130 The
 131 .Ev LANG , LC_ALL
 132 and
 133 .Ev LC_CTYPE
 134 environment variables affect the execution of
 135 .Nm
 136 as described in
 137 .Xr environ 7 .
 138 .Sh EXIT STATUS
 139 .Ex -std
 140 .Sh EXAMPLES
 141 Count the number of characters, words and lines in each of the files
 142 .Pa report1
 143 and
 144 .Pa report2
 145 as well as the totals for both:
 146 .Pp
 147 .Dl "wc -mlw report1 report2"
 148 .Pp
 149 Find the longest line in a list of files:
 150 .Pp
 151 .Dl "wc -L file1 file2 file3 | fgrep total"
 152 .Sh COMPATIBILITY
 153 Historically, the
 154 .Nm
 155 utility was documented to define a word as a
 156 .Do
 157 maximal string of
 158 characters delimited by <space>, <tab> or <newline> characters
 159 .Dc .
 160 The implementation, however, did not handle non-printing characters
 161 correctly so that
 162 .Dq Li "\ \ ^D^E\ \ "
 163 counted as 6 spaces, while
 164 .Dq Li foo^D^Ebar
 165 counted as 8 characters.
 166 .Bx 4
 167 systems after
 168 .Bx 4.3
 169 modified the implementation to be consistent
 170 with the documentation.
 171 This implementation defines a
 172 .Dq word
 173 in terms of the
 174 .Xr iswspace 3
 175 function, as required by
 176 .St -p1003.2 .
 177 .Pp
 178 The
 179 .Fl L
 180 option is a non-standard
 181 .Fx
 182 extension, compatible with the
 183 .Fl L
 184 option of the GNU
 185 .Nm
 186 utility.
 187 .Sh SEE ALSO
 188 .Xr iswspace 3 ,
 189 .Xr libxo 3 ,
 190 .Xr xo_parse_args 3
 191 .Sh STANDARDS
 192 The
 193 .Nm
 194 utility conforms to
 195 .St -p1003.1-2001 .
 196 .Sh HISTORY
 197 A
 198 .Nm
 199 command appeared in
 200 .At v1 .