]> Cypherpunks.ru repositories - gorecfile.git/blobdiff - r.go
Writer
[gorecfile.git] / r.go
diff --git a/r.go b/r.go
index 36141715f151f5b8027ac962adf692897b40b4df..2b917ae554c7ca20fc7cf43dfae462440de41063 100644 (file)
--- a/r.go
+++ b/r.go
@@ -15,6 +15,7 @@ You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
+// GNU recutils'es recfiles parser on pure Go
 package recfile
 
 import (
@@ -25,21 +26,20 @@ import (
        "strings"
 )
 
+var KeyValRe = regexp.MustCompile(`([a-zA-Z%][a-zA-Z0-9_]*):\s*(.*)$`)
+
 type Reader struct {
        scanner *bufio.Scanner
 }
 
+// Create Reader for iterating through the records. It uses
+// bufio.Scanner, so can read more than currently parsed records take.
 func NewReader(r io.Reader) *Reader {
        return &Reader{bufio.NewScanner(r)}
 }
 
-type Field struct {
-       Name  string
-       Value string
-}
-
-var KeyValRe = regexp.MustCompile(`([a-zA-Z%][a-zA-Z0-9_]*):\s*(.*)$`)
-
+// Get next record. Each record is just a collection of fields. io.EOF
+// is returned if there is nothing to read more.
 func (r *Reader) Next() ([]Field, error) {
        fields := make([]Field, 0, 1)
        var text string