Gecko [ www.beriskala.com ]

Name	Size	Permission	Date
MalformedCSVError	[ DIR ]	drwxr-xr-x	2026-05-01 04:24
Row	[ DIR ]	drwxr-xr-x	2026-05-01 04:24
Table	[ DIR ]	drwxr-xr-x	2026-05-01 04:24
%3c%3c-i.ri	532 B	-rw-r--r--	2023-07-26 17:26
add_converter-i.ri	605 B	-rw-r--r--	2023-07-26 17:26
add_row-i.ri	143 B	-rw-r--r--	2023-07-26 17:26
add_unconverted_fields-i.ri	423 B	-rw-r--r--	2023-07-26 17:26
cdesc-CSV.ri	10.17 KB	-rw-r--r--	2023-07-26 17:26
col_sep-i.ri	259 B	-rw-r--r--	2023-07-26 17:26
convert-i.ri	802 B	-rw-r--r--	2023-07-26 17:26
convert_fields-i.ri	550 B	-rw-r--r--	2023-07-26 17:26
converters-i.ri	355 B	-rw-r--r--	2023-07-26 17:26
dump-c.ri	2.09 KB	-rw-r--r--	2023-07-26 17:26
each-i.ri	347 B	-rw-r--r--	2023-07-26 17:26
encode_re-i.ri	297 B	-rw-r--r--	2023-07-26 17:26
encode_str-i.ri	287 B	-rw-r--r--	2023-07-26 17:26
encoding-i.ri	317 B	-rw-r--r--	2023-07-26 17:26
escape_re-i.ri	548 B	-rw-r--r--	2023-07-26 17:26
field_size_limit-i.ri	246 B	-rw-r--r--	2023-07-26 17:26
filter-c.ri	1.32 KB	-rw-r--r--	2023-07-26 17:26
force_quotes%3f-i.ri	263 B	-rw-r--r--	2023-07-26 17:26
foreach-c.ri	1.04 KB	-rw-r--r--	2023-07-26 17:26
generate-c.ri	1010 B	-rw-r--r--	2023-07-26 17:26
generate_line-c.ri	832 B	-rw-r--r--	2023-07-26 17:26
gets-i.ri	134 B	-rw-r--r--	2023-07-26 17:26
header_convert-i.ri	497 B	-rw-r--r--	2023-07-26 17:26
header_converters-i.ri	382 B	-rw-r--r--	2023-07-26 17:26
header_row%3f-i.ri	243 B	-rw-r--r--	2023-07-26 17:26
headers-i.ri	356 B	-rw-r--r--	2023-07-26 17:26
init_converters-i.ri	627 B	-rw-r--r--	2023-07-26 17:26
init_headers-i.ri	262 B	-rw-r--r--	2023-07-26 17:26
init_parsers-i.ri	265 B	-rw-r--r--	2023-07-26 17:26
init_separators-i.ri	672 B	-rw-r--r--	2023-07-26 17:26
inspect-i.ri	273 B	-rw-r--r--	2023-07-26 17:26
instance-c.ri	636 B	-rw-r--r--	2023-07-26 17:26
lineno-i.ri	292 B	-rw-r--r--	2023-07-26 17:26
load-c.ri	782 B	-rw-r--r--	2023-07-26 17:26
new-c.ri	6.16 KB	-rw-r--r--	2023-07-26 17:26
open-c.ri	2.86 KB	-rw-r--r--	2023-07-26 17:26
parse-c.ri	663 B	-rw-r--r--	2023-07-26 17:26
parse_headers-i.ri	697 B	-rw-r--r--	2023-07-26 17:26
parse_line-c.ri	505 B	-rw-r--r--	2023-07-26 17:26
puts-i.ri	137 B	-rw-r--r--	2023-07-26 17:26
quote_char-i.ri	268 B	-rw-r--r--	2023-07-26 17:26
raw_encoding-i.ri	327 B	-rw-r--r--	2023-07-26 17:26
read-c.ri	849 B	-rw-r--r--	2023-07-26 17:26
read-i.ri	341 B	-rw-r--r--	2023-07-26 17:26
readline-i.ri	142 B	-rw-r--r--	2023-07-26 17:26
readlines-c.ri	210 B	-rw-r--r--	2023-07-26 17:26
readlines-i.ri	144 B	-rw-r--r--	2023-07-26 17:26
return_headers%3f-i.ri	289 B	-rw-r--r--	2023-07-26 17:26
rewind-i.ri	243 B	-rw-r--r--	2023-07-26 17:26
row_sep-i.ri	259 B	-rw-r--r--	2023-07-26 17:26
shift-i.ri	533 B	-rw-r--r--	2023-07-26 17:26
skip_blanks%3f-i.ri	273 B	-rw-r--r--	2023-07-26 17:26
table-c.ri	445 B	-rw-r--r--	2023-07-26 17:26
unconverted_fields%3f-i.ri	292 B	-rw-r--r--	2023-07-26 17:26
write_headers%3f-i.ri	266 B	-rw-r--r--	2023-07-26 17:26

