CINXE.COM

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1-transitional.dtd"> <html xmlns= "http://www.w3.org/1999/xhtml"> <head> <link rel="stylesheet" type="text/css" href="belug1.css" /> <title>wc command, by The Linux Information Project (LINFO)</title></head> <body bgcolor="#ffffff"> <a href="index.html">LINFO</a> <center><h1>The wc Command</h1></center> <table width="100%"><tbody><tr><td width="10%"></td><td width="80%"> The wc (i.e., word count) <a href="command.html">command</a> by default counts the number of lines, words and <a href="character.html">characters</a> in text. wc defines a word as a set of contiguous letters, numbers and/or symbols which are separated from other characters by one or more spaces, tabs and/or newline characters (which are generated when the RETURN key is pressed). When counting the number of characters, all characters are counted, not only letters, numbers and symbols, but also spaces, tabs and newline characters. A line is only counted if it ends with a newline character. wc's syntax is <blockquote> <code>wc [options] [file_name(s)]</code> </blockquote> The items in square brackets are optional. If no file names are provided, wc reads from its <a href="standard_input.html">standard input</a>, which by default is text entered at the keyboard. This can be seen by typing <blockquote> <code>wc</code> </blockquote> at the <a href="command_line.html">command line</a> (i.e., in the all-text mode), pressing the ENTER key to move to a new line and then typing some text on one or more lines. The command is executed (i.e., run) by pressing the ENTER key again and then pressing the CONTROL and d keys simultaneously. This causes wc to write in a new line (under the lines of text) its count of the numbers of lines, words and characters in the text. The following command counts the number of lines, words and characters in a file named file1 that resides in the <a href="current_directory.html">current directory</a> (i.e., the directory in which the user is currently working) and likewise writes them, followed by the name of the file, to <a href="standard_output.html">standard output</a>, which is by default the display monitor: <blockquote> <code>wc file1</code> </blockquote> wc can provide its output for multiple files by listing the name of each separated by a space. For example, <blockquote> <code>wc file1 file2 file3</code> </blockquote> The numbers of lines, words and characters for each file along with its name will be displayed on a separate line and in the order that the files are listed as <a href="argument.html">arguments</a> (i.e., input files). In the case of multiple arguments such as this, wc also provides an additional line that shows the total number of lines, words and characters for all the files. Likewise, wc can provide a count for all of the text files within a directory. This is accomplished by using the star wildcard character, which represents everything and is designated by an asterisk ( * ). For example, the following will display the number of lines, words and characters for each file in the current directory (which is represented by a dot) as well as totals for all files in the directory: <blockquote> <code>wc . *</code> </blockquote> wc has only a few <a href="option.html">options</a>, the most commonly used of which restrict the information it provides. The -l option tells wc to count only the number of lines, the -w option tells it to count only the number of words, the -m option tells it to count only the number of characters and the -c option tells wc to count only the number of <a href="byte.html">bytes</a>. Thus, for example, the following displays just the number of words in a file named file4: <blockquote> <code>wc -w file4</code> </blockquote> The following displays the number of characters in the same file: <blockquote> <code>wc -m file4</code> </blockquote> As is generally the case with commands in <a href="unix-like.html">Unix-like</a> <a href="operating_systems_list.html">operating systems</a>, any combination of options can be used together. For example, the following would count both the numbers of lines and words in a file named file5: <blockquote> <code>wc -lw file5</code> </blockquote> <a href="redirection.html">Redirection</a> can be used with wc to create more complex commands. For example, the output from the above command can be redirected using the standard output redirection operator (which is designated by a rightward pointing angle bracket) from the display screen to a file named file6 with the following: <blockquote> <code>wc -lw file5 > file6</code> </blockquote> If file6 already exists, its contents will be overwritten; if it does not exist, it will be created. The contents of file6 can be easily confirmed with a <a href="text_editor.html">text editor</a> or with a command such as <a href="cat.html">cat</a>, which is commonly used to read text files, i.e., <blockquote> <code>cat file6</code> </blockquote> As another example, wc with its -l option can be used to count the total number of objects (i.e., files, links and directories) in the current directory. This is accomplished by first employing the ls command, which by default lists the contents of the current directory, and then sending its output via a <a href="pipe.html">pipe</a> (designated by the vertical bar character) to wc, which counts the number of lines in the output from ls, i.e., <blockquote> <code>ls | wc -l</code> </blockquote> wc can count the words, lines and/or characters only in text files. However, when used with its -c option, it can count the bytes in any type of file, i.e. a <a href="plain_text.html">plain text</a> file or a <a href="binary_file.html">binary file</a>. (A binary file is any file that contains at least some non-text data, such as an image file, a <a href="data_compression.html">compressed</a> text file or an <a href="executable.html">executable</a> <a href="program.html">program</a>.) This can be a convenient way of determining the size of a file. For example, the following command displays the size for each jpeg image file in the current directory as well as the total for all of them: <blockquote> <code>wc -c *.jpg</code> </blockquote> Created June 2, 2004. Last updated May 24, 2006. Copyright © 2004 - 2006 The Linux Information Project. All Rights Reserved. </td><td width="10%"></td></tr></tbody></table> </body></html>