|
@@ -22,12 +22,12 @@ package;
|
|
|
*/
|
|
|
/**
|
|
|
The basic String class.
|
|
|
-
|
|
|
+
|
|
|
A haxe String is immutable, it is not possible to modify individual
|
|
|
characters. No method of this class changes the state of [this] String.
|
|
|
-
|
|
|
+
|
|
|
Strings can be constructed using the string literal syntax "string value".
|
|
|
-
|
|
|
+
|
|
|
String can be concatenated by using the + operator. If an operand is not a
|
|
|
String, it is passed through Std.string() first.
|
|
|
**/
|
|
@@ -55,7 +55,7 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Returns a String where all characters of [this] String are upper case.
|
|
|
-
|
|
|
+
|
|
|
Affects the characters [a-z]. Other characters remain unchanged.
|
|
|
**/
|
|
|
@:runtime public inline function toUpperCase() : String {
|
|
@@ -64,16 +64,16 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Returns a String where all characters of [this] String are lower case.
|
|
|
-
|
|
|
+
|
|
|
Affects the characters [A-Z]. Other characters remain unchanged.
|
|
|
**/
|
|
|
- inline function toLowerCase() : String {
|
|
|
+ @:runtime public inline function toLowerCase() : String {
|
|
|
return untyped this.lower();
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
Returns the character at position [index] of [this] String.
|
|
|
-
|
|
|
+
|
|
|
If [index] is negative or exceeds [this].length, the empty String ""
|
|
|
is returned.
|
|
|
**/
|
|
@@ -84,9 +84,9 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Returns the character code at position [index] of [this] String.
|
|
|
-
|
|
|
+
|
|
|
If [index] is negative or exceeds [this].length, null is returned.
|
|
|
-
|
|
|
+
|
|
|
To obtain the character code of a single character, "x".code can be used
|
|
|
instead to inline the character code at compile time. Note that this
|
|
|
only works on String literals of length 1.
|
|
@@ -99,12 +99,12 @@ extern class String extends StringImpl {
|
|
|
/**
|
|
|
Returns the position of the leftmost occurence of [str] within [this]
|
|
|
String.
|
|
|
-
|
|
|
+
|
|
|
If [startIndex] is given, the search is performed within the substring
|
|
|
of [this] String starting from [startIndex]. Otherwise the search is
|
|
|
performed within [this] String. In either case, the returned position
|
|
|
is relative to the beginning of [this] String.
|
|
|
-
|
|
|
+
|
|
|
If [str] cannot be found, -1 is returned.
|
|
|
**/
|
|
|
inline function indexOf( str : String, ?startIndex : Int ) : Int {
|
|
@@ -117,12 +117,12 @@ extern class String extends StringImpl {
|
|
|
/**
|
|
|
Returns the position of the rightmost occurence of [str] within [this]
|
|
|
String.
|
|
|
-
|
|
|
+
|
|
|
If [startIndex] is given, the search is performed within the substring
|
|
|
of [this] String from 0 to [startIndex]. Otherwise the search is
|
|
|
performed within [this] String. In either case, the returned position
|
|
|
is relative to the beginning of [this] String.
|
|
|
-
|
|
|
+
|
|
|
If [str] cannot be found, -1 is returned.
|
|
|
**/
|
|
|
inline function lastIndexOf( str : String, ?startIndex : Int ) : Int {
|
|
@@ -131,16 +131,16 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Splits [this] String at each occurence of [delimiter].
|
|
|
-
|
|
|
+
|
|
|
If [delimiter] is the empty String "", [this] String is split into an
|
|
|
Array of [this].length elements, where the elements correspond to the
|
|
|
characters of [this] String.
|
|
|
-
|
|
|
+
|
|
|
If [delimiter] is not found within [this] String, the result is an Array
|
|
|
with one element, which equals [this] String.
|
|
|
-
|
|
|
+
|
|
|
If [delimiter] is null, the result is unspecified.
|
|
|
-
|
|
|
+
|
|
|
Otherwise, [this] String is split into parts at each occurence of
|
|
|
[delimiter]. If [this] String starts (or ends) with [delimiter}, the
|
|
|
result Array contains a leading (or trailing) empty String "" element.
|
|
@@ -150,17 +150,17 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Returns [len] characters of [this] String, starting at position [pos].
|
|
|
-
|
|
|
+
|
|
|
If [len] is omitted, all characters from position [pos] to the end of
|
|
|
[this] String are included.
|
|
|
-
|
|
|
+
|
|
|
If [pos] is negative, its value is calculated from the end of [this]
|
|
|
String by [this].length + [pos]. If this yields a negative value, 0 is
|
|
|
used instead.
|
|
|
-
|
|
|
+
|
|
|
If the calculated position + [len] exceeds [this].length, the characters
|
|
|
from that position to the end of [this] String are returned.
|
|
|
-
|
|
|
+
|
|
|
If [len] is negative, the result is unspecified.
|
|
|
**/
|
|
|
inline public function substr( pos : Int, ?len : Int ) : String
|
|
@@ -170,14 +170,14 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Returns the part of [this] String from [startIndex] to [endIndex].
|
|
|
-
|
|
|
+
|
|
|
If [startIndex] or [endIndex] are negative, 0 is used instead.
|
|
|
-
|
|
|
+
|
|
|
If [startIndex] exceeds [endIndex], they are swapped.
|
|
|
-
|
|
|
+
|
|
|
If the (possibly swapped) [endIndex] is omitted or exceeds
|
|
|
[this].length, [this].length is used instead.
|
|
|
-
|
|
|
+
|
|
|
If the (possibly swapped) [startIndex] exceeds [this].length, the empty
|
|
|
String "" is returned.
|
|
|
**/
|
|
@@ -192,7 +192,7 @@ extern class String extends StringImpl {
|
|
|
|
|
|
/**
|
|
|
Returns the String corresponding to the character code [code].
|
|
|
-
|
|
|
+
|
|
|
If [code] is negative or has another invalid value, the result is
|
|
|
unspecified.
|
|
|
**/
|
|
@@ -201,7 +201,7 @@ extern class String extends StringImpl {
|
|
|
}
|
|
|
|
|
|
static function __init__ ():Void {
|
|
|
-
|
|
|
+
|
|
|
python.Macros.importFromAs("builtins", "str", "String");
|
|
|
//untyped __python__("String = __builtin__.str");
|
|
|
}
|