D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
opt
/
alt
/
ruby34
/
share
/
ri
/
system
/
FileUtils
/
Filename :
cp_lr-c.ri
back
Copy
U:RDoc::AnyMethod[iI" cp_lr:ETI"FileUtils::cp_lr;TT: publico:RDoc::Markup::Document: @parts[o: RDoc::Markup::Paragraph; [I"CCreates {hard links}[https://en.wikipedia.org/wiki/Hard_link].;To: RDoc::Markup::BlankLine o; ; [I":Arguments +src+ (a single path or an array of paths) ;TI" and +dest+ (a single path) ;TI"Kshould be {interpretable as paths}[rdoc-ref:FileUtils@Path+Arguments].;T@o; ; [I"DIf +src+ is the path to a directory and +dest+ does not exist, ;TI"Pcreates links +dest+ and descendents pointing to +src+ and its descendents:;T@o:RDoc::Markup::Verbatim; [I"tree('src0') ;TI"# => src0 ;TI"# |-- sub0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- sub1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;TI"%File.exist?('dest0') # => false ;TI"&FileUtils.cp_lr('src0', 'dest0') ;TI"tree('dest0') ;TI"# => dest0 ;TI"# |-- sub0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- sub1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;T: @format0o; ; [I"8If +src+ and +dest+ are both paths to directories, ;TI"5creates links <tt>dest/src</tt> and descendents ;TI"+pointing to +src+ and its descendents:;T@o; ; [I"tree('src1') ;TI"# => src1 ;TI"# |-- sub0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- sub1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;TI" FileUtils.mkdir('dest1') ;TI"&FileUtils.cp_lr('src1', 'dest1') ;TI"tree('dest1') ;TI"# => dest1 ;TI"# `-- src1 ;TI"# |-- sub0 ;TI" # | |-- src0.txt ;TI" # | `-- src1.txt ;TI"# `-- sub1 ;TI" # |-- src2.txt ;TI" # `-- src3.txt ;T; 0o; ; [I"UIf +src+ is an array of paths to entries and +dest+ is the path to a directory, ;TI"Qfor each path +filepath+ in +src+, creates a link at <tt>dest/filepath</tt> ;TI"pointing to that path:;T@o; ; [I"tree('src2') ;TI"# => src2 ;TI"# |-- sub0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- sub1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;TI" FileUtils.mkdir('dest2') ;TI":FileUtils.cp_lr(['src2/sub0', 'src2/sub1'], 'dest2') ;TI"tree('dest2') ;TI"# => dest2 ;TI"# |-- sub0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- sub1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;T; 0o; ; [I"Keyword arguments:;T@o:RDoc::Markup::List: @type: BULLET: @items[ o:RDoc::Markup::ListItem: @label0; [o; ; [I"E<tt>dereference_root: false</tt> - if +src+ is a symbolic link, ;TI" does not dereference it.;To;;0; [o; ; [I"1<tt>noop: true</tt> - does not create links.;To;;0; [o; ; [I"N<tt>remove_destination: true</tt> - removes +dest+ before creating links.;To;;0; [ o; ; [I";<tt>verbose: true</tt> - prints an equivalent command:;T@o; ; [I"AFileUtils.cp_lr('src0', 'dest0', noop: true, verbose: true) ;TI"AFileUtils.cp_lr('src1', 'dest1', noop: true, verbose: true) ;TI"UFileUtils.cp_lr(['src2/sub0', 'src2/sub1'], 'dest2', noop: true, verbose: true) ;T; 0o; ; [I" Output:;T@o; ; [I"cp -lr src0 dest0 ;TI"cp -lr src1 dest1 ;TI"&cp -lr src2/sub0 src2/sub1 dest2 ;T; 0o; ; [I"PRaises an exception if +dest+ is the path to an existing file or directory ;TI"Iand keyword argument <tt>remove_destination: true</tt> is not given.;T@o; ; [I"@Related: {methods for copying}[rdoc-ref:FileUtils@Copying].;T: @fileI"lib/fileutils.rb;T:0@omit_headings_from_table_of_contents_below000[ I"\(src, dest, noop: nil, verbose: nil, dereference_root: true, remove_destination: false);T@�FI"FileUtils;TcRDoc::NormalModule00