@@ -22,6 +22,52 @@ class StringSpec extends Midori_PHPUnit_Spec $value = str('I am %2$s, hear me roar, %1$s!') ->format($arg1, $arg2); + $this->expectsThat($value)->shouldBe("I am man, hear me roar, yipe!"); } + + /** + * @test + * Enter description here... + * @return unknown_type + */ + public function itShouldCompareStrings() + { + $first = str("I am first"); + $second = "Second in line"; + $cut = "cutting in line"; + $caseCute = str("Cutting in line"); + + $compare = $first->compareTo($second); + $this->expectsThat($compare)->shouldBe(-1); + + $compare = $first->compareTo($cut, true); + $this->expectsThat($compare)->shouldBe(1); + + $compare = $caseCute->compareTo($cut); + $this->expectsThat($compare)->shouldBe(-1); + + $compare = $caseCute->compareTo($cut, true); + $this->expectsThat($compare)->shouldBe(0); + } + + /** + * @test + * Enter description here... + * @return unknown_type + */ + public function itShouldConcatinateStrings() + { + $array = array("I have", " a enumerable object ", "of strings"); + $start = new Midori_String("notice:"); + $container = $start->concat(" this is a test. "); + foreach($array as $value) + $container = $container->concat($value); + + $this->expectsThat($start)->equals("notice:"); + + $this->expectsThat($container) + ->equals("notice: this is a test. I have a enumerable object of strings"); + + } } \ No newline at end of file specs/Midori/StringSpec.php @@ -20,8 +20,11 @@ final class Midori_String extends Midori_Nullable */ public function __construct($value = "") { - $this->value = (string)$value; + if($value instanceof Midori_Nullable) + $value = $value->value; + if($value != null) + $this->value = $value; } @@ -36,16 +39,99 @@ final class Midori_String extends Midori_Nullable } + /** - * returns a new Midori_String wrapping the - * value. + * creates a copy of the string and returns it. * - * @param string $value - * @return Midori_String another string!! + * <p>Creates a copy of the current unboxed string and + * returns it.</p> + * + * <pre class="brush: php"> + * $string = new Midori_String("value"); + * $copy = $string->copy(); + * echo ($string == $copy)? "true" : "false"; // true + * </pre> + * + * @return Midori_String returns a copy of the string. */ - public function copy($value) + public function copy() { - return new Midori_String($value); + return new Midori_String($this->value); + } + + + /** + * Compares the string value to another value and returns + * if its this value is less than, equal, or greater than. + * + * <p>Compares the strings and either returns 0 if the values + * are equal, -1 if the value is less than the value its + * being compared to, or 1 if the value is greater than + * the value its being compared to.</p> + * + * <p>This comparsion is helpful for sorting strings alphanumerically.</p> + * + * <pre class="brush: php"> + * $string = new Midori_String("adam"); + * $valueToCompare = "nathan"; + * $comparison = $string->compareTo($valueToCompare); + * echo $comparsion; // -1 (which is less than) + * echo $string->compareTo("adam"); // 0 (which is equal) + * echo $string->compareTo(str("abba")); 1 (which is greater than) + * </pre> + * + * @param string|Midori_String $value right side of the compare + * @param boolean $ignoreCase should the compre be case insensitive. + * @see strcmp() + * @see strcasecmp() + * @return integer 0 if its equal, -1 if the current value is less than, 1 if its greater than. + */ + public function compareTo($value, $ignoreCase = false) + { + if($value instanceof Midori_Nullable) + $value = $value->value; + + if($ignoreCase){ + $compare = strcasecmp($this->value, $value); + if($compare > 0) + return 1; + if($compare === 0) + return 0; + return -1; + } + else + return strcmp($this->value, $value); + } + + + + + /** + * Joins the current string value with the value that + * is being passed to this method. + * + * <p> + * This method takes the current string and joins the string + * that is being passed to the this method to create a new + * string of both values. + * </p> + * + * <pre class="brush: php"> + * $array = array("I have", " a enumerable object ", "of strings"); + * $start = new Midori_String("notice:"); + * $container = $start->concat(" this is a text. "); + * foreach($array as $value) + * $container = $container->concat($value); + * echo $container; // notice: this is a test. I have a enumerable object of strings + * echo $start; // notice: + * </pre> + * + * @param mixed $value + * @return Midori_String the concatinated string of both values. + */ + public function concat($value) + { + return new Midori_String($this->value .$value); } /** src/Midori/String.php cb1ff2fc6d9c02e9c21a8099cf36f4c916a83f5f U-Michael-PC\Michael Michael@Michael-PC.(none) http://github.com/michaelherndon/midori-php/commit/e949c8591a730dea753fb3ca6d4c30a9999fcfc4 e949c8591a730dea753fb3ca6d4c30a9999fcfc4 2009-06-05T21:37:05-07:00 2009-06-05T21:37:05-07:00 adding and testing the methods on Midiori_String concat(), compareTo(), and format() 16bcbcdfaef8ff6160a6e5b3cb743f0abb11ef19 U-Michael-PC\Michael Michael@Michael-PC.(none)