String

opAssign void opAssign(bcstring str): Undocumented in source. Be warned that the author may not have intended to support it.
opAssign void opAssign(typeof(null) _): Undocumented in source. Be warned that the author may not have intended to support it.
opBinary String opBinary(String rhs): Undocumented in source. Be warned that the author may not have intended to support it.
opBinary String opBinary(bcstring rhs): Undocumented in source. Be warned that the author may not have intended to support it.
opDollar size_t opDollar(): Undocumented in source. Be warned that the author may not have intended to support it.
opEquals bool opEquals(bcstring other): Undocumented in source. Be warned that the author may not have intended to support it.
opEquals bool opEquals(String other): Undocumented in source. Be warned that the author may not have intended to support it.
opEquals bool opEquals(typeof(null) _): Undocumented in source. Be warned that the author may not have intended to support it.
opIndex bcstring opIndex(): Undocumented in source. Be warned that the author may not have intended to support it.
opIndex char opIndex(size_t index): Undocumented in source. Be warned that the author may not have intended to support it.
opIndexAssign void opIndexAssign(char v, size_t index): Undocumented in source. Be warned that the author may not have intended to support it.
opOpAssign void opOpAssign(String rhs): Undocumented in source. Be warned that the author may not have intended to support it.
opOpAssign void opOpAssign(bcstring rhs): Undocumented in source. Be warned that the author may not have intended to support it.
opSlice bcstring opSlice(size_t start, size_t end): Undocumented in source. Be warned that the author may not have intended to support it.
opSliceAssign void opSliceAssign(char v, size_t start, size_t end): Undocumented in source. Be warned that the author may not have intended to support it.
opSliceAssign void opSliceAssign(bcstring str, size_t start, size_t end): Undocumented in source. Be warned that the author may not have intended to support it.
put void put(bcstring chars): Undocumented in source. Be warned that the author may not have intended to support it.
put void put(String str): Undocumented in source. Be warned that the author may not have intended to support it.
put void put(char ch): Undocumented in source. Be warned that the author may not have intended to support it.
put void put(Range r): Undocumented in source. Be warned that the author may not have intended to support it.
putMany void putMany(Params params): Undocumented in source. Be warned that the author may not have intended to support it.

Properties

length size_t length [@property setter]: Undocumented in source. Be warned that the author may not have intended to support it.
length size_t length [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.
ptrUnsafe const(char)* ptrUnsafe [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.
rangeUnsafe bcstring rangeUnsafe [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.
sliceUnsafe bcstring sliceUnsafe [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.

Examples

1 auto s = String("Hello");
2 assert(s.isSmall); // .isSmall is a private function
3 assert(!s.isCompletelyEmpty); // ^^^
4 assert(s.length == 5);
5 assert(s == "Hello");
6 assert(s.ptrUnsafe[5] == '\0');
7 
8 auto s2 = s;
9 assert(s2.isSmall && !s2.isCompletelyEmpty);
10 assert(s2.length == 5);
11 assert(s2 == "Hello");
12 s2.put(", world!");
13 assert(s2.length == 13);
14 assert(s.length == 5);
15 assert(s2 == "Hello, world!");
16 assert(s2.ptrUnsafe[13] == '\0');
17 
18 s = String("This is a big string that is bigger than 22 characters long!");
19 assert(!s.isSmall);
20 assert(s.length == 60);
21 assert(s == "This is a big string that is bigger than 22 characters long!");
22 assert(s.ptrUnsafe[60] == '\0');
23 
24 s2 = s;
25 assert(!s2.isSmall);
26 assert(s2.length == 60);
27 assert(s2._store.bigPtr !is s._store.bigPtr);
28 s.__xdtor();
29 s2.put("This shouldn't crash because we copied things.");
30 assert(s2 == "This is a big string that is bigger than 22 characters long!This shouldn't crash because we copied things.");
31 assert(s2.ptrUnsafe[s2.length] == '\0');
32 
33 s2.length = 60;
34 assert(s2.length == 60);
35 assert(s2 == "This is a big string that is bigger than 22 characters long!");
36 assert(s2.ptrUnsafe[60] == '\0');
37 
38 s2.length = 61;
39 assert(s2 == "This is a big string that is bigger than 22 characters long!"~char.init);
40 assert(s2.ptrUnsafe[61] == '\0');
41 
42 // Making sure we don't crash when using any of these things from a .init state.
43 s2.__xdtor();
44 assert(!s2.isSmall && s2.isCompletelyEmpty);
45 assert(s2.ptrUnsafe is null);
46 assert(s2.sliceUnsafe is null);
47 assert(s2.length == 0);
48 s2.put("abc");
49 assert(s2.isSmall);
50 
51 assert(s2 == "abc");
52 assert(s2 == String("abc"));
53 assert(s2 != null);
54 s2 = null;
55 assert(s2 == null);
56 
57 s2 = "abc";
58 assert(s2.isSmall);
59 assert(s2 == "abc");
60 assert(s2[1] == 'b');
61 assert(s2[0..2] == "ab");
62 assert(s2[3..3].length == 0);
63 assert(s2[] == "abc");
64 
65 s2[1] = 'd';
66 assert(s2 == "adc");
67 s2[0..2] = 'b';
68 assert(s2 == "bbc");
69 s2[0..3] = "put";
70 assert(s2 == "put");
71 
72 assert(s2 ~ "in" == "putin");
73 assert(s2 ~ String("ty") == "putty");
74 s2 ~= " it ";
75 assert(s2 == "put it ");
76 s2 ~= String("in mah belleh");
77 assert(s2 == "put it in mah belleh");

String

Constructors

Destructor

Postblit

Members

Aliases

Functions

Properties

Examples

Meta

Source