Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
read(1)			    General Commands Manual		       read(1)

NAME
       read - read a line from standard	input

SYNOPSIS
       var ...

DESCRIPTION
       reads a single line from	standard input.	 The line is split into	fields
       as when processed by the	shell (refer to	shells in SEE ALSO); the first
       field  is  assigned  to the first variable var, the second field	to the
       second variable var, and	so forth.  If there are	more fields than there
       are  specified var operands, the	remaining fields and their intervening
       separators are assigned to the last var.	 If there are more  vars  than
       fields, the remaining vars are set to empty strings.

       The  setting of variables specified by the var operands affect the cur-
       rent shell execution environment.

       Standard	input to can be	redirected from	a text file.

       Since affects the current shell execution environment,  it  is  usually
       provided	 as a normal shell special (built-in) command.	Thus, if it is
       called in a subshell or separate	utility	execution environment  similar
       to  the	following,  it	does  not  affect  the	shell variables	in the
       caller's	environment:

   Options and Arguments
       recognizes the following	options	and command-line arguments:

	      Do not treat a backslash character in any	special	way.
			     Consider each backslash to	be part	of  the	 input
			     line.

	      var	     The  name	of  an	existing or non-existing shell
			     variable.

EXTERNAL INFLUENCES
   Environment Variables
       determines the internal field separators	used to	delimit	fields.

RETURN VALUE
       exits with one of the following values:

	       0     Successful	completion.

	      >0     End-of-file was detected or an error occurred.

EXAMPLES
       Print a file with the first field of each line moved to the end of  the
       line.

	      while read -r xx yy
	      do
		      printf "%s %s \n"	"$yy" "$xx"
	      done < input_file

SEE ALSO
       csh(1), ksh(1), sh-posix(1), sh(1).

STANDARDS CONFORMANCE
								       read(1)

NAME | SYNOPSIS | DESCRIPTION | EXTERNAL INFLUENCES | RETURN VALUE | EXAMPLES | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=read&sektion=1&manpath=HP-UX+11.22>

home | help