internal.html

一本完整的描述Unix Shell 编程的工具书的所有范例

	      <TT
CLASS="FILENAME"
>/bin/echo</TT
>, although its behavior is
	      similar.</P
><P
>	      <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="SCREEN"
> <TT
CLASS="PROMPT"
>bash$ </TT
><TT
CLASS="USERINPUT"
><B
>type -a echo</B
></TT
>
 <TT
CLASS="COMPUTEROUTPUT"
>echo is a shell builtin
 echo is /bin/echo</TT
>
 	      </PRE
></TD
></TR
></TABLE
>
	  </P
></TD
></TR
></TABLE
></DIV
></DD
><DT
><A
NAME="PRINTFREF"
></A
><B
CLASS="COMMAND"
>printf</B
></DT
><DD
><P
>The <B
CLASS="COMMAND"
>printf</B
>, formatted print, command is an
	      enhanced <B
CLASS="COMMAND"
>echo</B
>.  It is a limited variant
	      of the C language <TT
CLASS="FUNCTION"
>printf()</TT
> library
	      function, and its syntax is somewhat different.</P
><P
><B
CLASS="COMMAND"
>printf</B
>   <TT
CLASS="REPLACEABLE"
><I
>format-string</I
></TT
>...   <TT
CLASS="REPLACEABLE"
><I
>parameter</I
></TT
>... </P
><P
>This is the Bash builtin version
	      of the <TT
CLASS="FILENAME"
>/bin/printf</TT
> or
	      <TT
CLASS="FILENAME"
>/usr/bin/printf</TT
> command. See the
	      <B
CLASS="COMMAND"
>printf</B
> manpage (of the system command)
	      for in-depth coverage.</P
><DIV
CLASS="CAUTION"
><TABLE
CLASS="CAUTION"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="common/caution.png"
HSPACE="5"
ALT="Caution"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Older versions of Bash may not support
	      <B
CLASS="COMMAND"
>printf</B
>.</P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="EXAMPLE"
><HR><A
NAME="EX47"
></A
><P
><B
>Example 11-2. <B
CLASS="COMMAND"
>printf</B
> in action</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;#!/bin/bash
   2&nbsp;# printf demo
   3&nbsp;
   4&nbsp;PI=3.14159265358979
   5&nbsp;DecimalConstant=31373
   6&nbsp;Message1="Greetings,"
   7&nbsp;Message2="Earthling."
   8&nbsp;
   9&nbsp;echo
  10&nbsp;
  11&nbsp;printf "Pi to 2 decimal places = %1.2f" $PI
  12&nbsp;echo
  13&nbsp;printf "Pi to 9 decimal places = %1.9f" $PI  # It even rounds off correctly.
  14&nbsp;
  15&nbsp;printf "\n"                                  # Prints a line feed,
  16&nbsp;                                             # Equivalent to 'echo' . . .
  17&nbsp;
  18&nbsp;printf "Constant = \t%d\n" $DecimalConstant  # Inserts tab (\t).
  19&nbsp;
  20&nbsp;printf "%s %s \n" $Message1 $Message2
  21&nbsp;
  22&nbsp;echo
  23&nbsp;
  24&nbsp;# ==========================================#
  25&nbsp;# Simulation of C function, sprintf().
  26&nbsp;# Loading a variable with a formatted string.
  27&nbsp;
  28&nbsp;echo 
  29&nbsp;
  30&nbsp;Pi12=$(printf "%1.12f" $PI)
  31&nbsp;echo "Pi to 12 decimal places = $Pi12"
  32&nbsp;
  33&nbsp;Msg=`printf "%s %s \n" $Message1 $Message2`
  34&nbsp;echo $Msg; echo $Msg
  35&nbsp;
  36&nbsp;#  As it happens, the 'sprintf' function can now be accessed
  37&nbsp;#+ as a loadable module to Bash,
  38&nbsp;#+ but this is not portable.
  39&nbsp;
  40&nbsp;exit 0</PRE
></TD
></TR
></TABLE
><HR></DIV
><P
>Formatting error messages is a useful application of
	      <B
