Gecko [ beriskala.com ]

Name	Size	Permission	Date
MalformedCSVError	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
Row	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
Table	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
%3c%3c-i.ri	621 B	-rw-r--r--	2023-07-26 18:25
add_converter-i.ri	687 B	-rw-r--r--	2023-07-26 18:25
add_row-i.ri	235 B	-rw-r--r--	2023-07-26 18:25
add_unconverted_fields-i.ri	504 B	-rw-r--r--	2023-07-26 18:25
cdesc-CSV.ri	11.08 KB	-rw-r--r--	2023-07-26 18:25
col_sep-i.ri	337 B	-rw-r--r--	2023-07-26 18:25
convert-i.ri	886 B	-rw-r--r--	2023-07-26 18:25
convert_fields-i.ri	633 B	-rw-r--r--	2023-07-26 18:25
converters-i.ri	436 B	-rw-r--r--	2023-07-26 18:25
each-i.ri	426 B	-rw-r--r--	2023-07-26 18:25
encode_re-i.ri	377 B	-rw-r--r--	2023-07-26 18:25
encode_str-i.ri	367 B	-rw-r--r--	2023-07-26 18:25
encoding-i.ri	395 B	-rw-r--r--	2023-07-26 18:25
escape_re-i.ri	631 B	-rw-r--r--	2023-07-26 18:25
field_size_limit-i.ri	323 B	-rw-r--r--	2023-07-26 18:25
filter-c.ri	1.41 KB	-rw-r--r--	2023-07-26 18:25
force_quotes%3f-i.ri	342 B	-rw-r--r--	2023-07-26 18:25
foreach-c.ri	1.12 KB	-rw-r--r--	2023-07-26 18:25
generate-c.ri	1.07 KB	-rw-r--r--	2023-07-26 18:25
generate_line-c.ri	908 B	-rw-r--r--	2023-07-26 18:25
gets-i.ri	229 B	-rw-r--r--	2023-07-26 18:25
header_convert-i.ri	577 B	-rw-r--r--	2023-07-26 18:25
header_converters-i.ri	463 B	-rw-r--r--	2023-07-26 18:25
header_row%3f-i.ri	322 B	-rw-r--r--	2023-07-26 18:25
headers-i.ri	437 B	-rw-r--r--	2023-07-26 18:25
init_comments-i.ri	529 B	-rw-r--r--	2023-07-26 18:25
init_converters-i.ri	715 B	-rw-r--r--	2023-07-26 18:25
init_parsers-i.ri	383 B	-rw-r--r--	2023-07-26 18:25
init_separators-i.ri	789 B	-rw-r--r--	2023-07-26 18:25
inspect-i.ri	353 B	-rw-r--r--	2023-07-26 18:25
instance-c.ri	710 B	-rw-r--r--	2023-07-26 18:25
liberal_parsing%3f-i.ri	344 B	-rw-r--r--	2023-07-26 18:25
line-i.ri	366 B	-rw-r--r--	2023-07-26 18:25
lineno-i.ri	370 B	-rw-r--r--	2023-07-26 18:25
new-c.ri	7.63 KB	-rw-r--r--	2023-07-26 18:25
open-c.ri	2.94 KB	-rw-r--r--	2023-07-26 18:25
parse-c.ri	722 B	-rw-r--r--	2023-07-26 18:25
parse_headers-i.ri	781 B	-rw-r--r--	2023-07-26 18:25
parse_line-c.ri	570 B	-rw-r--r--	2023-07-26 18:25
puts-i.ri	229 B	-rw-r--r--	2023-07-26 18:25
quote_char-i.ri	346 B	-rw-r--r--	2023-07-26 18:25
raw_encoding-i.ri	406 B	-rw-r--r--	2023-07-26 18:25
read-c.ri	936 B	-rw-r--r--	2023-07-26 18:25
read-i.ri	424 B	-rw-r--r--	2023-07-26 18:25
readline-i.ri	237 B	-rw-r--r--	2023-07-26 18:25
readlines-c.ri	289 B	-rw-r--r--	2023-07-26 18:25
readlines-i.ri	238 B	-rw-r--r--	2023-07-26 18:25
return_headers%3f-i.ri	369 B	-rw-r--r--	2023-07-26 18:25
rewind-i.ri	322 B	-rw-r--r--	2023-07-26 18:25
row_sep-i.ri	337 B	-rw-r--r--	2023-07-26 18:25
shift-i.ri	622 B	-rw-r--r--	2023-07-26 18:25
skip_blanks%3f-i.ri	353 B	-rw-r--r--	2023-07-26 18:25
skip_lines-i.ri	314 B	-rw-r--r--	2023-07-26 18:25
table-c.ri	525 B	-rw-r--r--	2023-07-26 18:25
unconverted_fields%3f-i.ri	372 B	-rw-r--r--	2023-07-26 18:25
write_headers%3f-i.ri	345 B	-rw-r--r--	2023-07-26 18:25

