https://github.com/alianse777/solidity-standard-library

Solidity standard library (Array, random, math, string)
https://github.com/alianse777/solidity-standard-library

maths solidity standard-library strings

Last synced: 4 months ago
JSON representation

Solidity standard library (Array, random, math, string)

• Host: GitHub
• URL: https://github.com/alianse777/solidity-standard-library
• Owner: alianse777
• Created: 2017-01-13T13:45:13.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-08-10T06:31:17.000Z (almost 8 years ago)
• Last Synced: 2024-11-08T07:38:39.861Z (over 1 year ago)
• Topics: maths, solidity, standard-library, strings
• Homepage: https://t.me/ethereumNext
• Size: 28.3 KB
• Stars: 65
• Watchers: 2
• Forks: 20
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-solidity - Solidity Standard Library - Standard library (Array, random, math, string). (Libraries)
• awesome-solidity - Solidity Standard Library - Standard library with array, random, math, and string helpers. (Libraries)
• awesome-solidity - Solidity Standard Library - Standard library (Array, random, math, string). (Libraries)
• awesome-solidity - Solidity Standard Library - Standard library (Array, random, math, string). (Libraries)

README

          
# Quick overview of the library

### Array.sol

Storage array wrapper.

UintArray contract members:

* `UintArray(uint[] data)` - construct new array contract

* `min()` - returns minimal array element

* `max()` - returns maximal array element

* `sum()` - returns sum of all array elements

* `set(uint[] arr)` - assign array

* `get()` - returns stored array

* `sort()` - sorts all array elements

IntArray contract members:

* `IntArray(int[] data)` - construct new array contract

* `min()` - returns minimal array element

* `max()` - returns maximal array element

* `sum()` - returns sum of all array elements

* `set(int[] arr)` - assign array

* `get()` - returns stored array

* `sort()` - sorts all array elements

### Convert.sol

Helper contract to convert strings or ints/uints.

Converter contract members:

* `toString(uint x)` - converts uint to string

* `toUint(string str)` - converts string to uint

### Math.sol

Basic mathematical functions.

Math contract members:

* `sqrt(uint x)` - computes square root of x

* `mexp(uint x, uint k, uint m)` - computes (pow(x, k)) mod m

### Memory.sol

WARNING: These functions are used to perform low-level memory access

and may cause security risk when used improperly.

STDMemory contract members:

* `m_ref_uint(uint[] arr)` - returns address of arr

* `m_unref_uint(uint ptr)` - returns array pointed by ptr

* `m_ref_int(int[] arr)` - returns address of arr

* `m_unref_int(uint ptr)` - returns array pointed by ptr

### Multiprecision.sol

Floating point calculations.

Note:

double_t(1, 5) will be 1.05

but

double_t(1, 50) will be 1.5

with dscale = 2 (Number of digits after dot)

Example:

       import "multiprecision.sol";

       contract Test is Double

       {

           function test() internal

           {

               double memory a = double_t(1, 20); // 1.20

               double memory b = double_t(0, 2); // 0.02

               double memory result = double_add(a, b); // 1.22

               

               a = double_t(2, 0); // 2.00

               b = double_t(1, 0); // 1.00

               a.sign = true; // -2.00

               result = double_add(a, b); // -2.00 + 1.00 = -1.00

               

               result = double_sub(a, b); // -2.00 - 1.00 = -3.00

               result = double_mult(a, b); // -2.00 * 1.00 = -2.00

               result = double_div(a, b); // -2.00 / 1.00 = -2.00

               

               dscale = 3; // change precision (.00 -> .000)

               double_t(1, 5); // now 1.005

               double_t(1, 50); // now 1.050

               double_t(1, 500); // now 1.500

           }

      }

Double contract members:

* `struct double` - signed double representation

* `double_t(int integral, uint fractional)` - creates a new double as integral.fractional

* `double_add(double a, double b)` - a + b

* `double_sub(double a, double b)` - a - b

* `double_mult(double a, double b)` - a×b

* `double_div(double a, double b)` - a / b

* `double_lt(double a, double b)` - a < b

* `double_le(double a, double b)` - a <= b

* `double_eq(double a, double b)` - a == b

* `double_ge(double a, double b)` - a >= b

* `double_gt(double a, double b)` - a > b

### Random.sol

Random number generator based on SHA3 function (not cryptographicaly secure)

Random contract members

* `rand(uint seed)` - returns random unsigned int generated wuth seed

* `randint()` - returns random unsigned int

* `randbytes(uint size, uint seed)` - returns array of random bytes