CLASS="COMMAND"
>printf</B
></P
><P
>	        <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;E_BADDIR=65
   2&nbsp;
   3&nbsp;var=nonexistent_directory
   4&nbsp;
   5&nbsp;error()
   6&nbsp;{
   7&nbsp;  printf "$@" &#62;&#38;2
   8&nbsp;  # Formats positional params passed, and sends them to stderr.
   9&nbsp;  echo
  10&nbsp;  exit $E_BADDIR
  11&nbsp;}
  12&nbsp;
  13&nbsp;cd $var || error $"Can't cd to %s." "$var"
  14&nbsp;
  15&nbsp;# Thanks, S.C.</PRE
></TD
></TR
></TABLE
>
            </P
></DD
><DT
><A
NAME="READREF"
></A
><B
CLASS="COMMAND"
>read</B
></DT
><DD
><P
><SPAN
CLASS="QUOTE"
>"Reads"</SPAN
> the value
	    of a variable from <TT
CLASS="FILENAME"
>stdin</TT
>, that
	    is, interactively fetches input from the keyboard. The
	    <TT
CLASS="OPTION"
>-a</TT
> option lets <B
CLASS="COMMAND"
>read</B
>
	    get array variables (see <A
HREF="arrays.html#EX67"
>Example 26-6</A
>).</P
><DIV
CLASS="EXAMPLE"
><HR><A
NAME="EX36"
></A
><P
><B
>Example 11-3. Variable assignment, using <B
CLASS="COMMAND"
>read</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;#!/bin/bash
   2&nbsp;# "Reading" variables.
   3&nbsp;
   4&nbsp;echo -n "Enter the value of variable 'var1': "
   5&nbsp;# The -n option to echo suppresses newline.
   6&nbsp;
   7&nbsp;read var1
   8&nbsp;# Note no '$' in front of var1, since it is being set.
   9&nbsp;
  10&nbsp;echo "var1 = $var1"
  11&nbsp;
  12&nbsp;
  13&nbsp;echo
  14&nbsp;
  15&nbsp;# A single 'read' statement can set multiple variables.
  16&nbsp;echo -n "Enter the values of variables 'var2' and 'var3' (separated by a space or tab): "
  17&nbsp;read var2 var3
  18&nbsp;echo "var2 = $var2      var3 = $var3"
  19&nbsp;# If you input only one value, the other variable(s) will remain unset (null).
  20&nbsp;
  21&nbsp;exit 0</PRE
></TD
></TR
></TABLE
><HR></DIV
><P
>A <B
CLASS="COMMAND"
>read</B
> without an associated variable
	      assigns its input to the dedicated variable <A
HREF="variables2.html#REPLYREF"
>$REPLY</A
>.</P
><DIV
CLASS="EXAMPLE"
><HR><A
NAME="READNOVAR"
></A
><P
><B
>Example 11-4. What happens when <B
CLASS="COMMAND"
>read</B
> has no
	        variable</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;#!/bin/bash
   2&nbsp;# read-novar.sh
   3&nbsp;
   4&nbsp;echo
   5&nbsp;
   6&nbsp;# -------------------------- #
   7&nbsp;echo -n "Enter a value: "
   8&nbsp;read var
   9&nbsp;echo "\"var\" = "$var""
  10&nbsp;# Everything as expected here.
  11&nbsp;# -------------------------- #
  12&nbsp;
  13&nbsp;echo
  14&nbsp;
  15&nbsp;# ------------------------------------------------------------------- #
  16&nbsp;echo -n "Enter another value: "
  17&nbsp;read           #  No variable supplied for 'read', therefore...
  18&nbsp;               #+ Input to 'read' assigned to default variable, $REPLY.
  19&nbsp;var="$REPLY"
  20&nbsp;echo "\"var\" = "$var""
  21&nbsp;# This is equivalent to the first code block.
  22&nbsp;# ------------------------------------------------------------------- #
  23&nbsp;
  24&nbsp;echo
  25&nbsp;
  26&nbsp;exit 0</PRE
></TD
></TR
></TABLE
><HR></DIV
><P
>Normally, inputting a <TT
CLASS="USERINPUT"
><B
>\</B
></TT
>
	      suppresses a newline during input to
	      a <B