Rename

U:RDoc::NormalClass[iI"CSV:EF@I"Object;Fo:RDoc::Markup::Document:@parts[o;;[;o:RDoc::Markup::Paragraph;[I"OThis class provides a complete interface to CSV files and data. It offers;TI"Ptools 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|
;FI" # use row here...
;FI"	end
;FS;;i	;
I"All at Once;T@o;;[I"0arr_of_arrs = CSV.read("path/to/file.csv")
;FS;;i;
I"From a String;T@S;;i	;
I"A Line at a Time;T@o;;[I"+CSV.parse("CSV,data,String") do |row|
;FI" # use row here...
;FI"	end
;FS;;i	;
I"All at Once;T@o;;[I"0arr_of_arrs = CSV.parse("CSV,data,String")
;FS;;i;
I"Writing;T@S;;i;
I"To a File;T@o;;[
I"1CSV.open("path/to/file.csv", "wb") do |csv|
;FI"+ csv << ["row", "of", "CSV", "data"]
;FI"! csv << ["another", "row"]
;FI"
 # ...
;FI"	end
;FS;;i;
I"To a String;T@o;;[
I"(csv_string = CSV.generate do |csv|
;FI"+ csv << ["row", "of", "CSV", "data"]
;FI"! csv << ["another", "row"]
;FI"
 # ...
;FI"	end
;FS;;i;
I"Convert a Single Line;T@o;;[I"4csv_string = ["CSV", "data"].to_csv # to CSV
;FI"6csv_array = "CSV,String".parse_csv # from CSV
;FS;;i;
I"Shortcut Interface;T@o;;[	I"MCSV { |csv_out| csv_out << %w{my data here} } # to $stdout
;FI"NCSV(csv = "") { |csv_str| csv_str << %w{my data here} } # to a String
;FI"MCSV($stderr) { |csv_err| csv_err << %w{my data here} } # to $stderr
;FI"NCSV($stdin) { |csv_in| csv_in.each { |row| p row } } # from $stdin
;FS;;i;
I"Advanced Usage;T@S;;i;
I"Wrap an IO Object;T@o;;[I" csv = CSV.new(io, options)
;FI"Q# ... read (with gets() or each()) from and write (with <<) to csv here ...
;FS;;i;
I">CSV and Character Encodings (M17n or Multilingualization);T@o;	;[I"SThis new CSV parser is m17n savvy. The parser works in the Encoding of the IO;TI"Sor String object being read from or written to. Your data is never transcoded;TI"R(unless you ask Ruby to transcode it for you) and will literally be parsed in;TI"Rthe Encoding it is in. Thus CSV will return Arrays or Rows of Strings in the;TI"REncoding of your data. This is accomplished by transcoding the parser itself;TI"into your Encoding.;T@o;	;[I"RSome transcoding must take place, of course, to accomplish this multiencoding;TI"Esupport. For example, <tt>:col_sep</tt>, <tt>:row_sep</tt>, and;TI"P<tt>:quote_char</tt> must be transcoded to match your data. Hopefully this;TI"Pmakes the entire process feel transparent, since CSV's defaults should just;TI"Pmagically work for you data. However, you can set these values manually in;TI"2the target Encoding to avoid the translation.;T@o;	;[I"KIt's also important to note that while all of CSV's core parser is now;TI"IEncoding agnostic, some features are not. For example, the built-in;TI"Nconverters will try to transcode data to UTF-8 before making conversions.;TI"QAgain, you can provide custom converters that are aware of your Encodings to;TI"Iavoid this translation. It's just too hard for me to support native;TI",conversions in all of Ruby's Encodings.;T@o;	;[	I"SAnyway, the practical side of this is simple: make sure IO and String objects;TI"Rpassed into CSV have the proper Encoding set and everything should just work.;TI"PCSV 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"QOne minor exception comes when generating CSV into a String with an Encoding;TI"Nthat is not ASCII compatible. There's no existing data for CSV to use to;TI"Sprepare itself and thus you will probably need to manually specify the desired;TI"REncoding 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"QI try to point out any other Encoding issues in the documentation of methods;TI"as they come up.;T@o;	;[	I"RThis has been tested to the best of my ability with all non-"dummy" Encodings;TI"LRuby ships with. However, it is brave new code and may have some bugs.;TI"RPlease feel free to {report}[mailto:james@grayproductions.net] any issues you;TI"find with it.;T:
@fileI"lib/csv.rb;T;0[[
I"col_sep;FI"R;F:publicF@�[
I"
encoding;FI"R;F;F@�[
I"field_size_limit;FI"R;F;F@�[
I"lineno;FI"R;F;F@�[
I"quote_char;FI"R;F;F@�[
I"row_sep;FI"R;F;F@�[
[I"VERSION;Fo;;[o;	;[I"*The version of the installed library.;T;0@�[I"FieldInfo;Fo;;[o;	;[	I"MA FieldInfo Struct contains details about a field's position in the data;TI"Qsource it was read from. CSV will pass this Struct to some blocks that make;TI"Idecisions based on field structure. See CSV.convert_fields() for an;TI"
example.;T@o:RDoc::Markup::List:
@type:	NOTE:@items[o:RDoc::Markup::ListItem:@labelI"<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@�[I"DateMatcher;Fo;;[o;	;[I"@A Regexp used to find and convert some common Date formats.;T;0@�[I"DateTimeMatcher;Fo;;[o;	;[I"DA Regexp used to find and convert some common DateTime formats.;T;0@�[I"ConverterEncoding;Fo;;[o;	;[I")The encoding used by all converters.;T;0@�[I"Converters;Fo;;[
o;	;[I"QThis Hash holds the built-in converters of CSV that can be accessed by name.;TI"OYou 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"/All built-in converters. A combination of;TI"/<tt>:date_time</tt> and <tt>:numeric</tt>.;T@o;	;[I"NAll built-in converters transcode field data to UTF-8 before attempting a;TI"Pconversion. If your data cannot be transcoded to UTF-8 the conversion will;TI".fail and the field will remain unchanged.;T@o;	;[I"OThis 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"OTo add a combo field, the value should be an Array of names. Combo fields;TI"+can be nested with other combo fields.;T;0@�[I"HeaderConverters;Fo;;[
o;	;[I"OThis Hash holds the built-in header converters of CSV that can be accessed;TI"Kby 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"/The header String is downcased, spaces are;TI"3replaced with underscores, non-word characters;TI"1are dropped, and finally to_sym() is called.;T@o;	;[I"IAll built-in header converters transcode header data to UTF-8 before;TI"Mattempting 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"NThis Hash is intetionally left unfrozen and users should feel free to add;TI":values to it that can be accessed by all CSV objects.;T@o;	;[I"OTo add a combo field, the value should be an Array of names. Combo fields;TI"+can be nested with other combo fields.;T;0@�[I"DEFAULT_OPTIONS;Fo;;[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+;T;0@�[[I"Enumerable;Fo;;[�;0@�[[I"
class;F[[;[[I"	dump;F@�[I"filter;F@�[I"foreach;F@�[I"
generate;F@�[I"generate_line;F@�[I"
instance;F@�[I"	load;F@�[I"new;F@�[I"	open;F@�[I"
parse;F@�[I"parse_line;F@�[I"	read;F@�[I"readlines;F@�[I"
table;F@�[:protected[�[:private[�[I"
instance;F[[;[[I"<<;F@�[I"add_row;F@�[I"convert;F@�[I"converters;F@�[I"	each;F@�[I"force_quotes?;F@�[I"	gets;F@�[I"header_convert;F@�[I"header_converters;F@�[I"header_row?;F@�[I"headers;F@�[I"inspect;F@�[I"	puts;F@�[I"	read;F@�[I"
readline;F@�[I"readlines;F@�[I"return_headers?;F@�[I"rewind;F@�[I"
shift;F@�[I"skip_blanks?;F@�[I"unconverted_fields?;F@�[I"write_headers?;F@�[;[�[;[[I"add_converter;F@�[I"add_unconverted_fields;F@�[I"convert_fields;F@�[I"encode_re;F@�[I"encode_str;F@�[I"escape_re;F@�[I"init_converters;F@�[I"init_headers;F@�[I"init_parsers;F@�[I"init_separators;F@�[I"parse_headers;F@�[I"raw_encoding;F@