.

Author: androlo

docs/packages/Bytes.md

@@ -121,7 +121,6 @@ Finally, **note** that these sections deal with bytes in memory and on the stack
 - [toBytes(uint)](#tobytesuint)
 - [toBytes(uint, uint16)](#tobytesuint-uint16)
 - [toBytes(bool)](#tobytesbool)
-- [toBytes(bool)](#tobytesbool)
 - [highestByteSet(bytes32)](#highestbytesetbytes32)
 - [lowestByteSet(bytes32)](#lowestbytesetbytes32)
 - [highestByteSet(uint)](#highestbytesetuint)
@@ -516,31 +515,6 @@ Create a new `bytes memory` from a `boolean`.
 
 ***
 
-### toBytes(bool)
-
-`function toBytes(bool self) internal pure returns (bytes memory)`
-
-Create a new `bytes memory` from a boolean.
-
-##### params
-
-- `bool self`: The source boolean.
-
-
-##### returns
-
-- `bytes memory`: The boolean as a `bytes memory`. Note that the bytes array will be of length 1.
-
-##### ensures
-
-- `bts = self.toBytes() => bts.length = 1`.
-- `bts = self.toBytes() => if self == true: bts = [1], else bts = [0].
-##### gascosts
-
-- Fixed: **318**
-
-***
-
 ### highestByteSet(bytes32)
 
 `function highestByteSet(bytes32 self) internal pure returns (uint8 highest)`

examples/strings/StringExamples.sol

@@ -0,0 +1,31 @@
+pragma solidity ^0.4.16;
+pragma experimental "v0.5.0";
+pragma experimental "ABIEncoderV2";
+
+import {Strings} from '../src/strings/Strings.sol';
+
+contract StringsExamples {
+
+    using Strings for string;
+
+    function stringExampleValidateRunePoem() public pure {
+        string memory str = "ᚠᛇᚻ᛫ᛒᛦᚦ᛫ᚠᚱᚩᚠᚢᚱ᛫ᚠᛁᚱᚪ᛫ᚷᛖᚻᚹᛦᛚᚳᚢᛗ ᛋᚳᛖᚪᛚ᛫ᚦᛖᚪᚻ᛫ᛗᚪᚾᚾᚪ᛫ᚷᛖᚻᚹᛦᛚᚳ᛫ᛗᛁᚳᛚᚢᚾ᛫ᚻᛦᛏ᛫ᛞᚫᛚᚪᚾ ᚷᛁᚠ᛫ᚻᛖ᛫ᚹᛁᛚᛖ᛫ᚠᚩᚱ᛫ᛞᚱᛁᚻᛏᚾᛖ᛫ᛞᚩᛗᛖᛋ᛫ᚻᛚᛇᛏᚪᚾ";
+        str.validate();
+    }
+
+    function stringExampleValidateBrut() public pure {
+        string memory str = "An preost wes on leoden, Laȝamon was ihoten He wes Leovenaðes sone -- liðe him be Drihten. He wonede at Ernleȝe at æðelen are chirechen, Uppen Sevarne staþe, sel þar him þuhte, Onfest Radestone, þer he bock radde.";
+        str.validate();
+    }
+
+    function stringExampleValidateOdysseusElytis() public pure {
+        string memory str = "Τη γλώσσα μου έδωσαν ελληνική το σπίτι φτωχικό στις αμμουδιές του Ομήρου. Μονάχη έγνοια η γλώσσα μου στις αμμουδιές του Ομήρου. από το Άξιον Εστί του Οδυσσέα Ελύτη";
+        str.validate();
+    }
+
+    function stringExampleValidatePushkinsHorseman() public pure {
+        string memory str = "На берегу пустынных волн Стоял он, дум великих полн, И вдаль глядел. Пред ним широко Река неслася; бедный чёлн По ней стремился одиноко. По мшистым, топким берегам Чернели избы здесь и там, Приют убогого чухонца; И лес, неведомый лучам В тумане спрятанного солнца, Кругом шумел.";
+        str.validate();
+    }
+
+}

misc/EthString.sol

@@ -0,0 +1,44 @@
+library EthString {
+
+    uint internal constant MASK_0_128 = 0x00000000000000000000000000000000ffffffffffffffffffffffffffffffff;
+    uint internal constant MASK_0_128 = 0xffffffffffffffffffffffffffffffff00000000000000000000000000000000;
+
+    uint internal constant MASK_0_64 = 0x000000000000000000000000000000000000000000000000ffffffffffffffff;
+    uint internal constant MASK_1_64 = 0x00000000000000000000000000000000ffffffffffffffff0000000000000000;
+    uint internal constant MASK_2_64 = 0x0000000000000000ffffffffffffffff00000000000000000000000000000000;
+    uint internal constant MASK_3_64 = 0xffffffffffffffff000000000000000000000000000000000000000000000000;
+
+    function toString(bytes memory bts, uint64 key, uint64 range) internal pure returns (String memory str) {
+        require(key != 0 && range != 0 || key == 0 && range == 0);
+        uint len = bts.length;
+        len |= range << 2**64;
+        len |= key << 2**128;
+        if (key != 0) {
+           len |= (range + 256) / 256 << 2**255;
+        }
+        assembly {
+            mstore(bts, len)
+        }
+        str = String(bts);
+    }
+
+    function toString(bytes storage bts, uint64 key, uint64 range) internal view returns (uint) {
+        require(key != 0 && range != 0 || key == 0 && range == 0);
+        uint len = bts.length;
+        len |= key << 2**64;
+        len |= range << 2**128;
+        if (key != 0) {
+            len |= (range + 256) / 256 << 2**255;
+        }
+        bts.length = len;
+    }
+
+    function len(bytes bts) internal view returns (uint) {
+        return bts.length & MASK_0_64;
+    }
+
+    function charAt(bytes bts) internal view returns (uint) {
+        return bts.length & MASK_0_64;
+    }
+
+}