parseCSV 0.3.0

- Changed to the MIT license.

- Added offset and limit options.

- Added SQL-like conditions for quickly
  filtering out entries. Documentation on the
  condition syntax is forthcoming.

- Small parsing modification to comply
  with some recent changes to the specifications
  outlined on Wikipedia's Comma-separated values
  article.

- Minor changes and optimizations, and a few
  spelling corrections. Oops :)

git-svn-id: http://parsecsv-for-php.googlecode.com/svn/trunk@14 339761fc-0c37-0410-822d-8b8cac1f6a97

examples/_books.csv

@@ -1,7 +1,7 @@
-rating,title,by,type,asin,tags,review
-0,The Killing Kind,John Connolly,Book,0340771224,,
-0,The Third Secret,Steve Berry,Book,0340899263,,
-0,The Last Templar,Raymond Khoury,Book,0752880705,,
+rating,title,author,type,asin,tags,review
+0,The Killing Kind,John Connolly,Book,0340771224,,i still haven't had time to read this one...
+0,The Third Secret,Steve Berry,Book,0340899263,,need to find time to read this book
+3,The Last Templar,Raymond Khoury,Book,0752880705,,
 5,The Traveller,John Twelve Hawks,Book,059305430X,,
 4,Crisis Four,Andy Mcnab,Book,0345428080,,
 5,Prey,Michael Crichton,Book,0007154534,,
@@ -12,4 +12,4 @@ rating,title,by,type,asin,tags,review
 4,Deception Point (Paperback),Dan Brown,Book,0671027387,book danbrown bestseller,
 5,Digital Fortress : A Thriller (Mass Market Paperback),Dan Brown,Book,0312995423,book danbrown bestseller,
 5,Angels & Demons (Mass Market Paperback),Dan Brown,Book,0671027360,book danbrown bestseller,
-5,The Da Vinci Code (Hardcover),Dan Brown,Book,0385504209,book movie danbrown bestseller davinci,
+4,The Da Vinci Code (Hardcover),Dan Brown,"   Book   ",0385504209,book movie danbrown bestseller davinci,

examples/basic.php

@@ -1,13 +1,44 @@
 <pre>
 <?php
 
+
+# include parseCSV class.
 require_once('../parsecsv.lib.php');
 
+
+# create new parseCSV object.
 $csv = new parseCSV();
 
-$csv->auto('books.csv');
 
-print_r($csv);
+# Parse '_books.csv' using automatic delimiter detection...
+$csv->auto('_books.csv');
+
+# ...or if you know the delimiter, use the parse() function.
+// $csv->parse('_books.csv');
+
+
+# Output result.
+// print_r($csv->data);
+
 
 ?>
-</pre>
+</pre>
+<style type="text/css" media="screen">
+	table { background-color: #BBB; }
+	th { background-color: #EEE; }
+	td { background-color: #FFF; }
+</style>
+<table border="0" cellspacing="1" cellpadding="3">
+	<tr>
+		<?php foreach ($csv->titles as $value): ?>
+		<th><?php echo $value; ?></th>
+		<?php endforeach; ?>
+	</tr>
+	<?php foreach ($csv->data as $key => $row): ?>
+	<tr>
+		<?php foreach ($row as $value): ?>
+		<td><?php echo $value; ?></td>
+		<?php endforeach; ?>
+	</tr>
+	<?php endforeach; ?>
+</table>

examples/conditions.php

@@ -1,15 +1,48 @@
 <pre>
 <?php
 
+
+# include parseCSV class.
 require_once('../parsecsv.lib.php');
 
+
+# create new parseCSV object.
 $csv = new parseCSV();
 
-$csv->conditions = array( 'title' => array('*paperback*', '*hardcover*') );
 
-$csv->auto('books.csv');
+# Example conditions:
+// $csv->conditions = 'title contains paperback OR title contains hardcover';
+$csv->conditions = 'author does not contain dan brown';
+// $csv->conditions = 'rating < 4 OR author is John Twelve Hawks';
+// $csv->conditions = 'rating > 4 AND author is Dan Brown';
+
+
+# Parse '_books.csv' using automatic delimiter detection.
+$csv->auto('_books.csv');
+
+
+# Output result.
+// print_r($csv->data);
 
-print_r($csv->data);
 
 ?>
-</pre>
+</pre>
+<style type="text/css" media="screen">
+	table { background-color: #BBB; }
+	th { background-color: #EEE; }
+	td { background-color: #FFF; }
+</style>
+<table border="0" cellspacing="1" cellpadding="3">
+	<tr>
+		<?php foreach ($csv->titles as $value): ?>
+		<th><?php echo $value; ?></th>
+		<?php endforeach; ?>
+	</tr>
+	<?php foreach ($csv->data as $key => $row): ?>
+	<tr>
+		<?php foreach ($row as $value): ?>
+		<td><?php echo $value; ?></td>
+		<?php endforeach; ?>
+	</tr>
+	<?php endforeach; ?>
+</table>

examples/limit.php

@@ -1,21 +1,61 @@
 <pre>
 <?php
 
+
+# include parseCSV class.
 require_once('../parsecsv.lib.php');
 
+
+# create new parseCSV object.
 $csv = new parseCSV();
 
+
 # if sorting is enabled, the whole CSV file
 # will be processed and sorted and then rows
-# are extracted based on offset and limit
+# are extracted based on offset and limit.
+#
+# if sorting is not enabled, then the least
+# amount of rows to satisfy offset and limit
+# settings will be processed. this is useful
+# with large files when you only need the
+# first 20 rows for example.
 $csv->sort_by = 'title';
 
-$csv->limit = 3;
+
+# offset from the beginning of the file,
+# ignoring the first X number of rows.
 $csv->offset = 2;
 
-$csv->auto('books.csv');
+# limit the number of returned rows.
+$csv->limit = 3;
+
+
+# Parse '_books.csv' using automatic delimiter detection.
+$csv->auto('_books.csv');
+
+
+# Output result.
+// print_r($csv->data);
 
-print_r($csv->data);
 
 ?>
-</pre>
+</pre>
+<style type="text/css" media="screen">
+	table { background-color: #BBB; }
+	th { background-color: #EEE; }
+	td { background-color: #FFF; }
+</style>
+<table border="0" cellspacing="1" cellpadding="3">
+	<tr>
+		<?php foreach ($csv->titles as $value): ?>
+		<th><?php echo $value; ?></th>
+		<?php endforeach; ?>
+	</tr>
+	<?php foreach ($csv->data as $key => $row): ?>
+	<tr>
+		<?php foreach ($row as $value): ?>
+		<td><?php echo $value; ?></td>
+		<?php endforeach; ?>
+	</tr>
+	<?php endforeach; ?>
+</table>