U:RDoc::AnyMethod[iI"shellescape:ETI"Shellwords#shellescape;TF: privateo:RDoc::Markup::Document: @parts[o: RDoc::Markup::Paragraph; [I"FEscapes a string so that it can be safely used in a Bourne shell ;TI"Fcommand line. +str+ can be a non-string object that responds to ;TI" +to_s+.;To: RDoc::Markup::BlankLine o;
; [I"DNote that a resulted string should be used unquoted and is not ;TI"<intended for use in double quotes nor in single quotes.;T@o:RDoc::Markup::Verbatim; [I"Eargv = Shellwords.escape("It's better to give than to receive")
;TI"Bargv #=> "It\\'s\\ better\\ to\\ give\\ than\\ to\\ receive"
;T: @format0o;
; [I"9String#shellescape is a shorthand for this function.;T@o; ; [I">argv = "It's better to give than to receive".shellescape
;TI"Bargv #=> "It\\'s\\ better\\ to\\ give\\ than\\ to\\ receive"
;TI"
;TI"2# Search files in lib for method definitions
;TI" pattern = "^[ \t]*def "
;TI"=open("| grep -Ern #{pattern.shellescape} lib") { |grep|
;TI" grep.each_line { |line|
;TI"9 file, lineno, matched_line = line.split(':', 3)
;TI" # ...
;TI" }
;TI"}
;T;
0o;
; [I"IIt is the caller's responsibility to encode the string in the right ;TI"Bencoding for the shell environment where this string is used.;T@o;
; [I"LMultibyte characters are treated as multibyte characters, not as bytes.;T@o;
; [I"BReturns an empty quoted String if +str+ has a length of zero.;T:
@fileI"lib/shellwords.rb;T:0@omit_headings_from_table_of_contents_below000[[I" escape;To;; [ ;@3;0I"
(str);T@3FI"Shellwords;TcRDoc::NormalModule00