Add accessor for current cursor position

src/Readline.php

@@ -110,6 +110,21 @@ public function setMove($move)
         return $this;
     }
 
+    /**
+     * get current cursor position
+     *
+     * cursor position is measured in number of text characters
+     *
+     * @return int
+     * @see self::moveCursorTo() to move the cursor to a given position
+     * @see self::moveCursorBy() to move the cursor by given number of characters
+     * @see self::setMove() to toggle whether the user can move the cursor position
+     */
+    public function getCursorPosition()
+    {
+        return $this->linepos;
+    }
+
     /**
      * set current text input buffer
      *
@@ -323,11 +338,12 @@ public function deleteChar($n)
      * zero or out of range moves are simply ignored
      *
      * @param int $n
+     * @return self
      * @uses self::moveCursorTo()
      */
     public function moveCursorBy($n)
     {
-        $this->moveCursorTo($this->linepos + $n);
+        return $this->moveCursorTo($this->linepos + $n);
     }
 
     /**
@@ -336,6 +352,7 @@ public function moveCursorBy($n)
      * out of range (exceeding current input buffer) are simply ignored
      *
      * @param int $n
+     * @return self
      * @uses self::redraw()
      */
     public function moveCursorTo($n)
@@ -346,6 +363,8 @@ public function moveCursorTo($n)
 
         $this->linepos = $n;
         $this->redraw();
+
+        return $this;
     }
 
     /**

tests/ReadlineTest.php

@@ -20,11 +20,29 @@ public function testSettersReturnSelf()
     public function testInputStartsEmpty()
     {
         $this->assertEquals('', $this->readline->getInput());
+        $this->assertEquals(0, $this->readline->getCursorPosition());
     }
 
     public function testGetInputAfterSetting()
     {
         $this->assertSame($this->readline, $this->readline->setInput('hello'));
         $this->assertEquals('hello', $this->readline->getInput());
+        $this->assertEquals(5, $this->readline->getCursorPosition());
+    }
+
+    public function testSettingInputMovesCursorToEnd()
+    {
+        $this->readline->setInput('hello');
+        $this->readline->moveCursorTo(3);
+
+        $this->readline->setInput('testing');
+        $this->assertEquals(7, $this->readline->getCursorPosition());
+    }
+
+    public function testMultiByteInput()
+    {
+        $this->readline->setInput('täst');
+        $this->assertEquals('täst', $this->readline->getInput());
+        $this->assertEquals(4, $this->readline->getCursorPosition());
     }
 }