TripleDNN

Current Directory: /opt/cpanel/ea-ruby24/root/usr/share/ri/system/Open3

File Name	Size	Actions
capture2-c.ri	1377 bytes	Edit \| Delete \| Rename \| Download
capture2-i.ri	1377 bytes	Edit \| Delete \| Rename \| Download
capture2e-c.ri	1023 bytes	Edit \| Delete \| Rename \| Download
capture2e-i.ri	1023 bytes	Edit \| Delete \| Rename \| Download
capture3-c.ri	2071 bytes	Edit \| Delete \| Rename \| Download
capture3-i.ri	2071 bytes	Edit \| Delete \| Rename \| Download
cdesc-Open3.ri	1984 bytes	Edit \| Delete \| Rename \| Download
pipeline-c.ri	2237 bytes	Edit \| Delete \| Rename \| Download
pipeline-i.ri	2237 bytes	Edit \| Delete \| Rename \| Download
pipeline_r-c.ri	1868 bytes	Edit \| Delete \| Rename \| Download
pipeline_r-i.ri	1868 bytes	Edit \| Delete \| Rename \| Download
pipeline_rw-c.ri	2111 bytes	Edit \| Delete \| Rename \| Download
pipeline_rw-i.ri	2111 bytes	Edit \| Delete \| Rename \| Download
pipeline_start-c.ri	2036 bytes	Edit \| Delete \| Rename \| Download
pipeline_start-i.ri	2036 bytes	Edit \| Delete \| Rename \| Download
pipeline_w-c.ri	1455 bytes	Edit \| Delete \| Rename \| Download
pipeline_w-i.ri	1455 bytes	Edit \| Delete \| Rename \| Download
popen2-c.ri	1468 bytes	Edit \| Delete \| Rename \| Download
popen2-i.ri	1468 bytes	Edit \| Delete \| Rename \| Download
popen2e-c.ri	1335 bytes	Edit \| Delete \| Rename \| Download
popen2e-i.ri	1335 bytes	Edit \| Delete \| Rename \| Download
popen3-c.ri	2616 bytes	Edit \| Delete \| Rename \| Download
popen3-i.ri	2616 bytes	Edit \| Delete \| Rename \| Download

U:RDoc::AnyMethod[iI"popen3:EFI"Open3#popen3;TF:privateo:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph;	[	I"KOpen stdin, stdout, and stderr streams and start external executable. ;TI"GIn addition, a thread to wait for the started process is created. ;TI"PThe thread has a pid method and a thread variable :pid which is the pid of ;TI"the started process.;To:RDoc::Markup::BlankLine�o;
;	[I"Block form:;T@o:RDoc::Markup::Verbatim;	[
I"MOpen3.popen3([env,] cmd... [, opts]) {|stdin, stdout, stderr, wait_thr|
;TI"8  pid = wait_thr.pid # pid of the started process.
;TI"  ...
;TI"G  exit_status = wait_thr.value # Process::Status object returned.
;TI"}
;T:@format0o;
;	[I"Non-block form:;T@o;;	[I"Lstdin, stdout, stderr, wait_thr = Open3.popen3([env,] cmd... [, opts])
;TI"8pid = wait_thr[:pid]  # pid of the started process
;TI"	...
;TI"Wstdin.close  # stdin, stdout and stderr should be closed explicitly in this form.
;TI"stdout.close
;TI"stderr.close
;TI"Fexit_status = wait_thr.value  # Process::Status object returned.
;T;
0o;
;	[I"DThe parameters env, cmd, and opts are passed to Process.spawn. ;TI"TA commandline string and a list of argument strings can be accepted as follows:;T@o;;	[I"2Open3.popen3("echo abc") {|i, o, e, t| ... }
;TI"5Open3.popen3("echo", "abc") {|i, o, e, t| ... }
;TI"@Open3.popen3(["echo", "argv0"], "abc") {|i, o, e, t| ... }
;T;
0o;
;	[I"]If the last parameter, opts, is a Hash, it is recognized as an option for Process.spawn.;T@o;;	[I"1Open3.popen3("pwd", :chdir=>"/") {|i,o,e,t|
;TI"  p o.read.chomp #=> "/"
;TI"}
;T;
0o;
;	[I">wait_thr.value waits for the termination of the process. ;TI"?The block form also waits for the process when it returns.;T@o;
;	[I"PClosing stdin, stdout and stderr does not wait for the process to complete.;T@o;
;	[
I"/You should be careful to avoid deadlocks. ;TI"+Since pipes are fixed length buffers, ;TI">Open3.popen3("prog") {|i, o, e, t| o.read } deadlocks if ;TI"6the program generates too much output on stderr. ;TI"TYou should read stdout and stderr simultaneously (using threads or IO.select). ;TI"IHowever, if you don't need stderr output, you can use Open3.popen2. ;TI"UIf merged stdout and stderr output is not a problem, you can use Open3.popen2e. ;TI"fIf you really need stdout and stderr output as separate strings, you can consider Open3.capture3.;T:
@fileI"lib/open3.rb;T:0@omit_headings_from_table_of_contents_below000[�I"(*cmd, **opts, &block);T@JFI"
Open3;FcRDoc::NormalModule00