CLASS="COMMAND"
>read</B
>. The <TT
CLASS="OPTION"
>-r</TT
>
	      option causes an inputted <TT
CLASS="USERINPUT"
><B
>\</B
></TT
> to be
	      interpreted literally.</P
><DIV
CLASS="EXAMPLE"
><HR><A
NAME="READR"
></A
><P
><B
>Example 11-5. Multi-line input to <B
CLASS="COMMAND"
>read</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;#!/bin/bash
   2&nbsp;
   3&nbsp;echo
   4&nbsp;
   5&nbsp;echo "Enter a string terminated by a \\, then press &#60;ENTER&#62;."
   6&nbsp;echo "Then, enter a second string, and again press &#60;ENTER&#62;."
   7&nbsp;read var1     # The "\" suppresses the newline, when reading $var1.
   8&nbsp;              #     first line \
   9&nbsp;              #     second line
  10&nbsp;
  11&nbsp;echo "var1 = $var1"
  12&nbsp;#     var1 = first line second line
  13&nbsp;
  14&nbsp;#  For each line terminated by a "\"
  15&nbsp;#+ you get a prompt on the next line to continue feeding characters into var1.
  16&nbsp;
  17&nbsp;echo; echo
  18&nbsp;
  19&nbsp;echo "Enter another string terminated by a \\ , then press &#60;ENTER&#62;."
  20&nbsp;read -r var2  # The -r option causes the "\" to be read literally.
  21&nbsp;              #     first line \
  22&nbsp;
  23&nbsp;echo "var2 = $var2"
  24&nbsp;#     var2 = first line \
  25&nbsp;
  26&nbsp;# Data entry terminates with the first &#60;ENTER&#62;.
  27&nbsp;
  28&nbsp;echo 
  29&nbsp;
  30&nbsp;exit 0</PRE
></TD
></TR
></TABLE
><HR></DIV
><P
>The <B
CLASS="COMMAND"
>read</B
> command has some interesting
	      options that permit echoing a prompt and even reading keystrokes
	      without hitting <B
CLASS="KEYCAP"
>ENTER</B
>.</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;# Read a keypress without hitting ENTER.
   2&nbsp;
   3&nbsp;read -s -n1 -p "Hit a key " keypress
   4&nbsp;echo; echo "Keypress was "\"$keypress\""."
   5&nbsp;
   6&nbsp;# -s option means do not echo input.
   7&nbsp;# -n N option means accept only N characters of input.
   8&nbsp;# -p option means echo the following prompt before reading input.
   9&nbsp;
  10&nbsp;# Using these options is tricky, since they need to be in the correct order.</PRE
></TD
></TR
></TABLE
></P
><P
>The <TT
CLASS="OPTION"
>-n</TT
> option to <B
CLASS="COMMAND"
>read</B
>
	      also allows detection of the <I
CLASS="EMPHASIS"
>arrow keys</I
>
	      and certain of the other unusual keys.</P
