Some more String APIs and related protocols

Author: dwarfland

Source/Protocols.swift

@@ -46,6 +46,21 @@ public protocol IStreamable {
 	func writeTo(_ target: OutputStreamType) // deliberately different that Apple's SBL due to limitations on Island
 }
 
+public typealias TextOutputStream = ITextOutputStream
+public protocol ITextOutputStream {
+	mutating func write(_ string: String)
+}
+
+public typealias TextOutputStreamable = ITextOutputStreamable
+public protocol ITextOutputStreamable {
+	//func write<Target>(to target: inout Target) where Target : TextOutputStream
+	func write(to target: inout TextOutputStream)
+}
+
+public typealias StringProtocol = IStringProtocol
+public protocol IStringProtocol : ITextOutputStream {
+}
+
 //
 // Collections, Sequences and the like
 //

Source/String.swift

@@ -368,37 +368,7 @@ public struct SwiftString /*: Streamable*/ {
 	//
 
 	func split(_ separator: String) -> [String] {
-
-		let separatorLength = separator.length()
-		if separatorLength == 0 {
-			return [self]
-		}
-
-		#if COOPER
-		//exit nativeString.split(java.util.regex.Pattern.quote(Separator)) as not nullable
-		//Custom implementation because `mapped.split` strips empty oparts at the end, making it incomopatible with the other three platfroms.
-		var result = [String]()
-		var i = 0
-		while true {
-			let p = nativeStringValue.indexOf(separator, i)
-			if p > -1 {
-				let part = nativeStringValue.substring(i, p-i)
-				result.append(part)
-				i = p+separatorLength
-			} else {
-				let part = nativeStringValue.substring(i)
-				result.append(part)
-				break
-			}
-		}
-		return result
-		#elseif ECHOES
-		return [String](nativeStringValue.Split([separator], StringSplitOptions.None).ToList())
-		#elseif ISLAND
-		return [String](nativeStringValue.Split(separator).ToList())
-		#elseif TOFFEE
-		return [String](nativeStringValue.componentsSeparatedByString(separator))
-		#endif
+		return nativeStringValue.components(separatedBy: separator)
 	}
 
 	//

Source/String_Extensions.swift

@@ -35,9 +35,25 @@
 		}
 	}
 
+	public convenience init(describing subject: Object) {
+		/*if let instance = subject as? ITextOutputStreamable {
+			instance.write(to: )
+		} else*/ if let instance = subject as? ICustomStringConvertible {
+			return instance.description
+		} else if let instance = subject as? CustomDebugStringConvertible {
+			return instance.debugDescription
+		} else {
+			return init(subject)
+		}
+	}
+
 	public convenience init(reflecting subject: Object) {
 		if let o = subject as? ICustomDebugStringConvertible {
 			return o.debugDescription
+		} else if let instance = subject as? ICustomStringConvertible {
+			return instance.description
+		//} else if let instance = subject as? ITextOutputStreamable {
+			//instance.write(to: )
 		} else {
 			#if JAVA
 			// ToDo: fall back to reflection to call debugDescription?
@@ -112,6 +128,46 @@
 		return 0
 	}
 
+	//public var capitalized: NativeString {
+		////return uppercaseString
+	//}
+
+	//func components(separatedBy separator: CharacterSet) -> [String] {
+	//}
+
+	func components(separatedBy separator: String) -> [String] {
+		let separatorLength = separator.length()
+		if separatorLength == 0 {
+			return [self]
+		}
+
+		#if COOPER
+		//exit nativeString.split(java.util.regex.Pattern.quote(Separator)) as not nullable
+		//Custom implementation because `mapped.split` strips empty parts at the end, making it incompatible with the other three platfroms.
+		var result = [String]()
+		var i = 0
+		while true {
+			let p = indexOf(separator, i)
+			if p > -1 {
+				let part = substring(i, p-i)
+				result.append(part)
+				i = p+separatorLength
+			} else {
+				let part = substring(i)
+				result.append(part)
+				break
+			}
+		}
+		return result
+		#elseif ECHOES
+		return [String](Split([separator], StringSplitOptions.None).ToList())
+		#elseif ISLAND
+		return [String](Split(separator).ToList())
+		#elseif TOFFEE
+		return [String](componentsSeparatedByString(separator))
+		#endif
+	}
+
 	#if !COCOA
 	public var uppercaseString: NativeString {
 		#if JAVA