ExpectString and ExpectOneOfString implemented

errors.go

@@ -6,4 +6,5 @@ import (
 
 var (
 	ErrNothingToUnread = adverr.NewErrTmpl("ErrNothingToUnread", "Unreading failed because there wasn't any Read yet")
+	ErrNoMatchFound    = adverr.NewErrTmpl("ErrNoMatchFound", "no match found")
 )

position.go

@@ -10,7 +10,7 @@ func (p *Position) Advance(rn rune) {
 	p.Index++
 	if rn == '\n' {
 		p.Line++
-		p.Column = 0
+		p.Column = 1
 	} else {
 		p.Column++
 	}

reader.go

@@ -18,7 +18,7 @@ func New(r io.Reader) *Reader {
 	return &Reader{
 		buf: ds.NewArrayStack[posRune](),
 		src: bufio.NewReader(r),
-		pos: &Position{},
+		pos: &Position{Index: 0, Line: 1, Column: 1},
 	}
 }
 
@@ -33,8 +33,8 @@ func (r *Reader) psrn(rn rune) posRune {
 	}
 }
 
-func (r *Reader) Pos() (index, line, column int) {
+func (r *Reader) Pos() Position {
-	return r.pos.Index, r.pos.Line, r.pos.Column
+	return *r.pos
 }
 
 // Rune returns the next rune in r
@@ -176,16 +176,24 @@ func (r *Reader) PeekStringUntil(f ...RuneFunc) (string, error) {
 }
 
 // SkipUntil acts as StringUntil but discards the string
+// The rune for which that function returned false will be unread.
 func (r *Reader) SkipUntil(f ...RuneFunc) error {
 	_, err := r.StringUntil(f...)
+	if err != nil {
 		return err
 	}
+	return r.UnreadRune()
+}
 
-// SkipWhile acts as StringWhile but discards the string
+// SkipWhile acts as StringWhile but discards the string.
+// The rune for which that function returned false will be unread.
 func (r *Reader) SkipWhile(f ...RuneFunc) error {
 	_, err := r.StringWhile(f...)
+	if err != nil {
 		return err
 	}
+	return r.UnreadRune()
+}
 
 // ExpectRune returns true if any function returns true for the next rune read from r
 func (r *Reader) ExpectRune(f ...RuneFunc) (bool, error) {
@@ -196,6 +204,48 @@ func (r *Reader) ExpectRune(f ...RuneFunc) (bool, error) {
 	return findFirstTrue(rn, f), nil
 }
 
+// ExpectString calls ExpectRune for each rune in str successively.
+// If the expected string was not found, all read runes will be unread
+func (r *Reader) ExpectString(str string) (bool, error) {
+	read := 0
+	for _, rn := range str {
+		ok, err := r.ExpectRune(Is(rn))
+		if err != nil {
+			return false, err
+		}
+
+		read++
+
+		if !ok {
+			if err := r.UnreadRunes(read); err != nil {
+				return false, err
+			}
+			return false, nil
+		}
+	}
+
+	return true, nil
+}
+
+// ExpectOneOfString calls ExpectString for each string successively
+// and returns the string which first matched.
+// The returned string will not be unread.
+// If no string matches, ErrNoMatchFound is returned
+func (r *Reader) ExpectOneOfString(str ...string) (string, error) {
+	for _, s := range str {
+		ok, err := r.ExpectString(s)
+		if err != nil {
+			return "", err
+		}
+
+		if ok {
+			return s, nil
+		}
+	}
+
+	return "", ErrNoMatchFound
+}
+
 // Commit clears the internal buffer and therefore removes all data which were already read.
 // After calling Commit any unreads will return ErrNothingToUnread until another read occured.
 func (r *Reader) Commit() {

reader_test.go

@@ -11,8 +11,8 @@ func TestPos(t *testing.T) {
 
 	unread := false
 	for rn, err := r.Rune(); err == nil; rn, err = r.Rune() {
-		index, line, col := r.Pos()
+		pos := r.Pos()
-		fmt.Println(string(rn), index, line, col)
+		fmt.Println(string(rn), pos.Index, pos.Line, pos.Column)
 
 		if !unread && rn == '\n' {
 			for i := 0; i < 5; i++ {

runefunc.go

@@ -12,8 +12,12 @@ func IsSpace(rn rune) bool {
 	return rn == ' '
 }
 
+func IsTab(rn rune) bool {
+	return rn == '\t'
+}
+
 func IsWhitespace(rn rune) bool {
-	return IsSpace(rn) || IsNewLine(rn)
+	return IsSpace(rn) || IsTab(rn) || IsNewLine(rn)
 }
 
 func And(f ...RuneFunc) RuneFunc {