><DIV
CLASS="EXAMPLE"
><HR><A
NAME="ARROWDETECT"
></A
><P
><B
>Example 11-6. Detecting the arrow keys</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;#!/bin/bash
   2&nbsp;# arrow-detect.sh: Detects the arrow keys, and a few more.
   3&nbsp;# Thank you, Sandro Magi, for showing me how.
   4&nbsp;
   5&nbsp;# --------------------------------------------
   6&nbsp;# Character codes generated by the keypresses.
   7&nbsp;arrowup='\[A'
   8&nbsp;arrowdown='\[B'
   9&nbsp;arrowrt='\[C'
  10&nbsp;arrowleft='\[D'
  11&nbsp;insert='\[2'
  12&nbsp;delete='\[3'
  13&nbsp;# --------------------------------------------
  14&nbsp;
  15&nbsp;SUCCESS=0
  16&nbsp;OTHER=65
  17&nbsp;
  18&nbsp;echo -n "Press a key...  "
  19&nbsp;# May need to also press ENTER if a key not listed above pressed.
  20&nbsp;read -n3 key                      # Read 3 characters.
  21&nbsp;
  22&nbsp;echo -n "$key" | grep "$arrowup"  #Check if character code detected.
  23&nbsp;if [ "$?" -eq $SUCCESS ]
  24&nbsp;then
  25&nbsp;  echo "Up-arrow key pressed."
  26&nbsp;  exit $SUCCESS
  27&nbsp;fi
  28&nbsp;
  29&nbsp;echo -n "$key" | grep "$arrowdown"
  30&nbsp;if [ "$?" -eq $SUCCESS ]
  31&nbsp;then
  32&nbsp;  echo "Down-arrow key pressed."
  33&nbsp;  exit $SUCCESS
  34&nbsp;fi
  35&nbsp;
  36&nbsp;echo -n "$key" | grep "$arrowrt"
  37&nbsp;if [ "$?" -eq $SUCCESS ]
  38&nbsp;then
  39&nbsp;  echo "Right-arrow key pressed."
  40&nbsp;  exit $SUCCESS
  41&nbsp;fi
  42&nbsp;
  43&nbsp;echo -n "$key" | grep "$arrowleft"
  44&nbsp;if [ "$?" -eq $SUCCESS ]
  45&nbsp;then
  46&nbsp;  echo "Left-arrow key pressed."
  47&nbsp;  exit $SUCCESS
  48&nbsp;fi
  49&nbsp;
  50&nbsp;echo -n "$key" | grep "$insert"
  51&nbsp;if [ "$?" -eq $SUCCESS ]
  52&nbsp;then
  53&nbsp;  echo "\"Insert\" key pressed."
  54&nbsp;  exit $SUCCESS
  55&nbsp;fi
  56&nbsp;
  57&nbsp;echo -n "$key" | grep "$delete"
  58&nbsp;if [ "$?" -eq $SUCCESS ]
  59&nbsp;then
  60&nbsp;  echo "\"Delete\" key pressed."
  61&nbsp;  exit $SUCCESS
  62&nbsp;fi
  63&nbsp;
  64&nbsp;
  65&nbsp;echo " Some other key pressed."
  66&nbsp;
  67&nbsp;exit $OTHER
  68&nbsp;
  69&nbsp;#  Exercises:
  70&nbsp;#  ---------
  71&nbsp;#  1) Simplify this script by rewriting the multiple "if" tests
  72&nbsp;#+    as a 'case' construct.
  73&nbsp;#  2) Add detection of the "Home," "End," "PgUp," and "PgDn" keys.</PRE
></TD
></TR
></TABLE
><HR></DIV
><DIV
CLASS="NOTE"
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="common/note.png"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>The <TT
CLASS="OPTION"
>-n</TT
> option to <B
CLASS="COMMAND"
>read</B
>
	      will not detect the <B
CLASS="KEYCAP"
>ENTER</B
> (newline)
	      key.</P
></TD
></TR
></TABLE
></DIV
><P
>The <TT
CLASS="OPTION"
>-t</TT
> option to <B
CLASS="COMMAND"
>read</B
>
	      permits timed input (see <A
HREF="variables2.html#TOUT"
>Example 9-4</A
>).</P
><P
>The <B
CLASS="COMMAND"
>read</B
> command may also
	      <SPAN
CLASS="QUOTE"
>"read"</SPAN
> its variable value from a file
	      <A
HREF="io-redirection.html#IOREDIRREF"
>redirected</A
> to
	      <TT
CLASS="FILENAME"
>stdin</TT
>.  If the file contains
	      more than one line, only the first line is assigned
	      to the variable. If <B
CLASS="COMMAND"
>read</B
>
	      has more than one parameter, then each of
	      these variables gets assigned a successive <A
HREF="special-chars.html#WHITESPACEREF"
>whitespace-delineated</A
>
	      string. Caution!</P
><DIV
CLASS="EXAMPLE"
><HR><A
NAME="READREDIR"
></A
><P
><B
>Example 11-7. Using <B
CLASS="COMMAND"
>read</B
> with
	        <A
HREF="io-redirection.html#IOREDIRREF"
>file redirection</A
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="90%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   1&nbsp;#!/bin/bash
   2&nbsp;
   3&nbsp;read var1 &#60;data-file