Rename

U:RDoc::NormalClass[iI"CSV:ET@I"Object;To:RDoc::Markup::Document:@parts[o;;[;o:RDoc::Markup::Paragraph;[I"PThis class provides a complete interface to CSV files and data. It offers ;TI"Qtools to enable you to read and write to and from Strings or IO objects, as ;TI"needed.;To:RDoc::Markup::BlankLine�S:RDoc::Markup::Heading:
leveli:	textI"Reading;T@S;;i;
I"From a File;T@S;;i	;
I"A Line at a Time;T@o:RDoc::Markup::Verbatim;[I".CSV.foreach("path/to/file.csv") do |row|
;TI" # use row here...
;TI"	end
;T:@format0S;;i	;
I"All at Once;T@o;;[I"0arr_of_arrs = CSV.read("path/to/file.csv")
;T;0S;;i;
I"From a String;T@S;;i	;
I"A Line at a Time;T@o;;[I"+CSV.parse("CSV,data,String") do |row|
;TI" # use row here...
;TI"	end
;T;0S;;i	;
I"All at Once;T@o;;[I"0arr_of_arrs = CSV.parse("CSV,data,String")
;T;0S;;i;
I"Writing;T@S;;i;
I"To a File;T@o;;[
I"1CSV.open("path/to/file.csv", "wb") do |csv|
;TI"+ csv << ["row", "of", "CSV", "data"]
;TI"! csv << ["another", "row"]
;TI"
 # ...
;TI"	end
;T;0S;;i;
I"To a String;T@o;;[
I"(csv_string = CSV.generate do |csv|
;TI"+ csv << ["row", "of", "CSV", "data"]
;TI"! csv << ["another", "row"]
;TI"
 # ...
;TI"	end
;T;0S;;i;
I"Convert a Single Line;T@o;;[I"4csv_string = ["CSV", "data"].to_csv # to CSV
;TI"6csv_array = "CSV,String".parse_csv # from CSV
;T;0S;;i;
I"Shortcut Interface;T@o;;[	I"MCSV { |csv_out| csv_out << %w{my data here} } # to $stdout
;TI"NCSV(csv = "") { |csv_str| csv_str << %w{my data here} } # to a String
;TI"MCSV($stderr) { |csv_err| csv_err << %w{my data here} } # to $stderr
;TI"NCSV($stdin) { |csv_in| csv_in.each { |row| p row } } # from $stdin
;T;0S;;i;
I"Advanced Usage;T@S;;i;
I"Wrap an IO Object;T@o;;[I" csv = CSV.new(io, options)
;TI"Q# ... read (with gets() or each()) from and write (with <<) to csv here ...
;T;0S;;i;
I">CSV and Character Encodings (M17n or Multilingualization);T@o;	;[I"TThis new CSV parser is m17n savvy. The parser works in the Encoding of the IO ;TI"Tor String object being read from or written to. Your data is never transcoded ;TI"S(unless you ask Ruby to transcode it for you) and will literally be parsed in ;TI"Sthe Encoding it is in. Thus CSV will return Arrays or Rows of Strings in the ;TI"SEncoding of your data. This is accomplished by transcoding the parser itself ;TI"into your Encoding.;T@o;	;[I"SSome transcoding must take place, of course, to accomplish this multiencoding ;TI"Fsupport. For example, <tt>:col_sep</tt>, <tt>:row_sep</tt>, and ;TI"Q<tt>:quote_char</tt> must be transcoded to match your data. Hopefully this ;TI"Qmakes the entire process feel transparent, since CSV's defaults should just ;TI"Rmagically work for your data. However, you can set these values manually in ;TI"2the target Encoding to avoid the translation.;T@o;	;[I"LIt's also important to note that while all of CSV's core parser is now ;TI"JEncoding agnostic, some features are not. For example, the built-in ;TI"Oconverters will try to transcode data to UTF-8 before making conversions. ;TI"RAgain, you can provide custom converters that are aware of your Encodings to ;TI"Javoid this translation. It's just too hard for me to support native ;TI",conversions in all of Ruby's Encodings.;T@o;	;[	I"TAnyway, the practical side of this is simple: make sure IO and String objects ;TI"Spassed into CSV have the proper Encoding set and everything should just work. ;TI"QCSV methods that allow you to open IO objects (CSV::foreach(), CSV::open(), ;TI"MCSV::read(), and CSV::readlines()) do allow you to specify the Encoding.;T@o;	;[
I"ROne minor exception comes when generating CSV into a String with an Encoding ;TI"Othat is not ASCII compatible. There's no existing data for CSV to use to ;TI"Tprepare itself and thus you will probably need to manually specify the desired ;TI"SEncoding for most of those cases. It will try to guess using the fields in a ;TI"Mrow of output though, when using CSV::generate_line() or Array#to_csv().;T@o;	;[I"RI try to point out any other Encoding issues in the documentation of methods ;TI"as they come up.;T@o;	;[	I"SThis has been tested to the best of my ability with all non-"dummy" Encodings ;TI"MRuby ships with. However, it is brave new code and may have some bugs. ;TI"SPlease feel free to {report}[mailto:james@grayproductions.net] any issues you ;TI"find with it.;T:
@fileI"lib/csv.rb;T:0@omit_headings_from_table_of_contents_below0;0;0[
[
I"col_sep;TI"R;T:publicFI"lib/csv.rb;T[
I"
encoding;T@�;F@�[
I"field_size_limit;T@�;F@�[
I"	line;T@�;F@�[
I"lineno;T@�;F@�[
I"quote_char;T@�;F@�[
I"row_sep;T@�;F@�[
I"skip_lines;T@�;F@�[
U:RDoc::Constant[i�I"VERSION;TI"CSV::VERSION;T;0o;;[o;	;[I"*The version of the installed library.;T;@�;0@�@cRDoc::NormalClass0U;[i�I"FieldInfo;TI"CSV::FieldInfo;T;0o;;[o;	;[	I"NA FieldInfo Struct contains details about a field's position in the data ;TI"Rsource it was read from. CSV will pass this Struct to some blocks that make ;TI"Jdecisions based on field structure. See CSV.convert_fields() for an ;TI"
example.;T@o:RDoc::Markup::List:
@type:	NOTE:@items[o:RDoc::Markup::ListItem:@label[I"<tt>index</tt>;T;[o;	;[I"2The zero-based index of the field in its row.;To;;[I"<tt>line</tt>;T;[o;	;[I"2The line of the data source this row is from.;To;;[I"<tt>header</tt>;T;[o;	;[I"/The header for the column, when available.;T;@�;0@�@@�0U;[i�I"DateMatcher;TI"CSV::DateMatcher;T;0o;;[o;	;[I"@A Regexp used to find and convert some common Date formats.;T;@�;0@�@@�0U;[i�I"DateTimeMatcher;TI"CSV::DateTimeMatcher;T;0o;;[o;	;[I"DA Regexp used to find and convert some common DateTime formats.;T;@�;0@�@@�0U;[i�I"ConverterEncoding;TI"CSV::ConverterEncoding;T;0o;;[o;	;[I")The encoding used by all converters.;T;@�;0@�@@�0U;[i�I"Converters;TI"CSV::Converters;T;0o;;[
o;	;[I"RThis Hash holds the built-in converters of CSV that can be accessed by name. ;TI"PYou can select Converters with CSV.convert() or through the +options+ Hash ;TI"passed to CSV::new().;T@o;;;;[o;;[I"<tt>:integer</tt>;T;[o;	;[I"*Converts any field Integer() accepts.;To;;[I"<tt>:float</tt>;T;[o;	;[I"(Converts any field Float() accepts.;To;;[I"<tt>:numeric</tt>;T;[o;	;[I"(A combination of <tt>:integer</tt> ;TI"and <tt>:float</tt>.;To;;[I"<tt>:date</tt>;T;[o;	;[I".Converts any field Date::parse() accepts.;To;;[I"<tt>:date_time</tt>;T;[o;	;[I"2Converts any field DateTime::parse() accepts.;To;;[I"<tt>:all</tt>;T;[o;	;[I"0All built-in converters. A combination of ;TI"/<tt>:date_time</tt> and <tt>:numeric</tt>.;T@o;	;[I"OAll built-in converters transcode field data to UTF-8 before attempting a ;TI"Qconversion. If your data cannot be transcoded to UTF-8 the conversion will ;TI".fail and the field will remain unchanged.;T@o;	;[I"PThis Hash is intentionally left unfrozen and users should feel free to add ;TI":values to it that can be accessed by all CSV objects.;T@o;	;[I"PTo add a combo field, the value should be an Array of names. Combo fields ;TI"+can be nested with other combo fields.;T;@�;0@�@@�0U;[i�I"HeaderConverters;TI"CSV::HeaderConverters;T;0o;;[
o;	;[I"PThis Hash holds the built-in header converters of CSV that can be accessed ;TI"Lby name. You can select HeaderConverters with CSV.header_convert() or ;TI"5through the +options+ Hash passed to CSV::new().;T@o;;;;[o;;[I"<tt>:downcase</tt>;T;[o;	;[I"+Calls downcase() on the header String.;To;;[I"<tt>:symbol</tt>;T;[o;	;[	I"4Leading/trailing spaces are dropped, string is ;TI"3downcased, remaining spaces are replaced with ;TI"3underscores, non-word characters are dropped, ;TI"$and finally to_sym() is called.;T@o;	;[I"JAll built-in header converters transcode header data to UTF-8 before ;TI"Nattempting a conversion. If your data cannot be transcoded to UTF-8 the ;TI"?conversion will fail and the header will remain unchanged.;T@o;	;[I"PThis Hash is intentionally left unfrozen and users should feel free to add ;TI":values to it that can be accessed by all CSV objects.;T@o;	;[I"PTo add a combo field, the value should be an Array of names. Combo fields ;TI"+can be nested with other combo fields.;T;@�;0@�@@�0U;[i�I"DEFAULT_OPTIONS;TI"CSV::DEFAULT_OPTIONS;T;0o;;[o;	;[I"MThe options used when no overrides are given by calling code. They are:;T@o;;;;[o;;[I"<tt>:col_sep</tt>;T;[o;	;[I"<tt>","</tt>;To;;[I"<tt>:row_sep</tt>;T;[o;	;[I"<tt>:auto</tt>;To;;[I" <tt>:quote_char</tt>;T;[o;	;[I"<tt>'"'</tt>;To;;[I"&<tt>:field_size_limit</tt>;T;[o;	;[I"
+nil+;To;;[I" <tt>:converters</tt>;T;[o;	;[I"
+nil+;To;;[I"(<tt>:unconverted_fields</tt>;T;[o;	;[I"
+nil+;To;;[I"<tt>:headers</tt>;T;[o;	;[I"+false+;To;;[I"$<tt>:return_headers</tt>;T;[o;	;[I"+false+;To;;[I"'<tt>:header_converters</tt>;T;[o;	;[I"
+nil+;To;;[I"!<tt>:skip_blanks</tt>;T;[o;	;[I"+false+;To;;[I""<tt>:force_quotes</tt>;T;[o;	;[I"+false+;To;;[I" <tt>:skip_lines</tt>;T;[o;	;[I"
+nil+;To;;[I"%<tt>:liberal_parsing</tt>;T;[o;	;[I"+false+;T;@�;0@�@@�0[[I"Enumerable;To;;[�;@�;0@�[[I"
class;T[[;[[I"filter;T@�[I"foreach;T@�[I"
generate;T@�[I"generate_line;T@�[I"
instance;T@�[I"new;T@�[I"	open;T@�[I"
parse;T@�[I"parse_line;T@�[I"	read;T@�[I"readlines;T@�[I"
table;T@�[:protected[�[:private[�[I"
instance;T[[;[[I"<<;T@�[I"add_row;T@�[I"convert;T@�[I"converters;T@�[I"	each;T@�[I"force_quotes?;T@�[I"	gets;T@�[I"header_convert;T@�[I"header_converters;T@�[I"header_row?;T@�[I"headers;T@�[I"inspect;T@�[I"liberal_parsing?;T@�[I"	puts;T@�[I"	read;T@�[I"
readline;T@�[I"readlines;T@�[I"return_headers?;T@�[I"rewind;T@�[I"
shift;T@�[I"skip_blanks?;T@�[I"unconverted_fields?;T@�[I"write_headers?;T@�[;[�[;[[I"add_converter;T@�[I"add_unconverted_fields;T@�[I"convert_fields;T@�[I"encode_re;T@�[I"encode_str;T@�[I"escape_re;T@�[I"init_comments;T@�[I"init_converters;T@�[I"init_parsers;T@�[I"init_separators;T@�[I"parse_headers;T@�[I"raw_encoding;T@�[[I"Forwardable;To;;[o;	;[I"#IO and StringIO Delegation ###;T;@�;0@�[U:RDoc::Context::Section[i�0o;;[�;0;0[@�@�cRDoc::TopLevel