Added substitute method - fix for issue mikechambers#164 on original fork

Author: sangupta

src/com/adobe/utils/StringUtil.as

@@ -235,5 +235,34 @@ package com.adobe.utils
 			//todo: this needs a unit test
 			return (s != null && s.length > 0);			
 		}
+		
+		/**
+		 *	Variable string injection.  Replaces all instances of '{n}' with
+		 *   the parameter equivalent where 'n' equals a number.
+		 * 
+		 *	@param string The first string to injects variables into.
+		 *
+		 *	@param ... The unlimited number of variables to be injected.
+		 *
+		 *	@returns A string with the variables injected
+		 *
+		 * 	@langversion ActionScript 3.0
+		 *	@playerversion Flash 9.0
+		 *	@tiptext
+		 */
+		public static function substitute(string:String, ...params:Array):String
+		{
+			// Check to see if there's something to inject
+			if(params && params.length > 0)
+			{
+				// Iterate through array, try to inject vars in string
+				for(var i:uint = 0, len:uint = params.length; i<len; i++)
+				{
+					string = replace(string, '{' + i + '}', params[i].toString());
+				}
+			}
+			
+			return string;
+		}
 	}
 }

tests/src/com/adobe/utils/StringUtilTest.as

@@ -32,10 +32,10 @@
 
 package com.adobe.utils
 {
+	import com.adobe.utils.StringUtil;
+	
 	import flexunit.framework.TestCase;
 	import flexunit.framework.TestSuite;
-	
-	import com.adobe.utils.StringUtil;
 
 	public class StringUtilTest extends TestCase
 	{	
@@ -306,5 +306,12 @@ package com.adobe.utils
 			assertFalse("StringUtil.stringHasValue(\"\") == false", StringUtil.stringHasValue(""));
 			assertTrue("StringUtil.stringHasValue(\"XXX\") == true", StringUtil.stringHasValue("XXX"));
 		}
+		
+		public function testSubstitute():void {
+			assertEquals(StringUtil.substitute("", 1, 2, 3), "");
+			assertEquals(StringUtil.substitute("none"), "none");
+			assertEquals(StringUtil.substitute("none", 1, 2, 3), "none");
+			assertEquals(StringUtil.substitute("This {0} {1} {2} string.", "is", "a", "test"), "This is a test string.");
+		}
 	}
 }