add example

README.md

@@ -2,9 +2,13 @@
 
 [![Build Status](https://secure.travis-ci.org/goodby/csv.png?branch=master)](https://travis-ci.org/goodby/csv)
 
-## What is Csv?
+## What is "Goodby CSV"?
 
-editing...
+Goodby CSV is a flexible and extendable open-source CSV import/export library.
+
+```php
+// Sample code... writing...
+```
 
 ## Requirements
 

exmaple/sample.php

@@ -0,0 +1,34 @@
+<?php
+
+require_once __DIR__.'/../vendor/autoload.php'; // load composer
+
+use Goodby\CSV\Import\Standard\Lexer;
+use Goodby\CSV\Import\Standard\Interpreter;
+use Goodby\CSV\Import\Standard\LexerConfig;
+use Goodby\CSV\Export\Standard\Exporter;
+use Goodby\CSV\Export\Standard\ExporterConfig;
+
+$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', 'root', array(
+    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
+));
+$pdo->query('CREATE TABLE IF NOT EXISTS user (id INT, `name` VARCHAR(255), email VARCHAR(255))');
+
+// Importing
+$config = new LexerConfig();
+$lexer = new Lexer($config);
+$interpreter = new Interpreter();
+$interpreter->addObserver(function(array $columns) use ($pdo) {
+    $stmt = $pdo->prepare('INSERT INTO user (id, name, email) VALUES (?, ?, ?)');
+    $stmt->execute($columns);
+});
+$lexer->parse('user.csv', $interpreter);
+
+// Exporting
+$config = new ExporterConfig();
+$exporter = new Exporter($config);
+$exporter->export('php://output', array(
+    array('1', 'alice', '[email protected]'),
+    array('2', 'bob', '[email protected]'),
+    array('3', 'carol', '[email protected]'),
+));
+

exmaple/user.csv

@@ -0,0 +1,3 @@
+1,alice,[email protected]
+2,bob,[email protected]
+3,carol,[email protected]

src/Goodby/CSV/Export/Standard/Exporter.php

@@ -85,7 +85,12 @@ private function replaceNewline($pointer, $newline)
          * has hardcoded "\n", this method seek one character back
          * and replace newline code with what client code wish.
          */
-        fseek($pointer, ftell($pointer) - 1);
+        $result = @fseek($pointer, ftell($pointer) - 1);
+
+        if ( $result === -1 ) {
+            return; // case: php://output, php://stdout and so on
+        }
+
         fputs($pointer, $newline);
     }