basic-string 1.0.0-rc.2

Mutable @nogc string struct using `std.experimental.allocator` for allocations.


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

BasicString

Content of basic-string repository was moved to BTL repository as subpackage btl:string

Documentation

https://submada.github.io/btl/btl/string.html

C++-style string for D using std.experimental.allocator.

The BasicString is the generalization of struct string for character type char, wchar and dchar.

Features

Allocator is template argument instead of using theAllocator so that string can be used in @nogc code. Default allocator is Mallocator.

BasicString use Small String Optimization (SSO)

Works with pure, @safe, @nogc and nothrow.

Compatible with -betterC

-dip1000 is too unstable, for now is not supported.

Does not rely on runtime type information (TypeInfo).

Example

pure nothrow @safe @nogc unittest {
  import std.experimental.allocator.mallocator : Mallocator;

  alias String = BasicString!(
    char,               //character type
    Mallocator,         //allocator type (can be stateless or with state)
    32                  //additional padding to increas max size of small string (small string does not allocate memory).
  );

  //copy:
  {
    String a = "123";
    String b = a;
    
    a = "456"d;
    
    assert(a == "456");
    assert(b == "123");
  }
  
  
  //append:
  {
    String str = "12";

    str.append("34");   //same as str += "34"
    str.append("56"w);  //same as str += "56"w
    str.append(7);      //same as str += 7;
    str.append('8');

    assert(str == "12345678");

    str.clear();

    assert(str.empty);

  }

  //erase:
  {
    String str = "123456789";

    str.erase(2, 2);

    assert(str == "1256789");
  }

  //insert:
  {
    String str = "123456789";

    str.insert(1, "xyz");

    assert(str == "1xyz23456789");
  }

  //replace:
  {
    String str = "123456789";

    str.replace(1, 2, "xyz");

    assert(str == "1xyz456789");
  }

  //slice to string:
  ()@trusted{
    String str = "123456789";

    string dstr = str[];

    assert(str == dstr);
  }();
}
Authors:
  • Adam Búš
Dependencies:
btl:string
Versions:
1.0.0-rc.2 2022-Jan-24
0.3.0-rc.5 2022-Jan-18
0.3.0-rc.4 2022-Jan-17
0.3.0-rc.2 2022-Jan-17
0.3.0-rc.1 2022-Jan-16
Show all 13 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 1 downloads this month

  • 57 downloads total

Score:
0.6
Short URL:
basic-string.dub.pm