Added doc & tests for SETRANGE.

nicolasff · nicolasff · commit fe09260f5465 · 2010-12-17T09:55:57.000+01:00
diff --git a/README.markdown b/README.markdown
@@ -1392,6 +1392,25 @@ $redis->getRange('key', 0, 5); /* 'string' */
 $redis->getRange('key', -5, -1); /* 'value' */
 </pre>
 
+## setRange
+##### *Description*
+Changes a substring of a larger string.
+
+##### *Parameters*
+*key*  
+*offset*  
+*value*  
+
+##### *Return value*
+*STRING*: the length of the string after it was modified.
+
+##### *Example*
+<pre>
+$redis->set('key', 'Hello world');
+$redis->setRange('key', 6, "redis"); /* returns 11 */
+$redis->get('key'); /* "Hello redis" */
+</pre>
+
 ## strlen
 ##### *Description*
 Get the length of a string value.
diff --git a/tests/TestRedis.php b/tests/TestRedis.php
@@ -453,9 +453,9 @@ public function testStr() {
 		$this->assertTrue($this->redis->get('keyNotExist') === 'value');
 
 		$this->redis->set('key', 'This is a string') ;
-		$this->assertTrue($this->redis->substr('key', 0, 3) === 'This');
-		$this->assertTrue($this->redis->substr('key', -6, -1) === 'string');
-		$this->assertTrue($this->redis->substr('key', -6, 100000) === 'string');
+		$this->assertTrue($this->redis->getRange('key', 0, 3) === 'This');
+		$this->assertTrue($this->redis->getRange('key', -6, -1) === 'string');
+		$this->assertTrue($this->redis->getRange('key', -6, 100000) === 'string');
 		$this->assertTrue($this->redis->get('key') === 'This is a string');
 
 		$this->redis->set('key', 'This is a string') ;
@@ -1778,6 +1778,25 @@ public function testHashes() {
 
     }
 
+    public function testSetRange() {
+
+	    $this->redis->delete('key');
+	    $this->redis->set('key', 'hello world');
+	    $this->redis->setRange('key', 6, 'redis');
+	    $this->assertTrue('hello redis' === $this->redis->get('key'));
+	    $this->redis->setRange('key', 6, 'you'); // don't cut off the end
+	    $this->assertTrue('hello youis' === $this->redis->get('key'));
+
+	    $this->assertTrue(FALSE === $this->redis->setRange('key', -1, 'plop')); // doesn't work with negative offsets
+
+	    // fill with zeros if needed
+	    $this->redis->delete('key');
+	    $this->redis->setRange('key', 6, 'foo');
+	    $this->assertTrue("\x00\x00\x00\x00\x00\x00foo" === $this->redis->get('key'));
+
+
+    }
+
     public function testMultiExec() {
 	$this->sequence(Redis::MULTI);
 
