Compare commits
242 Commits
Author | SHA1 | Date | |
---|---|---|---|
c1864cf473 | |||
8db1851c5c | |||
12de700706 | |||
78a8afdf75 | |||
3c996d7c57 | |||
2a68048fc1 | |||
907f7a4e61 | |||
670328c047 | |||
7fe69ccc5c | |||
26c3532e28 | |||
75ce854192 | |||
9e16d84f9e | |||
7e7bf40f70 | |||
642717883e | |||
85be35c5e0 | |||
664298f038 | |||
c199cdd47c | |||
3a24e9e462 | |||
f334e6a1a0 | |||
72d5760589 | |||
b28dde9d8e | |||
b612e978bf | |||
02d1d8218b | |||
fbf6ec5250 | |||
ac317aa9d6 | |||
10022d158c | |||
a38242d0ac | |||
a84c71f26d | |||
7797f0a1fe | |||
4bbc8b510a | |||
87ea1f98dc | |||
9422888b6c | |||
13407fcf8a | |||
e06cc5a071 | |||
12fb9ff9f6 | |||
392cdcf192 | |||
09b6655b9a | |||
7a2768340e | |||
414d7a11a8 | |||
0d69c7fc79 | |||
b023146cb3 | |||
d1d55be7c2 | |||
7b21238db7 | |||
e316631f6e | |||
fdf902c755 | |||
5d6f8e5299 | |||
87bfd77373 | |||
17005e4ac9 | |||
85ad88bc4d | |||
211f590caa | |||
2f4dd34582 | |||
7e93bcdeeb | |||
e4cd57a615 | |||
74b085b88d | |||
a576c36d02 | |||
1056a2984e | |||
faebf3e4d5 | |||
20e7df386b | |||
15d9cda755 | |||
ee48c25328 | |||
4612d5eb6d | |||
8d3a4860e6 | |||
3df6c83376 | |||
7445d42ad4 | |||
14f91b6942 | |||
be551e9349 | |||
586d12b6c7 | |||
27146f7e0c | |||
9b54017840 | |||
aabb6334be | |||
ce425b9ce5 | |||
3e9ca359da | |||
3705cf387e | |||
edc3296083 | |||
e8143bd0cc | |||
3eb8618c32 | |||
3567a6608e | |||
520bd399a3 | |||
d38e33593e | |||
34b79ad46e | |||
515bf619e8 | |||
617eaab9a2 | |||
d946b598fd | |||
e9d7e9eb73 | |||
4dbfbe9874 | |||
25d59ffdda | |||
2c064eb05b | |||
c9a4a2f651 | |||
0e99effaeb | |||
0f1e53b4b9 | |||
666d59c231 | |||
ce90b4865b | |||
beb5d6963b | |||
a188f8b6e2 | |||
9355c54163 | |||
e8dd6e3217 | |||
94a7fdbb91 | |||
afd3c42c5f | |||
1d91bb4df9 | |||
a5026e48d8 | |||
64f2295d1a | |||
dea0eb9a37 | |||
7c2abadb90 | |||
e6b28468ca | |||
2934bb16d7 | |||
ed92e3993e | |||
1a4d1238a1 | |||
04864559e2 | |||
40e43c1465 | |||
5d145f524c | |||
51ade45108 | |||
3afb40e09e | |||
a9cc135318 | |||
1389b03842 | |||
a37c9b162e | |||
cde492c279 | |||
922c8bf7a3 | |||
a0a28c76f7 | |||
a1f4d2bc1c | |||
e5fb95ceb0 | |||
9ef5986288 | |||
42146c5e8a | |||
e6b91f70cb | |||
657f4a60d5 | |||
839c740cb1 | |||
2bd612fd19 | |||
fc53779d3f | |||
7bdc778390 | |||
97358ebc6c | |||
4834b36271 | |||
53df12897b | |||
4ac890d7d3 | |||
b79657f0d2 | |||
9429e7bb14 | |||
4fd37e84f8 | |||
e46e45ad5a | |||
e79c75df81 | |||
a6dfb3a19e | |||
2af0db04bd | |||
2c9867c577 | |||
47b394d8c3 | |||
ede0107fd7 | |||
7d5dda1cba | |||
e5f83c22fa | |||
a4de1cc754 | |||
8d3cdb8862 | |||
ba1bd35d4a | |||
dfacabd88b | |||
aa306d9050 | |||
10019d7df9 | |||
ae36296ca6 | |||
56406fb593 | |||
ec9b2db4b9 | |||
f5d0c2af8f | |||
c62dc4063e | |||
3789853d98 | |||
f0d016bcde | |||
70e96c62b3 | |||
b723d763c8 | |||
508297f36f | |||
4b0134713c | |||
5b90286b70 | |||
8443f1b385 | |||
c9050c1a8e | |||
bdf87570e2 | |||
faa44b6704 | |||
278e851414 | |||
6f549df243 | |||
4633bcc680 | |||
dc39efd316 | |||
260937e4fb | |||
e17fff2881 | |||
bc32511254 | |||
f30972f948 | |||
ea33ca62c8 | |||
0f365758e1 | |||
2815b53a88 | |||
6c0588164a | |||
8ee1d647ce | |||
25791775e6 | |||
f013e2f1f4 | |||
ac3935d71b | |||
b1c217e272 | |||
d007aaa310 | |||
8aaf9e14be | |||
ae3e6b46f6 | |||
8687df1fbb | |||
ba0aff6737 | |||
a648e2120a | |||
bc61809050 | |||
8c42cbfd63 | |||
58664570f9 | |||
decb82f437 | |||
357c7e279d | |||
32e19c8b58 | |||
f5c6c5b483 | |||
ba2d086fb8 | |||
7a0241b484 | |||
36dad80e18 | |||
29d883150e | |||
e2bed0cfcb | |||
38afeac071 | |||
001c7c3e33 | |||
d4ab339feb | |||
8477312769 | |||
67f90e137d | |||
f264fd5597 | |||
9e75620f1b | |||
45825946c0 | |||
8afb552d59 | |||
e4091669f8 | |||
1cb9349226 | |||
06620dc5df | |||
708d95db49 | |||
85d9361bfb | |||
a6a6f496eb | |||
db12f03264 | |||
231aedb8ad | |||
c3b63ee40d | |||
6f405c5e08 | |||
16cf8478cf | |||
8915a0c7a7 | |||
e5c7edb72c | |||
64e0d666ed | |||
f2aac680c5 | |||
d629525a4b | |||
33d321f0d7 | |||
3d64d59ba9 | |||
4635835a99 | |||
8725ec5f20 | |||
9a4c8cea06 | |||
eb360bda38 | |||
4b1cd2cbfd | |||
cd944a61b7 | |||
47ef787353 | |||
6436ad49df | |||
e1964e47a5 | |||
43319e4e3a | |||
33dbf042c2 | |||
885fca9b5e | |||
074d027629 | |||
f4b90d8b51 |
9
.editorconfig
Normal file
9
.editorconfig
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
root = true
|
||||||
|
|
||||||
|
[*]
|
||||||
|
end_of_line = lf
|
||||||
|
insert_final_newline = true
|
||||||
|
charset = utf-8
|
||||||
|
indent_style = space
|
||||||
|
indent_size = 4
|
||||||
|
trim_trailing_whitespace = true
|
9
.gitignore
vendored
9
.gitignore
vendored
@ -1,11 +1,18 @@
|
|||||||
# Binary
|
# Binary
|
||||||
*.[oa]
|
*.[oa]
|
||||||
|
*.exe
|
||||||
|
|
||||||
# D
|
# D
|
||||||
.dub
|
.dub
|
||||||
__test__*__
|
__test__*__
|
||||||
__test__*__.core
|
__test__*__.core
|
||||||
/tanya-test-library
|
/tanya-test-*
|
||||||
|
/dub_platform_probe-*
|
||||||
|
|
||||||
/docs/
|
/docs/
|
||||||
/docs.json
|
/docs.json
|
||||||
|
|
||||||
|
/*.lst
|
||||||
|
|
||||||
|
# Ninja build
|
||||||
|
.ninja_*
|
||||||
|
23
.travis.yml
23
.travis.yml
@ -7,14 +7,27 @@ os:
|
|||||||
language: d
|
language: d
|
||||||
|
|
||||||
d:
|
d:
|
||||||
- dmd-2.074.0
|
- dmd-2.078.0
|
||||||
- dmd-2.073.2
|
- dmd-2.077.1
|
||||||
- dmd-2.072.2
|
- dmd-2.076.1
|
||||||
- dmd-2.071.2
|
|
||||||
|
|
||||||
env:
|
env:
|
||||||
matrix:
|
matrix:
|
||||||
- ARCH=x86_64
|
- ARCH=x86_64
|
||||||
|
- ARCH=x86
|
||||||
|
|
||||||
|
addons:
|
||||||
|
apt:
|
||||||
|
packages:
|
||||||
|
- gcc-multilib
|
||||||
|
|
||||||
|
before_script:
|
||||||
|
- if [ "$PS1" = '(dmd-2.078.0)' ]; then
|
||||||
|
export UNITTEST="unittest-cov";
|
||||||
|
fi
|
||||||
|
|
||||||
script:
|
script:
|
||||||
- dub test --arch=$ARCH
|
- dub test -b ${UNITTEST:-unittest} --arch=$ARCH --compiler=$DC
|
||||||
|
|
||||||
|
after_success:
|
||||||
|
- test "$UNITTEST" = "unittest-cov" && bash <(curl -s https://codecov.io/bash)
|
||||||
|
5
CODE_OF_CONDUCT.md
Normal file
5
CODE_OF_CONDUCT.md
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# Contributor Code of Conduct
|
||||||
|
|
||||||
|
This project adheres to No Code of Conduct. We are all adults. We accept anyone's contributions. Nothing else matters.
|
||||||
|
|
||||||
|
For more information please visit the [No Code of Conduct](https://github.com/domgetter/NCoC) homepage.
|
107
CONTRIBUTING.md
Normal file
107
CONTRIBUTING.md
Normal file
@ -0,0 +1,107 @@
|
|||||||
|
|
||||||
|
# Contributing
|
||||||
|
|
||||||
|
Tanya is a project in active development, therefore any help is appreciated. Thank you for considering contributing
|
||||||
|
to it, feel welcome.
|
||||||
|
These guidelines describe ways to get started.
|
||||||
|
|
||||||
|
|
||||||
|
## Ways to get involved
|
||||||
|
|
||||||
|
* **Reporting a problem**: [Report](https://github.com/caraus-ecms/tanya/issues) bugs and usage problems you
|
||||||
|
encounter.
|
||||||
|
* **Fixing issues**: [The bug tracker](https://github.com/caraus-ecms/tanya/issues) contains a list of issues you
|
||||||
|
can work on.
|
||||||
|
* **Documentation**: You can improve API documentation by correcting grammar errors, completing existing texts and
|
||||||
|
writing new ones, or providing usage examples.
|
||||||
|
* **Testing**: Test coverage is important for a library. Writing tests is not only helpful, but is also a great way
|
||||||
|
to get a feel for how tanya works.
|
||||||
|
* **Adding new features**: Tanya is a growing library. If you think some feature is missing, you can suggest
|
||||||
|
and implement this.
|
||||||
|
|
||||||
|
|
||||||
|
## Opening an issue
|
||||||
|
|
||||||
|
If you have found a bug, an error, have some question, or suggestion,
|
||||||
|
[Open an issue](https://github.com/caraus-ecms/tanya/issues). I'll try to answer as soon as I can. There is also a
|
||||||
|
list of open issues that mirror the current development process and progress. If you're looking for a challenge, just
|
||||||
|
pick an issue you are interested in and start working on it. Fill free to comment on the issue to get more
|
||||||
|
information.
|
||||||
|
|
||||||
|
You can also look at the [milestones](https://github.com/Dlackware/gnome/milestones) to see what is planned for a
|
||||||
|
specific release.
|
||||||
|
|
||||||
|
|
||||||
|
## Contribution process
|
||||||
|
|
||||||
|
### Creating a pull request
|
||||||
|
|
||||||
|
I accept GitHub pull requests. Creating a pull request is like sending a patch with the suggested change.
|
||||||
|
First you have to [fork](https://guides.github.com/activities/forking/) the repository. Clone your fork locally
|
||||||
|
with `git clone` and create a new branch where you want to work. For example:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
git checkout -b bugfix-x
|
||||||
|
```
|
||||||
|
Commit your changes to your fork:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
git commit -m "Fix X"
|
||||||
|
git push -u origin bugfix-x
|
||||||
|
```
|
||||||
|
|
||||||
|
After that if you visit your fork on GitHub, GitHub will suggest to create pull request. Just follow the steps
|
||||||
|
described on GitHub to finish the process. See
|
||||||
|
[Using Pull Requests](https://help.github.com/articles/about-pull-requests/) for more information.
|
||||||
|
|
||||||
|
Please ensure that your fork is even with the upstream (original) repository. If not, you have to rebase your branch
|
||||||
|
on upstream/master before submitting the pull request. See [Syncing a fork](https://help.github.com/articles/syncing-a-fork/) for a
|
||||||
|
step-by-step guide.
|
||||||
|
|
||||||
|
### Fixing a bug
|
||||||
|
|
||||||
|
Add a unit test that demonstrates the bug along with a short description or link to the original bug.
|
||||||
|
|
||||||
|
### Adding new features
|
||||||
|
|
||||||
|
* Use Ddoc to document the feature.
|
||||||
|
* Add some unit tests to prevent bugs.
|
||||||
|
* [Documented D unit tests](https://dlang.org/spec/ddoc.html#using_ddoc_to_generate_examples) go into the documentation and can be used as an usage
|
||||||
|
example. These tests should be readable and not complicated since they demonstrate how the feature is supposed to work.
|
||||||
|
* More advanced tests should be put into a separate not documented unittest block.
|
||||||
|
|
||||||
|
### Writing unit tests
|
||||||
|
|
||||||
|
```d
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
// A documented unit test has three slashes in front of it.
|
||||||
|
}
|
||||||
|
|
||||||
|
// Issue ##: https://github.com/caraus-ecms/tanya/issues/##.
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
// Not documented unit test may still have a description.
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Style guide
|
||||||
|
|
||||||
|
Make sure your changes follow [The D Style](https://dlang.org/dstyle.html) (including
|
||||||
|
[Additional Requirements for Phobos](https://dlang.org/dstyle.html#phobos)).
|
||||||
|
|
||||||
|
You can also use [dscanner](https://github.com/dlang-community/D-Scanner) to test the new code against the
|
||||||
|
most guidlines. The root of this repository contains
|
||||||
|
[dscanner.ini](https://github.com/caraus-ecms/tanya/blob/master/dscanner.ini), configuration file with settings for an
|
||||||
|
automatic style check. Just go to the top-level directory and issue (this assumes `dscanner` is installed in your
|
||||||
|
system):
|
||||||
|
|
||||||
|
```shell
|
||||||
|
dscanner --styleCheck source
|
||||||
|
```
|
||||||
|
|
||||||
|
## Questions and suggestions
|
||||||
|
|
||||||
|
* [Open an issue](https://github.com/caraus-ecms/tanya/issues)
|
||||||
|
* [Send an email](mailto:info@caraus.de)
|
181
README.md
181
README.md
@ -1,6 +1,8 @@
|
|||||||
# Tanya
|
# Tanya
|
||||||
|
|
||||||
[](https://travis-ci.org/caraus-ecms/tanya)
|
[](https://travis-ci.org/caraus-ecms/tanya)
|
||||||
|
[](https://ci.appveyor.com/project/belka-ew/tanya/branch/master)
|
||||||
|
[](https://codecov.io/gh/caraus-ecms/tanya)
|
||||||
[](https://code.dlang.org/packages/tanya)
|
[](https://code.dlang.org/packages/tanya)
|
||||||
[](https://code.dlang.org/packages/tanya)
|
[](https://code.dlang.org/packages/tanya)
|
||||||
[](https://raw.githubusercontent.com/caraus-ecms/tanya/master/LICENSE)
|
[](https://raw.githubusercontent.com/caraus-ecms/tanya/master/LICENSE)
|
||||||
@ -10,62 +12,171 @@ Tanya is a general purpose library for D programming language.
|
|||||||
Its aim is to simplify the manual memory management in D and to provide a
|
Its aim is to simplify the manual memory management in D and to provide a
|
||||||
guarantee with @nogc attribute that there are no hidden allocations on the
|
guarantee with @nogc attribute that there are no hidden allocations on the
|
||||||
Garbage Collector heap. Everything in the library is usable in @nogc code.
|
Garbage Collector heap. Everything in the library is usable in @nogc code.
|
||||||
Tanya extends Phobos functionality and provides alternative implementations for
|
Tanya provides data structures and utilities to facilitate painless systems
|
||||||
data structures and utilities that depend on the Garbage Collector in Phobos.
|
programming in D.
|
||||||
|
|
||||||
|
* [API Documentation](https://docs.caraus.io/tanya)
|
||||||
|
* [Contribution guidelines](CONTRIBUTING.md)
|
||||||
|
|
||||||
* [Bug tracker](https://issues.caraus.io/projects/tanya)
|
|
||||||
* [Documentation](https://docs.caraus.io/tanya)
|
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
Tanya consists of the following packages:
|
Tanya consists of the following packages and (top-level) modules:
|
||||||
|
|
||||||
|
* `algorithm`: Collection of generic algorithms.
|
||||||
* `async`: Event loop (epoll, kqueue and IOCP).
|
* `async`: Event loop (epoll, kqueue and IOCP).
|
||||||
* `container`: Queue, Vector, Singly linked list, buffers.
|
* `container`: Queue, Array, Singly and doubly linked lists, Buffers, UTF-8
|
||||||
|
string, Hash set.
|
||||||
|
* `conv`: This module provides functions for converting between different
|
||||||
|
types.
|
||||||
|
* `encoding`: This package provides tools to work with text encodings.
|
||||||
|
* `exception`: Common exceptions and errors.
|
||||||
|
* `format`: Formatting and conversion functions.
|
||||||
* `math`: Arbitrary precision integer and a set of functions.
|
* `math`: Arbitrary precision integer and a set of functions.
|
||||||
* `memory`: Tools for manual memory management (allocator, reference counting,
|
* `memory`: Tools for manual memory management (allocators, smart pointers).
|
||||||
helper functions).
|
* `meta`: Template metaprogramming. This package contains utilities to acquire
|
||||||
* `network`: URL-Parsing, sockets.
|
type information at compile-time, to transform from one type to another. It has
|
||||||
|
also different algorithms for iterating, searching and modifying template
|
||||||
|
arguments.
|
||||||
|
* `net`: URL-Parsing, network programming.
|
||||||
|
* `network`: Socket implementation. `network` is currently under rework.
|
||||||
|
After finishing the new socket implementation will land in the `net` package and
|
||||||
|
`network` will be deprecated.
|
||||||
|
* `os`: Platform-independent interfaces to operating system functionality.
|
||||||
|
* `range`: Generic functions and templates for D ranges.
|
||||||
|
* `test`: Test suite for unittest-blocks.
|
||||||
|
* `typecons`: Templates that allow to build new types based on the available
|
||||||
|
ones.
|
||||||
|
|
||||||
|
|
||||||
|
## Basic usage
|
||||||
|
|
||||||
|
### Allocators
|
||||||
|
|
||||||
|
Memory management is done with allocators. Instead of using `new` to create an
|
||||||
|
instance of a class, an allocator is used:
|
||||||
|
|
||||||
|
```d
|
||||||
|
import tanya.memory;
|
||||||
|
|
||||||
|
class A
|
||||||
|
{
|
||||||
|
this(int arg)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
A a = defaultAllocator.make!A(5);
|
||||||
|
|
||||||
|
defaultAllocator.dispose(a);
|
||||||
|
```
|
||||||
|
|
||||||
|
As you can see, the user is responsible for deallocation, therefore `dispose`
|
||||||
|
is called at the end.
|
||||||
|
|
||||||
|
If you want to change the `defaultAllocator` to something different, you
|
||||||
|
probably want to do it at the program's beginning. Or you can invoke another
|
||||||
|
allocator directly. It is important to ensure that the object is destroyed
|
||||||
|
using the same allocator that was used to allocate it.
|
||||||
|
|
||||||
|
What if I get an allocated object from some function? The generic rule is: If
|
||||||
|
you haven't requested the memory yourself (with `make`), you don't need to free
|
||||||
|
it.
|
||||||
|
|
||||||
|
`tanya.memory.smartref` contains smart pointers, helpers that can take care of
|
||||||
|
a proper deallocation in some cases for you.
|
||||||
|
|
||||||
|
### Exceptions
|
||||||
|
|
||||||
|
Since exceptions are normal classes in D, they are allocated and dellocated the
|
||||||
|
same as described above, but:
|
||||||
|
|
||||||
|
1. The caller is **always** responsible for destroying a caught exception.
|
||||||
|
2. Exceptions are **always** allocated and should be always allocated with the
|
||||||
|
`defaultAllocator`.
|
||||||
|
|
||||||
|
```d
|
||||||
|
import tanya.memory;
|
||||||
|
|
||||||
|
void functionThatThrows()
|
||||||
|
{
|
||||||
|
throw defaultAlocator.make!Exception("An error occurred");
|
||||||
|
}
|
||||||
|
|
||||||
|
try
|
||||||
|
{
|
||||||
|
functionThatThrows()
|
||||||
|
}
|
||||||
|
catch (Exception e)
|
||||||
|
{
|
||||||
|
defaultAllocator.dispose(e);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Containers
|
||||||
|
|
||||||
|
Arrays are commonly used in programming. D's built-in arrays often rely on the
|
||||||
|
GC. It is inconvenient to change their size, reserve memory for future use and
|
||||||
|
so on. Containers can help here. The following example demonstrates how
|
||||||
|
`tanya.container.array.Array` can be used instead of `int[]`.
|
||||||
|
|
||||||
|
```d
|
||||||
|
import tanya.container.array;
|
||||||
|
|
||||||
|
Array!int arr;
|
||||||
|
|
||||||
|
// Reserve memory if I know that my container will contain approximately 15
|
||||||
|
// elements.
|
||||||
|
arr.reserve(15);
|
||||||
|
|
||||||
|
arr.insertBack(5); // Add one element.
|
||||||
|
arr.length = 10; // New elements are initialized to 0.
|
||||||
|
|
||||||
|
// Iterate over the first five elements.
|
||||||
|
foreach (el; arr[0 .. 5])
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
int i = arr[7]; // Access 8th element.
|
||||||
|
```
|
||||||
|
|
||||||
|
There are more containers in the `tanya.container` package.
|
||||||
|
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
### Supported compilers
|
### Supported compilers
|
||||||
|
|
||||||
| dmd |
|
| DMD | GCC |
|
||||||
|:-------:|
|
|:-------:|:--------------:|
|
||||||
| 2.074.0 |
|
| 2.078.0 | *gdc-5* branch |
|
||||||
| 2.073.2 |
|
| 2.077.1 | |
|
||||||
| 2.072.2 |
|
| 2.076.1 | |
|
||||||
| 2.071.2 |
|
|
||||||
|
|
||||||
### Current status
|
### Current status
|
||||||
|
|
||||||
The library is currently under development, but the API is becoming gradually
|
Following modules are under development:
|
||||||
stable.
|
|
||||||
|
|
||||||
Following modules are coming soon:
|
| Feature | Branch | Build status |
|
||||||
|
|----------|:---------:|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
| BitArray | bitvector | [](https://travis-ci.org/caraus-ecms/tanya) [](https://ci.appveyor.com/project/belka-ew/tanya/branch/bitvector) |
|
||||||
|
| TLS | crypto | [](https://travis-ci.org/caraus-ecms/tanya) [](https://ci.appveyor.com/project/belka-ew/tanya/branch/crypto) |
|
||||||
|
|
||||||
| Feature | Build status |
|
### Release management
|
||||||
|--------------|:-----------------------------------------------------------------------------------------------------------------------:|
|
|
||||||
| UTF-8 string | [](https://travis-ci.org/caraus-ecms/tanya) |
|
|
||||||
| BitVector | [](https://travis-ci.org/caraus-ecms/tanya) |
|
|
||||||
| Hash table | N/A |
|
|
||||||
|
|
||||||
`math` package contains an arbitrary precision integer implementation that
|
Deprecated features are removed after one release that includes these deprecations.
|
||||||
needs more test cases, better performance and some additional features
|
|
||||||
(constructing from a string and an ubyte array, and converting it back).
|
|
||||||
|
|
||||||
### Further characteristics
|
## Further characteristics
|
||||||
|
|
||||||
* Tanya is a native D library.
|
* Tanya is a native D library without any external dependencies.
|
||||||
|
|
||||||
* Tanya is cross-platform. The development happens on a 64-bit Linux, but it
|
* Tanya is cross-platform. The development happens on a 64-bit Linux, but it
|
||||||
is being tested on Windows and FreeBSD as well.
|
is being tested on Windows and FreeBSD as well.
|
||||||
|
|
||||||
* The library isn't thread-safe. Thread-safity should be added later.
|
* The library isn't thread-safe yet.
|
||||||
|
|
||||||
## Contributing
|
|
||||||
|
|
||||||
Since I'm mostly busy writing new code and implementing new features I would
|
## Feedback
|
||||||
appreciate, if anyone uses the library. It would help me to improve the
|
|
||||||
codebase and fix issues.
|
|
||||||
|
|
||||||
Feel free to contact me if you have any questions.
|
Any feedback about your experience with tanya would be greatly appreciated. Feel free to
|
||||||
|
[contact me](mailto:info@caraus.de).
|
||||||
|
60
appveyor.yml
Normal file
60
appveyor.yml
Normal file
@ -0,0 +1,60 @@
|
|||||||
|
platform: x64
|
||||||
|
os: Visual Studio 2015
|
||||||
|
|
||||||
|
environment:
|
||||||
|
matrix:
|
||||||
|
- DC: dmd
|
||||||
|
DVersion: 2.078.0
|
||||||
|
arch: x64
|
||||||
|
- DC: dmd
|
||||||
|
DVersion: 2.078.0
|
||||||
|
arch: x86
|
||||||
|
- DC: dmd
|
||||||
|
DVersion: 2.077.1
|
||||||
|
arch: x64
|
||||||
|
- DC: dmd
|
||||||
|
DVersion: 2.077.1
|
||||||
|
arch: x86
|
||||||
|
- DC: dmd
|
||||||
|
DVersion: 2.076.1
|
||||||
|
arch: x64
|
||||||
|
- DC: dmd
|
||||||
|
DVersion: 2.076.1
|
||||||
|
arch: x86
|
||||||
|
|
||||||
|
skip_tags: true
|
||||||
|
|
||||||
|
install:
|
||||||
|
- ps: function SetUpDCompiler
|
||||||
|
{
|
||||||
|
$env:toolchain = "msvc";
|
||||||
|
$version = $env:DVersion;
|
||||||
|
Invoke-WebRequest "http://downloads.dlang.org/releases/2.x/$($version)/dmd.$($version).windows.7z" -OutFile "c:\dmd.7z";
|
||||||
|
echo "finished.";
|
||||||
|
pushd c:\\;
|
||||||
|
7z x dmd.7z > $null;
|
||||||
|
popd;
|
||||||
|
}
|
||||||
|
- ps: SetUpDCompiler
|
||||||
|
|
||||||
|
before_build:
|
||||||
|
- ps: if($env:arch -eq "x86"){
|
||||||
|
$env:compilersetupargs = "x86";
|
||||||
|
$env:Darch = "x86";
|
||||||
|
}
|
||||||
|
elseif($env:arch -eq "x64"){
|
||||||
|
$env:compilersetupargs = "amd64";
|
||||||
|
$env:Darch = "x86_64";
|
||||||
|
}
|
||||||
|
- ps: $env:PATH += ";C:\dmd2\windows\bin;";
|
||||||
|
- call "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall" %compilersetupargs%
|
||||||
|
|
||||||
|
build_script:
|
||||||
|
- echo dummy build script - dont remove me
|
||||||
|
|
||||||
|
test_script:
|
||||||
|
- echo %Darch%
|
||||||
|
- echo %PATH%
|
||||||
|
- 'dub --version'
|
||||||
|
- '%DC% --version'
|
||||||
|
- dub test -b unittest --arch=%Darch% --compiler=%DC%
|
14
arch/build.ninja
Normal file
14
arch/build.ninja
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
rule gas
|
||||||
|
command = gcc -c $in -o $out
|
||||||
|
|
||||||
|
rule archive
|
||||||
|
command = ar rcs $out $in
|
||||||
|
|
||||||
|
build abs.o: gas x64/linux/math/abs.S
|
||||||
|
build log.o: gas x64/linux/math/log.S
|
||||||
|
build cmp.o: gas x64/linux/memory/cmp.S
|
||||||
|
build fill.o: gas x64/linux/memory/fill.S
|
||||||
|
build copy.o: gas x64/linux/memory/copy.S
|
||||||
|
build syscall.o: gas x64/linux/syscall.S
|
||||||
|
|
||||||
|
build tanya.a: archive syscall.o copy.o fill.o cmp.o log.o abs.o
|
8
arch/x64/linux/concurrency/thread.S
Normal file
8
arch/x64/linux/concurrency/thread.S
Normal file
@ -0,0 +1,8 @@
|
|||||||
|
.text
|
||||||
|
|
||||||
|
.globl thrd_current
|
||||||
|
.type thrd_current, @function
|
||||||
|
|
||||||
|
thrd_current:
|
||||||
|
mov %fs:0, %rax
|
||||||
|
ret
|
35
arch/x64/linux/math/abs.S
Normal file
35
arch/x64/linux/math/abs.S
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
.text
|
||||||
|
|
||||||
|
|
||||||
|
// fabsf.
|
||||||
|
.globl _D5tanya4math8nbtheory10__T3absTfZ3absFNaNbNiNffZf
|
||||||
|
.type _D5tanya4math8nbtheory10__T3absTfZ3absFNaNbNiNffZf, @function
|
||||||
|
|
||||||
|
_D5tanya4math8nbtheory10__T3absTfZ3absFNaNbNiNffZf:
|
||||||
|
mov $0x7fffffff, %eax
|
||||||
|
movq %rax, %xmm1
|
||||||
|
andpd %xmm1, %xmm0
|
||||||
|
ret
|
||||||
|
|
||||||
|
|
||||||
|
// fabs.
|
||||||
|
.globl _D5tanya4math8nbtheory10__T3absTdZ3absFNaNbNiNfdZd
|
||||||
|
.type _D5tanya4math8nbtheory10__T3absTdZ3absFNaNbNiNfdZd, @function
|
||||||
|
|
||||||
|
_D5tanya4math8nbtheory10__T3absTdZ3absFNaNbNiNfdZd:
|
||||||
|
mov $0x7fffffffffffffff, %rax
|
||||||
|
movq %rax, %xmm1
|
||||||
|
andpd %xmm1, %xmm0
|
||||||
|
ret
|
||||||
|
|
||||||
|
|
||||||
|
// fabsl.
|
||||||
|
.globl _D5tanya4math8nbtheory10__T3absTeZ3absFNaNbNiNfeZe
|
||||||
|
.type _D5tanya4math8nbtheory10__T3absTeZ3absFNaNbNiNfeZe, @function
|
||||||
|
|
||||||
|
// Load the parameter from the stack onto FP stack, execute 'fabs' instruction
|
||||||
|
// The result is returned in ST0.
|
||||||
|
_D5tanya4math8nbtheory10__T3absTeZ3absFNaNbNiNfeZe:
|
||||||
|
fldt 0x8(%rsp)
|
||||||
|
fabs
|
||||||
|
ret
|
48
arch/x64/linux/math/log.S
Normal file
48
arch/x64/linux/math/log.S
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
.text
|
||||||
|
|
||||||
|
|
||||||
|
// logl.
|
||||||
|
.globl _D5tanya4math8nbtheory2lnFNaNbNiNfeZe
|
||||||
|
.type _D5tanya4math8nbtheory2lnFNaNbNiNfeZe, @function
|
||||||
|
|
||||||
|
_D5tanya4math8nbtheory2lnFNaNbNiNfeZe:
|
||||||
|
fldln2 // Put lb(e) onto the FPU stack
|
||||||
|
fldt 8(%rsp) // Put the argument onto the FPU stack
|
||||||
|
fyl2x // %st1 * lb(%st0)
|
||||||
|
ret
|
||||||
|
|
||||||
|
|
||||||
|
// log.
|
||||||
|
.globl _D5tanya4math8nbtheory2lnFNaNbNiNfdZd
|
||||||
|
.type _D5tanya4math8nbtheory2lnFNaNbNiNfdZd, @function
|
||||||
|
|
||||||
|
_D5tanya4math8nbtheory2lnFNaNbNiNfdZd:
|
||||||
|
movsd %xmm0, -8(%rsp) // Put the argument onto the stack
|
||||||
|
|
||||||
|
fldln2 // Put lb(e) onto the FPU stack
|
||||||
|
fldl -8(%rsp) // Put a double onto the FPU stack
|
||||||
|
fyl2x // %st1 * lb(%st0)
|
||||||
|
|
||||||
|
// The result is on the FPU stack, but returned in %xmm0
|
||||||
|
fstpl -8(%rsp)
|
||||||
|
movsd -8(%rsp), %xmm0
|
||||||
|
|
||||||
|
ret
|
||||||
|
|
||||||
|
|
||||||
|
// logf.
|
||||||
|
.globl _D5tanya4math8nbtheory2lnFNaNbNiNffZf
|
||||||
|
.type _D5tanya4math8nbtheory2lnFNaNbNiNffZf, @function
|
||||||
|
|
||||||
|
_D5tanya4math8nbtheory2lnFNaNbNiNffZf:
|
||||||
|
movss %xmm0, -4(%rsp) // Put the argument onto the stack
|
||||||
|
|
||||||
|
fldln2 // Put lb(e) onto the FPU stack
|
||||||
|
flds -4(%rsp) // Put a float onto the FPU stack
|
||||||
|
fyl2x // %st1 * lb(%st0)
|
||||||
|
|
||||||
|
// The result is on the FPU stack, but returned in %xmm0
|
||||||
|
fstps -4(%rsp)
|
||||||
|
movss -4(%rsp), %xmm0
|
||||||
|
|
||||||
|
ret
|
67
arch/x64/linux/memory/cmp.S
Normal file
67
arch/x64/linux/memory/cmp.S
Normal file
@ -0,0 +1,67 @@
|
|||||||
|
.text
|
||||||
|
|
||||||
|
/*
|
||||||
|
* cmpMemory.
|
||||||
|
*
|
||||||
|
* rdi - r1 length
|
||||||
|
* rsi - r1 data.
|
||||||
|
* rdx - r2 length.
|
||||||
|
* rcx - r2 data.
|
||||||
|
*/
|
||||||
|
.globl _D5tanya6memory2op9cmpMemoryFNaNbNixAvxAvZi
|
||||||
|
.type _D5tanya6memory2op9cmpMemoryFNaNbNixAvxAvZi, @function
|
||||||
|
|
||||||
|
_D5tanya6memory2op9cmpMemoryFNaNbNixAvxAvZi:
|
||||||
|
// Compare the lengths
|
||||||
|
cmp %rdx, %rdi
|
||||||
|
jl less
|
||||||
|
jg greater
|
||||||
|
|
||||||
|
mov %rcx, %rdi
|
||||||
|
|
||||||
|
// Check if we're aligned
|
||||||
|
cmp $0x08, %rdx
|
||||||
|
jc aligned_1
|
||||||
|
test $0x07, %edi
|
||||||
|
jz aligned_8
|
||||||
|
|
||||||
|
naligned:
|
||||||
|
cmpsb
|
||||||
|
jl less
|
||||||
|
jg greater
|
||||||
|
|
||||||
|
dec %rdx
|
||||||
|
test $0x07, %edi
|
||||||
|
jnz naligned
|
||||||
|
|
||||||
|
aligned_8:
|
||||||
|
mov %rdx, %rcx
|
||||||
|
shr $0x03, %rcx
|
||||||
|
|
||||||
|
repe cmpsq
|
||||||
|
jl less
|
||||||
|
jg greater
|
||||||
|
|
||||||
|
and $0x07, %edx
|
||||||
|
jz equal
|
||||||
|
|
||||||
|
aligned_1: // Compare the remaining bytes
|
||||||
|
mov %rdx, %rcx
|
||||||
|
|
||||||
|
repe cmpsb
|
||||||
|
jl less
|
||||||
|
jg greater
|
||||||
|
|
||||||
|
equal:
|
||||||
|
xor %rax, %rax // Return 0
|
||||||
|
jmp end
|
||||||
|
|
||||||
|
greater:
|
||||||
|
mov $0x01, %rax
|
||||||
|
jmp end
|
||||||
|
|
||||||
|
less:
|
||||||
|
mov $-0x01, %rax
|
||||||
|
|
||||||
|
end:
|
||||||
|
ret
|
67
arch/x64/linux/memory/copy.S
Normal file
67
arch/x64/linux/memory/copy.S
Normal file
@ -0,0 +1,67 @@
|
|||||||
|
.text
|
||||||
|
|
||||||
|
/*
|
||||||
|
* copyMemory.
|
||||||
|
*
|
||||||
|
* rdi - source length
|
||||||
|
* rsi - source data.
|
||||||
|
* rdx - target length.
|
||||||
|
* rcx - target data.
|
||||||
|
*/
|
||||||
|
.globl _D5tanya6memory2op10copyMemoryFNaNbNixAvAvZv
|
||||||
|
.type _D5tanya6memory2op10copyMemoryFNaNbNixAvAvZv, @function
|
||||||
|
|
||||||
|
_D5tanya6memory2op10copyMemoryFNaNbNixAvAvZv:
|
||||||
|
mov %rdi, %rdx
|
||||||
|
mov %rcx, %rdi
|
||||||
|
|
||||||
|
cmp $0x08, %rdx
|
||||||
|
jc aligned_1
|
||||||
|
test $0x07, %edi
|
||||||
|
jz aligned_8
|
||||||
|
|
||||||
|
naligned:
|
||||||
|
movsb
|
||||||
|
dec %rdx
|
||||||
|
test $0x07, %edi
|
||||||
|
jnz naligned
|
||||||
|
|
||||||
|
aligned_8:
|
||||||
|
mov %rdx, %rcx
|
||||||
|
shr $0x03, %rcx
|
||||||
|
rep movsq
|
||||||
|
and $0x07, %edx
|
||||||
|
jz end
|
||||||
|
|
||||||
|
aligned_1:
|
||||||
|
// Write the remaining bytes
|
||||||
|
mov %rdx, %rcx
|
||||||
|
rep movsb
|
||||||
|
|
||||||
|
end:
|
||||||
|
ret
|
||||||
|
|
||||||
|
/*
|
||||||
|
* moveMemory.
|
||||||
|
*
|
||||||
|
* rdi - source length
|
||||||
|
* rsi - source data.
|
||||||
|
* rdx - target length.
|
||||||
|
* rcx - target data.
|
||||||
|
*/
|
||||||
|
.globl _D5tanya6memory2op10moveMemoryFNaNbNixAvAvZv
|
||||||
|
.type _D5tanya6memory2op10moveMemoryFNaNbNixAvAvZv, @function
|
||||||
|
|
||||||
|
_D5tanya6memory2op10moveMemoryFNaNbNixAvAvZv:
|
||||||
|
mov %rdi, %rdx
|
||||||
|
|
||||||
|
lea -1(%rdx, %rsi), %rsi
|
||||||
|
lea -1(%rdx, %rcx), %rdi
|
||||||
|
mov %rdx, %rcx
|
||||||
|
|
||||||
|
std // Set the direction flag
|
||||||
|
|
||||||
|
rep movsb
|
||||||
|
|
||||||
|
cld // Clear the direction flag
|
||||||
|
ret
|
155
arch/x64/linux/memory/fill.S
Normal file
155
arch/x64/linux/memory/fill.S
Normal file
@ -0,0 +1,155 @@
|
|||||||
|
.text
|
||||||
|
|
||||||
|
/*
|
||||||
|
* fillMemory.
|
||||||
|
*
|
||||||
|
* rdi - length.
|
||||||
|
* rsi - pointer.
|
||||||
|
* rdx - value filled with a byte.
|
||||||
|
*/
|
||||||
|
.globl _D5tanya6memory2op10fillMemoryFNaNbNiAvmZv
|
||||||
|
.type _D5tanya6memory2op10fillMemoryFNaNbNiAvmZv, @function
|
||||||
|
|
||||||
|
_D5tanya6memory2op10fillMemoryFNaNbNiAvmZv:
|
||||||
|
// Check for zero length
|
||||||
|
test %rdi, %rdi
|
||||||
|
jz end
|
||||||
|
|
||||||
|
mov %rdi, %rax
|
||||||
|
mov %rsi, %r8
|
||||||
|
|
||||||
|
movq %rdx, %xmm0
|
||||||
|
movlhps %xmm0, %xmm0
|
||||||
|
|
||||||
|
// Check if the pointer is aligned to a 16-byte boundary
|
||||||
|
and $-0x10, %r8
|
||||||
|
|
||||||
|
// Compute the number of misaligned bytes
|
||||||
|
mov %rsi, %r9
|
||||||
|
sub %r8, %r9
|
||||||
|
|
||||||
|
test %r9, %r9
|
||||||
|
jz aligned
|
||||||
|
|
||||||
|
// Get the number of bytes to be written until we are aligned
|
||||||
|
mov $0x10, %rcx
|
||||||
|
sub %r9, %rcx
|
||||||
|
|
||||||
|
mov %rsi, %r8
|
||||||
|
|
||||||
|
naligned:
|
||||||
|
mov %dl, (%r8) // Write a byte
|
||||||
|
|
||||||
|
// Advance the pointer. Decrease the total number of bytes
|
||||||
|
// and the misaligned ones
|
||||||
|
inc %r8
|
||||||
|
dec %rcx
|
||||||
|
dec %rax
|
||||||
|
|
||||||
|
// Checks if we are aligned
|
||||||
|
test %rcx, %rcx
|
||||||
|
jnz naligned
|
||||||
|
|
||||||
|
aligned:
|
||||||
|
// Checks if we're done writing bytes
|
||||||
|
test %rax, %rax
|
||||||
|
jz end
|
||||||
|
|
||||||
|
// Write 1 byte at a time
|
||||||
|
cmp $8, %rax
|
||||||
|
jl aligned_1
|
||||||
|
|
||||||
|
// Write 8 bytes at a time
|
||||||
|
cmp $16, %rax
|
||||||
|
jl aligned_8
|
||||||
|
|
||||||
|
// Write 16 bytes at a time
|
||||||
|
cmp $32, %rax
|
||||||
|
jl aligned_16
|
||||||
|
|
||||||
|
// Write 32 bytes at a time
|
||||||
|
cmp $64, %rax
|
||||||
|
jl aligned_32
|
||||||
|
|
||||||
|
aligned_64:
|
||||||
|
movdqa %xmm0, (%r8)
|
||||||
|
movdqa %xmm0, 16(%r8)
|
||||||
|
movdqa %xmm0, 32(%r8)
|
||||||
|
movdqa %xmm0, 48(%r8)
|
||||||
|
|
||||||
|
add $64, %r8
|
||||||
|
sub $64, %rax
|
||||||
|
|
||||||
|
cmp $64, %rax
|
||||||
|
jge aligned_64
|
||||||
|
|
||||||
|
// Checks if we're done writing bytes
|
||||||
|
test %rax, %rax
|
||||||
|
jz end
|
||||||
|
|
||||||
|
// Write 1 byte at a time
|
||||||
|
cmp $8, %rax
|
||||||
|
jl aligned_1
|
||||||
|
|
||||||
|
// Write 8 bytes at a time
|
||||||
|
cmp $16, %rax
|
||||||
|
jl aligned_8
|
||||||
|
|
||||||
|
// Write 16 bytes at a time
|
||||||
|
cmp $32, %rax
|
||||||
|
jl aligned_16
|
||||||
|
|
||||||
|
aligned_32:
|
||||||
|
movdqa %xmm0, (%r8)
|
||||||
|
movdqa %xmm0, 16(%r8)
|
||||||
|
|
||||||
|
add $32, %r8
|
||||||
|
sub $32, %rax
|
||||||
|
|
||||||
|
// Checks if we're done writing bytes
|
||||||
|
test %rax, %rax
|
||||||
|
jz end
|
||||||
|
|
||||||
|
// Write 1 byte at a time
|
||||||
|
cmp $8, %rax
|
||||||
|
jl aligned_1
|
||||||
|
|
||||||
|
// Write 8 bytes at a time
|
||||||
|
cmp $16, %rax
|
||||||
|
jl aligned_8
|
||||||
|
|
||||||
|
aligned_16:
|
||||||
|
movdqa %xmm0, (%r8)
|
||||||
|
|
||||||
|
add $16, %r8
|
||||||
|
sub $16, %rax
|
||||||
|
|
||||||
|
// Checks if we're done writing bytes
|
||||||
|
test %rax, %rax
|
||||||
|
jz end
|
||||||
|
|
||||||
|
// Write 1 byte at a time
|
||||||
|
cmp $8, %rax
|
||||||
|
jl aligned_1
|
||||||
|
|
||||||
|
aligned_8:
|
||||||
|
mov %rdx, (%r8)
|
||||||
|
|
||||||
|
add $8, %r8
|
||||||
|
sub $8, %rax
|
||||||
|
|
||||||
|
// Checks if we're done writing bytes
|
||||||
|
test %rax, %rax
|
||||||
|
jz end
|
||||||
|
|
||||||
|
aligned_1:
|
||||||
|
mov %dl, (%r8)
|
||||||
|
|
||||||
|
inc %r8
|
||||||
|
dec %rax
|
||||||
|
|
||||||
|
test %rax, %rax
|
||||||
|
jnz aligned_1
|
||||||
|
|
||||||
|
end:
|
||||||
|
ret
|
65
arch/x64/linux/syscall.S
Normal file
65
arch/x64/linux/syscall.S
Normal file
@ -0,0 +1,65 @@
|
|||||||
|
/*
|
||||||
|
The kernel uses the following registers:
|
||||||
|
%rdi, %rsi, %rdx, %r8, %r9, %r10
|
||||||
|
|
||||||
|
The number of the syscall is passed in %rax.
|
||||||
|
|
||||||
|
A syscall clobbers:
|
||||||
|
%rax, %rcx, %r11
|
||||||
|
|
||||||
|
The returned value is placed in %rax.
|
||||||
|
*/
|
||||||
|
.text
|
||||||
|
|
||||||
|
.globl syscall1
|
||||||
|
.type syscall1, @function
|
||||||
|
|
||||||
|
syscall1:
|
||||||
|
movq %rsi, %rax // Syscall number.
|
||||||
|
|
||||||
|
syscall
|
||||||
|
|
||||||
|
ret
|
||||||
|
|
||||||
|
|
||||||
|
.globl syscall2
|
||||||
|
.type syscall2, @function
|
||||||
|
|
||||||
|
syscall2:
|
||||||
|
// Store registers.
|
||||||
|
movq %rdi, %r8
|
||||||
|
|
||||||
|
movq %rdx, %rax // Syscall number.
|
||||||
|
|
||||||
|
// Syscall arguments.
|
||||||
|
movq %rsi, %rdi
|
||||||
|
movq %r8, %rsi
|
||||||
|
|
||||||
|
syscall
|
||||||
|
|
||||||
|
// Restore registers.
|
||||||
|
movq %rdi, %rsi
|
||||||
|
movq %r8, %rdi
|
||||||
|
|
||||||
|
ret
|
||||||
|
|
||||||
|
|
||||||
|
.globl syscall3
|
||||||
|
.type syscall3, @function
|
||||||
|
|
||||||
|
syscall3:
|
||||||
|
// Store registers.
|
||||||
|
movq %rdi, %r8
|
||||||
|
|
||||||
|
movq %rcx, %rax // Syscall number.
|
||||||
|
|
||||||
|
// Syscall arguments.
|
||||||
|
movq %rdx, %rdi
|
||||||
|
movq %r8, %rdx
|
||||||
|
|
||||||
|
syscall
|
||||||
|
|
||||||
|
// Restore registers.
|
||||||
|
movq %r8, %rdi
|
||||||
|
|
||||||
|
ret
|
3
codecov.yml
Normal file
3
codecov.yml
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
ignore:
|
||||||
|
- "source/tanya/async/event/iocp.d"
|
||||||
|
- "source/tanya/async/iocp.d"
|
81
dscanner.ini
Normal file
81
dscanner.ini
Normal file
@ -0,0 +1,81 @@
|
|||||||
|
; Configure which static analysis checks are skip-unittest
|
||||||
|
[analysis.config.StaticAnalysisConfig]
|
||||||
|
; Check variable, class, struct, interface, union, and function names against t
|
||||||
|
; he Phobos style guide
|
||||||
|
style_check="disabled"
|
||||||
|
; Check for array literals that cause unnecessary allocation
|
||||||
|
enum_array_literal_check="skip-unittest"
|
||||||
|
; Check for poor exception handling practices
|
||||||
|
exception_check="skip-unittest"
|
||||||
|
; Check for use of the deprecated 'delete' keyword
|
||||||
|
delete_check="skip-unittest"
|
||||||
|
; Check for use of the deprecated floating point operators
|
||||||
|
float_operator_check="skip-unittest"
|
||||||
|
; Check number literals for readability
|
||||||
|
number_style_check="disabled"
|
||||||
|
; Checks that opEquals, opCmp, toHash, and toString are either const, immutable
|
||||||
|
; , or inout.
|
||||||
|
object_const_check="disabled"
|
||||||
|
; Checks for .. expressions where the left side is larger than the right.
|
||||||
|
backwards_range_check="skip-unittest"
|
||||||
|
; Checks for if statements whose 'then' block is the same as the 'else' block
|
||||||
|
if_else_same_check="skip-unittest"
|
||||||
|
; Checks for some problems with constructors
|
||||||
|
constructor_check="skip-unittest"
|
||||||
|
; Checks for unused variables and function parameters
|
||||||
|
unused_variable_check="disabled"
|
||||||
|
; Checks for unused labels
|
||||||
|
unused_label_check="skip-unittest"
|
||||||
|
; Checks for duplicate attributes
|
||||||
|
duplicate_attribute="skip-unittest"
|
||||||
|
; Checks that opEquals and toHash are both defined or neither are defined
|
||||||
|
opequals_tohash_check="disabled"
|
||||||
|
; Checks for subtraction from .length properties
|
||||||
|
length_subtraction_check="disabled"
|
||||||
|
; Checks for methods or properties whose names conflict with built-in propertie
|
||||||
|
; s
|
||||||
|
builtin_property_names_check="skip-unittest"
|
||||||
|
; Checks for confusing code in inline asm statements
|
||||||
|
asm_style_check="skip-unittest"
|
||||||
|
; Checks for confusing logical operator precedence
|
||||||
|
logical_precedence_check="skip-unittest"
|
||||||
|
; Checks for undocumented public declarations
|
||||||
|
undocumented_declaration_check="disabled"
|
||||||
|
; Checks for poor placement of function attributes
|
||||||
|
function_attribute_check="skip-unittest"
|
||||||
|
; Checks for use of the comma operator
|
||||||
|
comma_expression_check="skip-unittest"
|
||||||
|
; Checks for local imports that are too broad
|
||||||
|
local_import_check="disabled"
|
||||||
|
; Checks for variables that could be declared immutable
|
||||||
|
could_be_immutable_check="disabled"
|
||||||
|
; Checks for redundant expressions in if statements
|
||||||
|
redundant_if_check="skip-unittest"
|
||||||
|
; Checks for redundant parenthesis
|
||||||
|
redundant_parens_check="skip-unittest"
|
||||||
|
; Checks for mismatched argument and parameter names
|
||||||
|
mismatched_args_check="skip-unittest"
|
||||||
|
; Checks for labels with the same name as variables
|
||||||
|
label_var_same_name_check="disabled"
|
||||||
|
; Checks for lines longer than 120 characters
|
||||||
|
long_line_check="skip-unittest"
|
||||||
|
; Checks for assignment to auto-ref function parameters
|
||||||
|
auto_ref_assignment_check="disabled"
|
||||||
|
; Checks for incorrect infinite range definitions
|
||||||
|
incorrect_infinite_range_check="skip-unittest"
|
||||||
|
; Checks for asserts that are always true
|
||||||
|
useless_assert_check="skip-unittest"
|
||||||
|
; Check for uses of the old-style alias syntax
|
||||||
|
alias_syntax_check="disabled"
|
||||||
|
; Checks for else if that should be else static if
|
||||||
|
static_if_else_check="skip-unittest"
|
||||||
|
; Check for unclear lambda syntax
|
||||||
|
lambda_return_check="skip-unittest"
|
||||||
|
; Check for auto function without return statement
|
||||||
|
auto_function_check="skip-unittest"
|
||||||
|
; Check for sortedness of imports
|
||||||
|
imports_sortedness="skip-unittest"
|
||||||
|
; Check for explicitly annotated unittests
|
||||||
|
explicitly_annotated_unittests="disabled"
|
||||||
|
; Check for useless usage of the final attribute
|
||||||
|
final_attribute_check="skip-unittest"
|
19
dub.json
19
dub.json
@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "tanya",
|
"name": "tanya",
|
||||||
"description": "General purpose, @nogc library",
|
"description": "General purpose, @nogc library. Containers, networking, metaprogramming, memory management, utilities",
|
||||||
"license": "MPL-2.0",
|
"license": "MPL-2.0",
|
||||||
"copyright": "(c) Eugene Wissner <info@caraus.de>",
|
"copyright": "(c) Eugene Wissner <info@caraus.de>",
|
||||||
"authors": [
|
"authors": [
|
||||||
@ -11,7 +11,22 @@
|
|||||||
|
|
||||||
"configurations": [
|
"configurations": [
|
||||||
{
|
{
|
||||||
"name": "library"
|
"name": "library",
|
||||||
|
"targetType": "staticLibrary",
|
||||||
|
"versions": ["TanyaPhobos"]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "dynamic",
|
||||||
|
"targetType": "dynamicLibrary",
|
||||||
|
"versions": ["TanyaPhobos"]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "native",
|
||||||
|
"targetType": "library",
|
||||||
|
"platforms": ["linux-x86_64-gdc"],
|
||||||
|
"preBuildCommands": ["ninja -C arch"],
|
||||||
|
"lflags": ["arch/tanya.a"],
|
||||||
|
"versions": ["TanyaNative"]
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
275
source/tanya/algorithm/mutation.d
Normal file
275
source/tanya/algorithm/mutation.d
Normal file
@ -0,0 +1,275 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Algorithms that modify its arguments.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/algorithm/mutation.d,
|
||||||
|
* tanya/algorithm/mutation.d)
|
||||||
|
*/
|
||||||
|
module tanya.algorithm.mutation;
|
||||||
|
|
||||||
|
import tanya.memory.op;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
|
private void deinitialize(bool zero, T)(ref T value)
|
||||||
|
{
|
||||||
|
static if (is(T == U[S], U, size_t S))
|
||||||
|
{
|
||||||
|
foreach (ref e; value)
|
||||||
|
{
|
||||||
|
deinitialize!zero(e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static if (isNested!T)
|
||||||
|
{
|
||||||
|
// Don't override the context pointer.
|
||||||
|
enum size_t size = T.sizeof - (void*).sizeof;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
enum size_t size = T.sizeof;
|
||||||
|
}
|
||||||
|
static if (zero)
|
||||||
|
{
|
||||||
|
fill!0((cast(void*) &value)[0 .. size]);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
copy(typeid(T).initializer()[0 .. size], (&value)[0 .. 1]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Moves $(D_PARAM source) into $(D_PARAM target) assuming that
|
||||||
|
* $(D_PARAM target) isn't initialized.
|
||||||
|
*
|
||||||
|
* Moving the $(D_PARAM source) copies it into the $(D_PARAM target) and places
|
||||||
|
* the $(D_PARAM source) into a valid but unspecified state, which means that
|
||||||
|
* after moving $(D_PARAM source) can be destroyed or assigned a new value, but
|
||||||
|
* accessing it yields an unspecified value. No postblits or destructors are
|
||||||
|
* called. If the $(D_PARAM target) should be destroyed before, use
|
||||||
|
* $(D_PSYMBOL move).
|
||||||
|
*
|
||||||
|
* $(D_PARAM source) and $(D_PARAM target) must be different objects.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Object type.
|
||||||
|
* source = Source object.
|
||||||
|
* target = Target object.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL move),
|
||||||
|
* $(D_PSYMBOL hasElaborateCopyConstructor),
|
||||||
|
* $(D_PSYMBOL hasElaborateDestructor).
|
||||||
|
*
|
||||||
|
* Precondition: `&source !is &target`.
|
||||||
|
*/
|
||||||
|
void moveEmplace(T)(ref T source, ref T target) @system
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(&source !is &target, "Source and target must be different");
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
static if (is(T == struct) || isStaticArray!T)
|
||||||
|
{
|
||||||
|
copy((&source)[0 .. 1], (&target)[0 .. 1]);
|
||||||
|
|
||||||
|
static if (hasElaborateCopyConstructor!T || hasElaborateDestructor!T)
|
||||||
|
{
|
||||||
|
if (typeid(T).initializer().ptr is null)
|
||||||
|
{
|
||||||
|
deinitialize!true(source);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
deinitialize!false(source);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
target = source;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
static struct S
|
||||||
|
{
|
||||||
|
int member = 5;
|
||||||
|
|
||||||
|
this(this) @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
assert(false);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
S source, target = void;
|
||||||
|
moveEmplace(source, target);
|
||||||
|
assert(target.member == 5);
|
||||||
|
|
||||||
|
int x1 = 5, x2;
|
||||||
|
moveEmplace(x1, x2);
|
||||||
|
assert(x2 == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Is pure.
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
struct S
|
||||||
|
{
|
||||||
|
this(this)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
}
|
||||||
|
S source, target = void;
|
||||||
|
static assert(is(typeof({ moveEmplace(source, target); })));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Moves nested.
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
struct Nested
|
||||||
|
{
|
||||||
|
void method() @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Nested source, target = void;
|
||||||
|
moveEmplace(source, target);
|
||||||
|
assert(source == target);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Emplaces static arrays.
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
static struct S
|
||||||
|
{
|
||||||
|
size_t member;
|
||||||
|
this(size_t i) @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
this.member = i;
|
||||||
|
}
|
||||||
|
~this() @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
}
|
||||||
|
}
|
||||||
|
S[2] source = [ S(5), S(5) ], target = void;
|
||||||
|
moveEmplace(source, target);
|
||||||
|
assert(source[0].member == 0);
|
||||||
|
assert(target[0].member == 5);
|
||||||
|
assert(source[1].member == 0);
|
||||||
|
assert(target[1].member == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Moves $(D_PARAM source) into $(D_PARAM target) assuming that
|
||||||
|
* $(D_PARAM target) isn't initialized.
|
||||||
|
*
|
||||||
|
* Moving the $(D_PARAM source) copies it into the $(D_PARAM target) and places
|
||||||
|
* the $(D_PARAM source) into a valid but unspecified state, which means that
|
||||||
|
* after moving $(D_PARAM source) can be destroyed or assigned a new value, but
|
||||||
|
* accessing it yields an unspecified value. $(D_PARAM target) is destroyed before
|
||||||
|
* the new value is assigned. If $(D_PARAM target) isn't initialized and
|
||||||
|
* therefore shouldn't be destroyed, $(D_PSYMBOL moveEmplace) can be used.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM target) isn't specified, $(D_PSYMBOL move) returns the source
|
||||||
|
* as rvalue without calling its copy constructor or destructor.
|
||||||
|
*
|
||||||
|
* $(D_PARAM source) and $(D_PARAM target) are the same object,
|
||||||
|
* $(D_PSYMBOL move) does nothing.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Object type.
|
||||||
|
* source = Source object.
|
||||||
|
* target = Target object.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL moveEmplace).
|
||||||
|
*/
|
||||||
|
void move(T)(ref T source, ref T target)
|
||||||
|
{
|
||||||
|
if ((() @trusted => &source is &target)())
|
||||||
|
{
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
static if (hasElaborateDestructor!T)
|
||||||
|
{
|
||||||
|
target.__xdtor();
|
||||||
|
}
|
||||||
|
(() @trusted => moveEmplace(source, target))();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T move(T)(ref T source) @trusted
|
||||||
|
{
|
||||||
|
T target = void;
|
||||||
|
moveEmplace(source, target);
|
||||||
|
return target;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static struct S
|
||||||
|
{
|
||||||
|
int member = 5;
|
||||||
|
|
||||||
|
this(this) @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
assert(false);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
S source, target = void;
|
||||||
|
move(source, target);
|
||||||
|
assert(target.member == 5);
|
||||||
|
assert(move(target).member == 5);
|
||||||
|
|
||||||
|
int x1 = 5, x2;
|
||||||
|
move(x1, x2);
|
||||||
|
assert(x2 == 5);
|
||||||
|
assert(move(x2) == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Moves if source is target.
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
int x = 5;
|
||||||
|
move(x, x);
|
||||||
|
assert(x == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Exchanges the values of $(D_PARAM a) and $(D_PARAM b).
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL swap) moves the contents of $(D_PARAM a) and $(D_PARAM b)
|
||||||
|
* without calling its postblits or destructors.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* a = The first object.
|
||||||
|
* a = The second object.
|
||||||
|
*/
|
||||||
|
void swap(T)(ref T a, ref T b) @trusted
|
||||||
|
{
|
||||||
|
T tmp = void;
|
||||||
|
moveEmplace(a, tmp);
|
||||||
|
moveEmplace(b, a);
|
||||||
|
moveEmplace(tmp, b);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
int a = 3, b = 5;
|
||||||
|
swap(a, b);
|
||||||
|
assert(a == 5);
|
||||||
|
assert(b == 3);
|
||||||
|
}
|
17
source/tanya/algorithm/package.d
Normal file
17
source/tanya/algorithm/package.d
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Collection of generic algorithms.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/algorithm/package.d,
|
||||||
|
* tanya/algorithm/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.algorithm;
|
||||||
|
|
||||||
|
public import tanya.algorithm.mutation;
|
@ -3,29 +3,36 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Event loop implementation for Linux.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/event/epoll.d,
|
||||||
|
* tanya/async/event/epoll.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.event.epoll;
|
module tanya.async.event.epoll;
|
||||||
|
|
||||||
version (linux):
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
else version (linux):
|
||||||
|
|
||||||
public import core.sys.linux.epoll;
|
|
||||||
import tanya.async.protocol;
|
|
||||||
import tanya.async.event.selector;
|
|
||||||
import tanya.async.loop;
|
|
||||||
import tanya.async.transport;
|
|
||||||
import tanya.async.watcher;
|
|
||||||
import tanya.container.vector;
|
|
||||||
import tanya.memory;
|
|
||||||
import tanya.memory.mmappool;
|
|
||||||
import tanya.network.socket;
|
|
||||||
import core.stdc.errno;
|
import core.stdc.errno;
|
||||||
|
public import core.sys.linux.epoll;
|
||||||
import core.sys.posix.unistd;
|
import core.sys.posix.unistd;
|
||||||
import core.time;
|
import core.time;
|
||||||
import std.algorithm.comparison;
|
import std.algorithm.comparison;
|
||||||
|
import tanya.async.event.selector;
|
||||||
|
import tanya.async.loop;
|
||||||
|
import tanya.async.protocol;
|
||||||
|
import tanya.async.transport;
|
||||||
|
import tanya.async.watcher;
|
||||||
|
import tanya.container.array;
|
||||||
|
import tanya.memory;
|
||||||
|
import tanya.memory.mmappool;
|
||||||
|
import tanya.network.socket;
|
||||||
|
|
||||||
extern (C) nothrow @nogc
|
extern (C) nothrow @nogc
|
||||||
{
|
{
|
||||||
@ -37,7 +44,7 @@ extern (C) nothrow @nogc
|
|||||||
final class EpollLoop : SelectorLoop
|
final class EpollLoop : SelectorLoop
|
||||||
{
|
{
|
||||||
protected int fd;
|
protected int fd;
|
||||||
private Vector!epoll_event events;
|
private Array!epoll_event events;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Initializes the loop.
|
* Initializes the loop.
|
||||||
@ -49,7 +56,7 @@ final class EpollLoop : SelectorLoop
|
|||||||
throw defaultAllocator.make!BadLoopException("epoll initialization failed");
|
throw defaultAllocator.make!BadLoopException("epoll initialization failed");
|
||||||
}
|
}
|
||||||
super();
|
super();
|
||||||
events = Vector!epoll_event(maxEvents, MmapPool.instance);
|
events = Array!epoll_event(maxEvents, MmapPool.instance);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -3,28 +3,33 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Event loop implementation for Windows.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/event/iocp.d,
|
||||||
|
* tanya/async/event/iocp.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.event.iocp;
|
module tanya.async.event.iocp;
|
||||||
|
|
||||||
version (Windows):
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
else version (Windows):
|
||||||
|
|
||||||
import tanya.container.buffer;
|
import core.sys.windows.mswsock;
|
||||||
|
import core.sys.windows.winsock2;
|
||||||
import tanya.async.loop;
|
import tanya.async.loop;
|
||||||
import tanya.async.protocol;
|
import tanya.async.protocol;
|
||||||
import tanya.async.transport;
|
import tanya.async.transport;
|
||||||
import tanya.async.watcher;
|
import tanya.async.watcher;
|
||||||
|
import tanya.container.buffer;
|
||||||
import tanya.memory;
|
import tanya.memory;
|
||||||
import tanya.memory.mmappool;
|
import tanya.memory.mmappool;
|
||||||
import tanya.network.socket;
|
import tanya.network.socket;
|
||||||
import core.sys.windows.basetyps;
|
import tanya.sys.windows.winbase;
|
||||||
import core.sys.windows.mswsock;
|
|
||||||
import core.sys.windows.winbase;
|
|
||||||
import core.sys.windows.windef;
|
|
||||||
import core.sys.windows.winsock2;
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Transport for stream sockets.
|
* Transport for stream sockets.
|
||||||
@ -178,7 +183,7 @@ final class IOCPLoop : Loop
|
|||||||
{
|
{
|
||||||
super();
|
super();
|
||||||
|
|
||||||
completionPort = CreateIoCompletionPort(INVALID_HANDLE_VALUE, NULL, 0, 0);
|
completionPort = CreateIoCompletionPort(INVALID_HANDLE_VALUE, null, 0, 0);
|
||||||
if (!completionPort)
|
if (!completionPort)
|
||||||
{
|
{
|
||||||
throw make!BadLoopException(defaultAllocator,
|
throw make!BadLoopException(defaultAllocator,
|
||||||
@ -208,7 +213,7 @@ final class IOCPLoop : Loop
|
|||||||
|
|
||||||
if (CreateIoCompletionPort(cast(HANDLE) socket.handle,
|
if (CreateIoCompletionPort(cast(HANDLE) socket.handle,
|
||||||
completionPort,
|
completionPort,
|
||||||
cast(ULONG_PTR) (cast(void*) watcher),
|
cast(size_t) (cast(void*) watcher),
|
||||||
0) !is completionPort)
|
0) !is completionPort)
|
||||||
{
|
{
|
||||||
return false;
|
return false;
|
||||||
@ -226,15 +231,15 @@ final class IOCPLoop : Loop
|
|||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (!(oldEvents & Event.read) && (events & Event.read)
|
if ((!(oldEvents & Event.read) && (events & Event.read))
|
||||||
|| !(oldEvents & Event.write) && (events & Event.write))
|
|| (!(oldEvents & Event.write) && (events & Event.write)))
|
||||||
{
|
{
|
||||||
auto transport = cast(StreamTransport) watcher;
|
auto transport = cast(StreamTransport) watcher;
|
||||||
assert(transport !is null);
|
assert(transport !is null);
|
||||||
|
|
||||||
if (CreateIoCompletionPort(cast(HANDLE) transport.socket.handle,
|
if (CreateIoCompletionPort(cast(HANDLE) transport.socket.handle,
|
||||||
completionPort,
|
completionPort,
|
||||||
cast(ULONG_PTR) (cast(void*) watcher),
|
cast(size_t) (cast(void*) watcher),
|
||||||
0) !is completionPort)
|
0) !is completionPort)
|
||||||
{
|
{
|
||||||
return false;
|
return false;
|
||||||
@ -279,8 +284,8 @@ final class IOCPLoop : Loop
|
|||||||
override protected void poll() @nogc
|
override protected void poll() @nogc
|
||||||
{
|
{
|
||||||
DWORD lpNumberOfBytes;
|
DWORD lpNumberOfBytes;
|
||||||
ULONG_PTR key;
|
size_t key;
|
||||||
LPOVERLAPPED overlap;
|
OVERLAPPED* overlap;
|
||||||
immutable timeout = cast(immutable int) blockTime.total!"msecs";
|
immutable timeout = cast(immutable int) blockTime.total!"msecs";
|
||||||
|
|
||||||
auto result = GetQueuedCompletionStatus(completionPort,
|
auto result = GetQueuedCompletionStatus(completionPort,
|
||||||
@ -288,7 +293,7 @@ final class IOCPLoop : Loop
|
|||||||
&key,
|
&key,
|
||||||
&overlap,
|
&overlap,
|
||||||
timeout);
|
timeout);
|
||||||
if (result == FALSE && overlap == NULL)
|
if (result == FALSE && overlap is null)
|
||||||
{
|
{
|
||||||
return; // Timeout
|
return; // Timeout
|
||||||
}
|
}
|
||||||
|
@ -2,15 +2,22 @@
|
|||||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/*
|
||||||
|
* Event loop implementation for *BSD.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/event/kqueue.d,
|
||||||
|
* tanya/async/event/kqueue.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.event.kqueue;
|
module tanya.async.event.kqueue;
|
||||||
|
|
||||||
version (OSX)
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
else version (OSX)
|
||||||
{
|
{
|
||||||
version = MacBSD;
|
version = MacBSD;
|
||||||
}
|
}
|
||||||
@ -50,7 +57,7 @@ import tanya.async.event.selector;
|
|||||||
import tanya.async.loop;
|
import tanya.async.loop;
|
||||||
import tanya.async.transport;
|
import tanya.async.transport;
|
||||||
import tanya.async.watcher;
|
import tanya.async.watcher;
|
||||||
import tanya.container.vector;
|
import tanya.container.array;
|
||||||
import tanya.memory;
|
import tanya.memory;
|
||||||
import tanya.memory.mmappool;
|
import tanya.memory.mmappool;
|
||||||
import tanya.network.socket;
|
import tanya.network.socket;
|
||||||
@ -116,8 +123,8 @@ extern(C) int kevent(int kq, const kevent_t *changelist, int nchanges,
|
|||||||
final class KqueueLoop : SelectorLoop
|
final class KqueueLoop : SelectorLoop
|
||||||
{
|
{
|
||||||
protected int fd;
|
protected int fd;
|
||||||
private Vector!kevent_t events;
|
private Array!kevent_t events;
|
||||||
private Vector!kevent_t changes;
|
private Array!kevent_t changes;
|
||||||
private size_t changeCount;
|
private size_t changeCount;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -139,8 +146,8 @@ final class KqueueLoop : SelectorLoop
|
|||||||
throw make!BadLoopException(defaultAllocator,
|
throw make!BadLoopException(defaultAllocator,
|
||||||
"kqueue initialization failed");
|
"kqueue initialization failed");
|
||||||
}
|
}
|
||||||
events = Vector!kevent_t(64, MmapPool.instance);
|
events = Array!kevent_t(64, MmapPool.instance);
|
||||||
changes = Vector!kevent_t(64, MmapPool.instance);
|
changes = Array!kevent_t(64, MmapPool.instance);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -151,7 +158,7 @@ final class KqueueLoop : SelectorLoop
|
|||||||
close(fd);
|
close(fd);
|
||||||
}
|
}
|
||||||
|
|
||||||
private void set(socket_t socket, short filter, ushort flags) @nogc
|
private void set(SocketType socket, short filter, ushort flags) @nogc
|
||||||
{
|
{
|
||||||
if (changes.length <= changeCount)
|
if (changes.length <= changeCount)
|
||||||
{
|
{
|
||||||
|
@ -2,22 +2,29 @@
|
|||||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/*
|
||||||
|
* This module contains base implementations for reactor event loops.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/event/selector.d,
|
||||||
|
* tanya/async/event/selector.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.event.selector;
|
module tanya.async.event.selector;
|
||||||
|
|
||||||
version (Posix):
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
else version (Posix):
|
||||||
|
|
||||||
import tanya.async.loop;
|
import tanya.async.loop;
|
||||||
import tanya.async.protocol;
|
import tanya.async.protocol;
|
||||||
import tanya.async.transport;
|
import tanya.async.transport;
|
||||||
import tanya.async.watcher;
|
import tanya.async.watcher;
|
||||||
|
import tanya.container.array;
|
||||||
import tanya.container.buffer;
|
import tanya.container.buffer;
|
||||||
import tanya.container.vector;
|
|
||||||
import tanya.memory;
|
import tanya.memory;
|
||||||
import tanya.memory.mmappool;
|
import tanya.memory.mmappool;
|
||||||
import tanya.network.socket;
|
import tanya.network.socket;
|
||||||
@ -78,7 +85,8 @@ package class StreamTransport : SocketWatcher, DuplexTransport, SocketTransport
|
|||||||
return cast(ConnectedSocket) socket_;
|
return cast(ConnectedSocket) socket_;
|
||||||
}
|
}
|
||||||
|
|
||||||
private @property void socket(ConnectedSocket socket) pure nothrow @safe @nogc
|
private @property void socket(ConnectedSocket socket)
|
||||||
|
pure nothrow @safe @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(socket !is null);
|
assert(socket !is null);
|
||||||
@ -133,7 +141,9 @@ package class StreamTransport : SocketWatcher, DuplexTransport, SocketTransport
|
|||||||
void close() @nogc
|
void close() @nogc
|
||||||
{
|
{
|
||||||
closing = true;
|
closing = true;
|
||||||
loop.reify(this, EventMask(Event.read, Event.write), EventMask(Event.write));
|
loop.reify(this,
|
||||||
|
EventMask(Event.read, Event.write),
|
||||||
|
EventMask(Event.write));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -205,20 +215,20 @@ package class StreamTransport : SocketWatcher, DuplexTransport, SocketTransport
|
|||||||
abstract class SelectorLoop : Loop
|
abstract class SelectorLoop : Loop
|
||||||
{
|
{
|
||||||
/// Pending connections.
|
/// Pending connections.
|
||||||
protected Vector!SocketWatcher connections;
|
protected Array!SocketWatcher connections;
|
||||||
|
|
||||||
this() @nogc
|
this() @nogc
|
||||||
{
|
{
|
||||||
super();
|
super();
|
||||||
connections = Vector!SocketWatcher(maxEvents, MmapPool.instance);
|
connections = Array!SocketWatcher(maxEvents, MmapPool.instance);
|
||||||
}
|
}
|
||||||
|
|
||||||
~this() @nogc
|
~this() @nogc
|
||||||
{
|
{
|
||||||
foreach (ref connection; connections)
|
foreach (ref connection; connections)
|
||||||
{
|
{
|
||||||
// We want to free only the transports. ConnectionWatcher are created by the
|
// We want to free only the transports. ConnectionWatcher are
|
||||||
// user and should be freed by himself.
|
// created by the user and should be freed by himself.
|
||||||
if (cast(StreamTransport) connection !is null)
|
if (cast(StreamTransport) connection !is null)
|
||||||
{
|
{
|
||||||
MmapPool.instance.dispose(connection);
|
MmapPool.instance.dispose(connection);
|
||||||
|
@ -3,17 +3,41 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This module provides API for Windows I/O Completion Ports.
|
||||||
|
*
|
||||||
|
* Note: Available only on Windows.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/iocp.d,
|
||||||
|
* tanya/async/iocp.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.iocp;
|
module tanya.async.iocp;
|
||||||
|
|
||||||
version (Windows):
|
version (Windows)
|
||||||
|
{
|
||||||
|
version = WindowsDoc;
|
||||||
|
}
|
||||||
|
else version (D_Ddoc)
|
||||||
|
{
|
||||||
|
version = WindowsDoc;
|
||||||
|
version (Windows)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
private struct OVERLAPPED
|
||||||
|
{
|
||||||
|
}
|
||||||
|
private alias HANDLE = void*;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
import core.sys.windows.winbase;
|
version (WindowsDoc):
|
||||||
import core.sys.windows.windef;
|
|
||||||
|
import tanya.sys.windows.winbase;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Provides an extendable representation of a Win32 $(D_PSYMBOL OVERLAPPED)
|
* Provides an extendable representation of a Win32 $(D_PSYMBOL OVERLAPPED)
|
||||||
|
@ -3,10 +3,8 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Interface for the event loop implementations and the default event loop
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* chooser.
|
||||||
* Mozilla Public License, v. 2.0).
|
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
|
||||||
*
|
*
|
||||||
* ---
|
* ---
|
||||||
* import tanya.async;
|
* import tanya.async;
|
||||||
@ -38,11 +36,11 @@
|
|||||||
*
|
*
|
||||||
* version (Windows)
|
* version (Windows)
|
||||||
* {
|
* {
|
||||||
* auto sock = defaultAllocator.make!OverlappedStreamSocket(AddressFamily.INET);
|
* auto sock = defaultAllocator.make!OverlappedStreamSocket(AddressFamily.inet);
|
||||||
* }
|
* }
|
||||||
* else
|
* else
|
||||||
* {
|
* {
|
||||||
* auto sock = defaultAllocator.make!StreamSocket(AddressFamily.INET);
|
* auto sock = defaultAllocator.make!StreamSocket(AddressFamily.inet);
|
||||||
* sock.blocking = false;
|
* sock.blocking = false;
|
||||||
* }
|
* }
|
||||||
*
|
*
|
||||||
@ -61,6 +59,13 @@
|
|||||||
* defaultAllocator.dispose(address);
|
* defaultAllocator.dispose(address);
|
||||||
* }
|
* }
|
||||||
* ---
|
* ---
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/loop.d,
|
||||||
|
* tanya/async/loop.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.loop;
|
module tanya.async.loop;
|
||||||
|
|
||||||
@ -79,6 +84,9 @@ import tanya.network.socket;
|
|||||||
version (DisableBackends)
|
version (DisableBackends)
|
||||||
{
|
{
|
||||||
}
|
}
|
||||||
|
else version (D_Ddoc)
|
||||||
|
{
|
||||||
|
}
|
||||||
else version (linux)
|
else version (linux)
|
||||||
{
|
{
|
||||||
import tanya.async.event.epoll;
|
import tanya.async.event.epoll;
|
||||||
@ -109,6 +117,30 @@ else version (DragonFlyBSD)
|
|||||||
{
|
{
|
||||||
version = Kqueue;
|
version = Kqueue;
|
||||||
}
|
}
|
||||||
|
version (unittest)
|
||||||
|
{
|
||||||
|
final class TestLoop : Loop
|
||||||
|
{
|
||||||
|
override protected bool reify(SocketWatcher watcher,
|
||||||
|
EventMask oldEvents,
|
||||||
|
EventMask events) @nogc
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
override protected void poll() @nogc
|
||||||
|
{
|
||||||
|
assert(!this.done);
|
||||||
|
unloop();
|
||||||
|
}
|
||||||
|
|
||||||
|
override protected @property uint maxEvents()
|
||||||
|
const pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return 64U;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Events.
|
* Events.
|
||||||
@ -129,7 +161,7 @@ alias EventMask = BitFlags!Event;
|
|||||||
*/
|
*/
|
||||||
abstract class Loop
|
abstract class Loop
|
||||||
{
|
{
|
||||||
private bool done;
|
private bool done = true;
|
||||||
|
|
||||||
/// Pending watchers.
|
/// Pending watchers.
|
||||||
protected Queue!Watcher pendings;
|
protected Queue!Watcher pendings;
|
||||||
@ -144,6 +176,14 @@ abstract class Loop
|
|||||||
return 128U;
|
return 128U;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
auto loop = defaultAllocator.make!TestLoop;
|
||||||
|
assert(loop.maxEvents == 64);
|
||||||
|
|
||||||
|
defaultAllocator.dispose(loop);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Initializes the loop.
|
* Initializes the loop.
|
||||||
*/
|
*/
|
||||||
@ -168,18 +208,18 @@ abstract class Loop
|
|||||||
*/
|
*/
|
||||||
void run() @nogc
|
void run() @nogc
|
||||||
{
|
{
|
||||||
done = false;
|
this.done = false;
|
||||||
do
|
do
|
||||||
{
|
{
|
||||||
poll();
|
poll();
|
||||||
|
|
||||||
// Invoke pendings
|
// Invoke pendings
|
||||||
foreach (ref w; pendings)
|
foreach (ref w; this.pendings)
|
||||||
{
|
{
|
||||||
w.invoke();
|
w.invoke();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
while (!done);
|
while (!this.done);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -187,7 +227,32 @@ abstract class Loop
|
|||||||
*/
|
*/
|
||||||
void unloop() @safe pure nothrow @nogc
|
void unloop() @safe pure nothrow @nogc
|
||||||
{
|
{
|
||||||
done = true;
|
this.done = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
auto loop = defaultAllocator.make!TestLoop;
|
||||||
|
assert(loop.done);
|
||||||
|
|
||||||
|
loop.run();
|
||||||
|
assert(loop.done);
|
||||||
|
|
||||||
|
defaultAllocator.dispose(loop);
|
||||||
|
}
|
||||||
|
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
auto loop = defaultAllocator.make!TestLoop;
|
||||||
|
auto watcher = defaultAllocator.make!DummyWatcher;
|
||||||
|
loop.pendings.enqueue(watcher);
|
||||||
|
|
||||||
|
assert(!watcher.invoked);
|
||||||
|
loop.run();
|
||||||
|
assert(watcher.invoked);
|
||||||
|
|
||||||
|
defaultAllocator.dispose(loop);
|
||||||
|
defaultAllocator.dispose(watcher);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -266,6 +331,17 @@ abstract class Loop
|
|||||||
blockTime_ = blockTime;
|
blockTime_ = blockTime;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
auto loop = defaultAllocator.make!TestLoop;
|
||||||
|
assert(loop.blockTime == 1.dur!"minutes");
|
||||||
|
|
||||||
|
loop.blockTime = 2.dur!"minutes";
|
||||||
|
assert(loop.blockTime == 2.dur!"minutes");
|
||||||
|
|
||||||
|
defaultAllocator.dispose(loop);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Does the actual polling.
|
* Does the actual polling.
|
||||||
*/
|
*/
|
||||||
@ -344,3 +420,16 @@ body
|
|||||||
}
|
}
|
||||||
|
|
||||||
private Loop defaultLoop_;
|
private Loop defaultLoop_;
|
||||||
|
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
auto oldLoop = defaultLoop_;
|
||||||
|
auto loop = defaultAllocator.make!TestLoop;
|
||||||
|
|
||||||
|
defaultLoop = loop;
|
||||||
|
assert(defaultLoop_ is loop);
|
||||||
|
assert(defaultLoop is loop);
|
||||||
|
|
||||||
|
defaultLoop_ = oldLoop;
|
||||||
|
defaultAllocator.dispose(loop);
|
||||||
|
}
|
||||||
|
@ -3,10 +3,14 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This package provides asynchronous capabilities.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/package.d,
|
||||||
|
* tanya/async/package.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async;
|
module tanya.async;
|
||||||
|
|
||||||
|
@ -3,15 +3,23 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This module contains protocol which handle data in asynchronous
|
||||||
|
* applications.
|
||||||
|
*
|
||||||
|
* When an event from the network arrives, a protocol method gets
|
||||||
|
* called and can respond to the event.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/protocol.d,
|
||||||
|
* tanya/async/protocol.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.protocol;
|
module tanya.async.protocol;
|
||||||
|
|
||||||
import tanya.network.socket;
|
|
||||||
import tanya.async.transport;
|
import tanya.async.transport;
|
||||||
|
import tanya.network.socket;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Common protocol interface.
|
* Common protocol interface.
|
||||||
|
@ -3,10 +3,15 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This module contains transports which are responsible for data dilvery
|
||||||
|
* between two parties of an asynchronous communication.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/transport.d,
|
||||||
|
* tanya/async/transport.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.transport;
|
module tanya.async.transport;
|
||||||
|
|
||||||
|
@ -3,15 +3,19 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Watchers register user's interest in some event.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/async/watcher.d,
|
||||||
|
* tanya/async/watcher.d)
|
||||||
*/
|
*/
|
||||||
module tanya.async.watcher;
|
module tanya.async.watcher;
|
||||||
|
|
||||||
import std.functional;
|
|
||||||
import std.exception;
|
import std.exception;
|
||||||
|
import std.functional;
|
||||||
import tanya.async.loop;
|
import tanya.async.loop;
|
||||||
import tanya.async.protocol;
|
import tanya.async.protocol;
|
||||||
import tanya.async.transport;
|
import tanya.async.transport;
|
||||||
@ -36,6 +40,19 @@ abstract class Watcher
|
|||||||
void invoke() @nogc;
|
void invoke() @nogc;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
version (unittest)
|
||||||
|
{
|
||||||
|
final class DummyWatcher : Watcher
|
||||||
|
{
|
||||||
|
bool invoked;
|
||||||
|
|
||||||
|
override void invoke() @nogc
|
||||||
|
{
|
||||||
|
this.invoked = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Socket watcher.
|
* Socket watcher.
|
||||||
*/
|
*/
|
||||||
|
File diff suppressed because it is too large
Load Diff
@ -3,15 +3,19 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This module contains buffers designed for C-style input/output APIs.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/container/buffer.d,
|
||||||
|
* tanya/container/buffer.d)
|
||||||
*/
|
*/
|
||||||
module tanya.container.buffer;
|
module tanya.container.buffer;
|
||||||
|
|
||||||
import std.traits;
|
|
||||||
import tanya.memory;
|
import tanya.memory;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
version (unittest)
|
version (unittest)
|
||||||
{
|
{
|
||||||
@ -96,7 +100,7 @@ struct ReadBuffer(T = ubyte)
|
|||||||
buffer_ = cast(T[]) allocator_.allocate(size * T.sizeof);
|
buffer_ = cast(T[]) allocator_.allocate(size * T.sizeof);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
this(shared Allocator allocator)
|
this(shared Allocator allocator)
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
@ -139,7 +143,7 @@ struct ReadBuffer(T = ubyte)
|
|||||||
return length_ - start;
|
return length_ - start;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
alias opDollar = length;
|
alias opDollar = length;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -391,7 +395,7 @@ struct WriteBuffer(T = ubyte)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
alias opDollar = length;
|
alias opDollar = length;
|
||||||
|
|
||||||
///
|
///
|
||||||
|
@ -9,14 +9,100 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/container/entry.d,
|
||||||
|
* tanya/container/entry.d)
|
||||||
*/
|
*/
|
||||||
module tanya.container.entry;
|
module tanya.container.entry;
|
||||||
|
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.typecons;
|
||||||
|
|
||||||
package struct SEntry(T)
|
package struct SEntry(T)
|
||||||
{
|
{
|
||||||
/// Item content.
|
// Item content.
|
||||||
T content;
|
T content;
|
||||||
|
|
||||||
/// Next item.
|
// Next item.
|
||||||
SEntry* next;
|
SEntry* next;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
package struct DEntry(T)
|
||||||
|
{
|
||||||
|
// Item content.
|
||||||
|
T content;
|
||||||
|
|
||||||
|
// Previous and next item.
|
||||||
|
DEntry* next, prev;
|
||||||
|
}
|
||||||
|
|
||||||
|
package struct HashEntry(K, V)
|
||||||
|
{
|
||||||
|
this(ref K key, ref V value)
|
||||||
|
{
|
||||||
|
this.pair = Pair!(K, V)(key, value);
|
||||||
|
}
|
||||||
|
|
||||||
|
Pair!(K, V) pair;
|
||||||
|
HashEntry* next;
|
||||||
|
}
|
||||||
|
|
||||||
|
package enum BucketStatus : byte
|
||||||
|
{
|
||||||
|
deleted = -1,
|
||||||
|
empty = 0,
|
||||||
|
used = 1,
|
||||||
|
}
|
||||||
|
|
||||||
|
package struct Bucket(T)
|
||||||
|
{
|
||||||
|
@property void content(ref T content)
|
||||||
|
{
|
||||||
|
this.content_ = content;
|
||||||
|
this.status = BucketStatus.used;
|
||||||
|
}
|
||||||
|
|
||||||
|
@property ref inout(T) content() inout
|
||||||
|
{
|
||||||
|
return this.content_;
|
||||||
|
}
|
||||||
|
|
||||||
|
bool opEquals(ref T content)
|
||||||
|
{
|
||||||
|
if (this.status == BucketStatus.used && this.content == content)
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
bool opEquals(ref const T content) const
|
||||||
|
{
|
||||||
|
if (this.status == BucketStatus.used && this.content == content)
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
bool opEquals(ref typeof(this) that)
|
||||||
|
{
|
||||||
|
return this.content == that.content && this.status == that.status;
|
||||||
|
}
|
||||||
|
|
||||||
|
bool opEquals(ref typeof(this) that) const
|
||||||
|
{
|
||||||
|
return this.content == that.content && this.status == that.status;
|
||||||
|
}
|
||||||
|
|
||||||
|
void remove()
|
||||||
|
{
|
||||||
|
static if (hasElaborateDestructor!T)
|
||||||
|
{
|
||||||
|
destroy(this.content);
|
||||||
|
}
|
||||||
|
this.status = BucketStatus.deleted;
|
||||||
|
}
|
||||||
|
|
||||||
|
T content_;
|
||||||
|
BucketStatus status = BucketStatus.empty;
|
||||||
|
}
|
||||||
|
File diff suppressed because it is too large
Load Diff
@ -9,10 +9,36 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/container/package.d,
|
||||||
|
* tanya/container/package.d)
|
||||||
*/
|
*/
|
||||||
module tanya.container;
|
module tanya.container;
|
||||||
|
|
||||||
|
public import tanya.container.array;
|
||||||
public import tanya.container.buffer;
|
public import tanya.container.buffer;
|
||||||
public import tanya.container.list;
|
public import tanya.container.list;
|
||||||
public import tanya.container.vector;
|
|
||||||
public import tanya.container.queue;
|
public import tanya.container.queue;
|
||||||
|
public import tanya.container.set;
|
||||||
|
public import tanya.container.string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Thrown if $(D_PSYMBOL Set) cannot insert a new element because the container
|
||||||
|
* is full.
|
||||||
|
*/
|
||||||
|
class HashContainerFullException : Exception
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* msg = The message for the exception.
|
||||||
|
* file = The file where the exception occurred.
|
||||||
|
* line = The line number where the exception occurred.
|
||||||
|
* next = The previous exception in the chain of exceptions, if any.
|
||||||
|
*/
|
||||||
|
this(string msg,
|
||||||
|
string file = __FILE__,
|
||||||
|
size_t line = __LINE__,
|
||||||
|
Throwable next = null) @nogc @safe pure nothrow
|
||||||
|
{
|
||||||
|
super(msg, file, line, next);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
@ -9,14 +9,16 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/container/queue.d,
|
||||||
|
* tanya/container/queue.d)
|
||||||
*/
|
*/
|
||||||
module tanya.container.queue;
|
module tanya.container.queue;
|
||||||
|
|
||||||
import core.exception;
|
import tanya.algorithm.mutation;
|
||||||
import std.traits;
|
|
||||||
import std.algorithm.mutation;
|
|
||||||
import tanya.container.entry;
|
import tanya.container.entry;
|
||||||
|
import tanya.exception;
|
||||||
import tanya.memory;
|
import tanya.memory;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* FIFO queue.
|
* FIFO queue.
|
||||||
@ -113,7 +115,7 @@ struct Queue(T)
|
|||||||
enqueueEntry(temp);
|
enqueueEntry(temp);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
void enqueue(T x)
|
void enqueue(T x)
|
||||||
{
|
{
|
||||||
auto temp = allocateEntry();
|
auto temp = allocateEntry();
|
||||||
@ -199,7 +201,7 @@ struct Queue(T)
|
|||||||
{
|
{
|
||||||
int result;
|
int result;
|
||||||
|
|
||||||
for (size_t i = 0; !empty; ++i)
|
for (size_t i; !empty; ++i)
|
||||||
{
|
{
|
||||||
auto e = dequeue();
|
auto e = dequeue();
|
||||||
if ((result = dg(i, e)) != 0)
|
if ((result = dg(i, e)) != 0)
|
||||||
@ -210,7 +212,7 @@ struct Queue(T)
|
|||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
int opApply(scope int delegate(ref T) @nogc dg)
|
int opApply(scope int delegate(ref T) @nogc dg)
|
||||||
{
|
{
|
||||||
int result;
|
int result;
|
||||||
|
719
source/tanya/container/set.d
Normal file
719
source/tanya/container/set.d
Normal file
@ -0,0 +1,719 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This module implements a $(D_PSYMBOL Set) container that stores unique
|
||||||
|
* values without any particular order.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/container/set.d,
|
||||||
|
* tanya/container/set.d)
|
||||||
|
*/
|
||||||
|
module tanya.container.set;
|
||||||
|
|
||||||
|
import tanya.algorithm.mutation;
|
||||||
|
import tanya.container;
|
||||||
|
import tanya.container.entry;
|
||||||
|
import tanya.memory;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.meta.transform;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bidirectional range that iterates over the $(D_PSYMBOL Set)'s values.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* E = Element type.
|
||||||
|
*/
|
||||||
|
struct Range(E)
|
||||||
|
{
|
||||||
|
static if (isMutable!E)
|
||||||
|
{
|
||||||
|
private alias DataRange = Array!(Bucket!(Unqual!E)).Range;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
private alias DataRange = Array!(Bucket!(Unqual!E)).ConstRange;
|
||||||
|
}
|
||||||
|
private DataRange dataRange;
|
||||||
|
|
||||||
|
@disable this();
|
||||||
|
|
||||||
|
private this(DataRange dataRange)
|
||||||
|
{
|
||||||
|
while (!dataRange.empty && dataRange.front.status != BucketStatus.used)
|
||||||
|
{
|
||||||
|
dataRange.popFront();
|
||||||
|
}
|
||||||
|
while (!dataRange.empty && dataRange.back.status != BucketStatus.used)
|
||||||
|
{
|
||||||
|
dataRange.popBack();
|
||||||
|
}
|
||||||
|
this.dataRange = dataRange;
|
||||||
|
}
|
||||||
|
|
||||||
|
@property Range save()
|
||||||
|
{
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
@property bool empty() const
|
||||||
|
{
|
||||||
|
return this.dataRange.empty();
|
||||||
|
}
|
||||||
|
|
||||||
|
@property void popFront()
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(!this.dataRange.empty);
|
||||||
|
assert(this.dataRange.front.status == BucketStatus.used);
|
||||||
|
}
|
||||||
|
out
|
||||||
|
{
|
||||||
|
assert(this.dataRange.empty
|
||||||
|
|| this.dataRange.back.status == BucketStatus.used);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
do
|
||||||
|
{
|
||||||
|
dataRange.popFront();
|
||||||
|
}
|
||||||
|
while (!dataRange.empty && dataRange.front.status != BucketStatus.used);
|
||||||
|
}
|
||||||
|
|
||||||
|
@property void popBack()
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(!this.dataRange.empty);
|
||||||
|
assert(this.dataRange.back.status == BucketStatus.used);
|
||||||
|
}
|
||||||
|
out
|
||||||
|
{
|
||||||
|
assert(this.dataRange.empty
|
||||||
|
|| this.dataRange.back.status == BucketStatus.used);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
do
|
||||||
|
{
|
||||||
|
dataRange.popBack();
|
||||||
|
}
|
||||||
|
while (!dataRange.empty && dataRange.back.status != BucketStatus.used);
|
||||||
|
}
|
||||||
|
|
||||||
|
@property ref inout(E) front() inout
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(!this.dataRange.empty);
|
||||||
|
assert(this.dataRange.front.status == BucketStatus.used);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return dataRange.front.content;
|
||||||
|
}
|
||||||
|
|
||||||
|
@property ref inout(E) back() inout
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(!this.dataRange.empty);
|
||||||
|
assert(this.dataRange.back.status == BucketStatus.used);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return dataRange.back.content;
|
||||||
|
}
|
||||||
|
|
||||||
|
Range opIndex()
|
||||||
|
{
|
||||||
|
return typeof(return)(this.dataRange[]);
|
||||||
|
}
|
||||||
|
|
||||||
|
Range!(const E) opIndex() const
|
||||||
|
{
|
||||||
|
return typeof(return)(this.dataRange[]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set is a data structure that stores unique values without any particular
|
||||||
|
* order.
|
||||||
|
*
|
||||||
|
* This $(D_PSYMBOL Set) is implemented using closed hashing. Hash collisions
|
||||||
|
* are resolved with linear probing.
|
||||||
|
*
|
||||||
|
* Currently works only with integral types.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Element type.
|
||||||
|
*/
|
||||||
|
struct Set(T)
|
||||||
|
if (isIntegral!T || is(Unqual!T == bool))
|
||||||
|
{
|
||||||
|
/// The range types for $(D_PSYMBOL Set).
|
||||||
|
alias Range = .Range!T;
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
alias ConstRange = .Range!(const T);
|
||||||
|
|
||||||
|
invariant
|
||||||
|
{
|
||||||
|
assert(this.lengthIndex < primes.length);
|
||||||
|
assert(this.data.length == 0
|
||||||
|
|| this.data.length == primes[this.lengthIndex]);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructor.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* n = Minimum number of buckets.
|
||||||
|
* allocator = Allocator.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null).
|
||||||
|
*/
|
||||||
|
this(const size_t n, shared Allocator allocator = defaultAllocator)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
this(allocator);
|
||||||
|
rehash(n);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
this(shared Allocator allocator)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
this.data = typeof(this.data)(allocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
auto set = Set!int(defaultAllocator);
|
||||||
|
assert(set.capacity == 0);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto set = Set!int(8);
|
||||||
|
assert(set.capacity == 13);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Initializes this $(D_PARAM Set) from another one.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM init) is passed by reference, it will be copied.
|
||||||
|
* If $(D_PARAM init) is passed by value, it will be moved.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* S = Source set type.
|
||||||
|
* init = Source set.
|
||||||
|
* allocator = Allocator.
|
||||||
|
*/
|
||||||
|
this(S)(ref S init, shared Allocator allocator = defaultAllocator)
|
||||||
|
if (is(Unqual!S == Set))
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
this.data = typeof(this.data)(init.data, allocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
this(S)(S init, shared Allocator allocator = defaultAllocator)
|
||||||
|
if (is(S == Set))
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
this.data = typeof(this.data)(move(init.data), allocator);
|
||||||
|
this.lengthIndex = init.lengthIndex;
|
||||||
|
init.lengthIndex = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Assigns another set.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM that) is passed by reference, it will be copied.
|
||||||
|
* If $(D_PARAM that) is passed by value, it will be moved.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* S = Content type.
|
||||||
|
* that = The value should be assigned.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD this).
|
||||||
|
*/
|
||||||
|
ref typeof(this) opAssign(S)(ref S that)
|
||||||
|
if (is(Unqual!S == Set))
|
||||||
|
{
|
||||||
|
this.data = that.data;
|
||||||
|
this.lengthIndex = that.lengthIndex;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref typeof(this) opAssign(S)(S that) @trusted
|
||||||
|
if (is(S == Set))
|
||||||
|
{
|
||||||
|
swap(this.data, that.data);
|
||||||
|
swap(this.lengthIndex, that.lengthIndex);
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Used allocator.
|
||||||
|
*
|
||||||
|
* Postcondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
@property shared(Allocator) allocator() const
|
||||||
|
out (allocator)
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return cast(shared Allocator) this.data.allocator;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Maximum amount of elements this $(D_PSYMBOL Set) can hold without
|
||||||
|
* resizing and rehashing. Note that it doesn't mean that the
|
||||||
|
* $(D_PSYMBOL Set) will hold $(I exactly) $(D_PSYMBOL capacity) elements.
|
||||||
|
* $(D_PSYMBOL capacity) tells the size of the container under a best-case
|
||||||
|
* distribution of elements.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PSYMBOL Set) capacity.
|
||||||
|
*/
|
||||||
|
@property size_t capacity() const
|
||||||
|
{
|
||||||
|
return this.data.length;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
assert(set.capacity == 0);
|
||||||
|
|
||||||
|
set.insert(8);
|
||||||
|
assert(set.capacity == 3);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Iterates over the $(D_PSYMBOL Set) and counts the elements.
|
||||||
|
*
|
||||||
|
* Returns: Count of elements within the $(D_PSYMBOL Set).
|
||||||
|
*/
|
||||||
|
@property size_t length() const
|
||||||
|
{
|
||||||
|
size_t count;
|
||||||
|
foreach (ref e; this.data[])
|
||||||
|
{
|
||||||
|
if (e.status == BucketStatus.used)
|
||||||
|
{
|
||||||
|
++count;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return count;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
assert(set.length == 0);
|
||||||
|
|
||||||
|
set.insert(8);
|
||||||
|
assert(set.length == 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static const size_t[41] primes = [
|
||||||
|
3, 7, 13, 23, 29, 37, 53, 71, 97, 131, 163, 193, 239, 293, 389, 521,
|
||||||
|
769, 919, 1103, 1327, 1543, 2333, 3079, 4861, 6151, 12289, 24593,
|
||||||
|
49157, 98317, 196613, 393241, 786433, 1572869, 3145739, 6291469,
|
||||||
|
12582917, 25165843, 139022417, 282312799, 573292817, 1164186217,
|
||||||
|
];
|
||||||
|
|
||||||
|
/// The maximum number of buckets the container can have.
|
||||||
|
enum size_t maxBucketCount = primes[$ - 1];
|
||||||
|
|
||||||
|
static private size_t calculateHash(U)(ref const U value)
|
||||||
|
if (is(U == Unqual!T))
|
||||||
|
{
|
||||||
|
static if (isIntegral!T || isSomeChar!T || is(T == bool))
|
||||||
|
{
|
||||||
|
return (cast(size_t) value);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
static private size_t locateBucket(ref const DataType buckets,
|
||||||
|
const size_t hash)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(buckets.length > 0);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return hash % buckets.length;
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Returns bucket position for `hash`. `0` may mean the 0th position or an
|
||||||
|
* empty `buckets` array.
|
||||||
|
*/
|
||||||
|
private size_t locateBucket(const size_t hash) const
|
||||||
|
{
|
||||||
|
return this.data.length == 0 ? 0 : locateBucket(this.data, hash);
|
||||||
|
}
|
||||||
|
|
||||||
|
private enum InsertStatus : byte
|
||||||
|
{
|
||||||
|
found = -1,
|
||||||
|
failed = 0,
|
||||||
|
added = 1,
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Inserts the value in an empty or deleted bucket. If the value is
|
||||||
|
* already in there, does nothing and returns InsertStatus.found. If the
|
||||||
|
* hash array is full returns InsertStatus.failed. Otherwise,
|
||||||
|
* InsertStatus.added is returned.
|
||||||
|
*/
|
||||||
|
private InsertStatus insertInUnusedBucket(ref T value)
|
||||||
|
{
|
||||||
|
auto bucketPosition = locateBucket(this.data, calculateHash(value));
|
||||||
|
|
||||||
|
foreach (ref e; this.data[bucketPosition .. $])
|
||||||
|
{
|
||||||
|
if (e == value) // Already in the set.
|
||||||
|
{
|
||||||
|
return InsertStatus.found;
|
||||||
|
}
|
||||||
|
else if (e.status != BucketStatus.used) // Insert the value.
|
||||||
|
{
|
||||||
|
e.content = value;
|
||||||
|
return InsertStatus.added;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return InsertStatus.failed;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Inserts a new element.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* value = Element value.
|
||||||
|
*
|
||||||
|
* Returns: Amount of new elements inserted.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL HashContainerFullException) if the insertion failed.
|
||||||
|
*/
|
||||||
|
size_t insert(T value)
|
||||||
|
{
|
||||||
|
if (this.data.length == 0)
|
||||||
|
{
|
||||||
|
this.data = DataType(primes[0], allocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
InsertStatus status = insertInUnusedBucket(value);
|
||||||
|
for (; !status; status = insertInUnusedBucket(value))
|
||||||
|
{
|
||||||
|
if (this.primes.length == (this.lengthIndex + 1))
|
||||||
|
{
|
||||||
|
throw make!HashContainerFullException(defaultAllocator,
|
||||||
|
"Set is full");
|
||||||
|
}
|
||||||
|
rehashToSize(this.lengthIndex + 1);
|
||||||
|
}
|
||||||
|
return status == InsertStatus.added;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
assert(8 !in set);
|
||||||
|
|
||||||
|
assert(set.insert(8) == 1);
|
||||||
|
assert(set.length == 1);
|
||||||
|
assert(8 in set);
|
||||||
|
|
||||||
|
assert(set.insert(8) == 0);
|
||||||
|
assert(set.length == 1);
|
||||||
|
assert(8 in set);
|
||||||
|
|
||||||
|
assert(set.remove(8));
|
||||||
|
assert(set.insert(8) == 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Removes an element.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* value = Element value.
|
||||||
|
*
|
||||||
|
* Returns: Number of elements removed, which is in the container with
|
||||||
|
* unique values `1` if an element existed, and `0` otherwise.
|
||||||
|
*/
|
||||||
|
size_t remove(T value)
|
||||||
|
{
|
||||||
|
auto bucketPosition = locateBucket(calculateHash(value));
|
||||||
|
foreach (ref e; this.data[bucketPosition .. $])
|
||||||
|
{
|
||||||
|
if (e == value) // Found.
|
||||||
|
{
|
||||||
|
e.remove();
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
else if (e.status == BucketStatus.empty)
|
||||||
|
{
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
assert(8 !in set);
|
||||||
|
|
||||||
|
set.insert(8);
|
||||||
|
assert(8 in set);
|
||||||
|
|
||||||
|
assert(set.remove(8) == 1);
|
||||||
|
assert(set.remove(8) == 0);
|
||||||
|
assert(8 !in set);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_KEYWORD in) operator.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* value = Element to be searched for.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if the given element exists in the container,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool opBinaryRight(string op : "in")(auto ref const T value) const
|
||||||
|
{
|
||||||
|
auto bucketPosition = locateBucket(calculateHash(value));
|
||||||
|
foreach (ref e; this.data[bucketPosition .. $])
|
||||||
|
{
|
||||||
|
if (e == value) // Found.
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
else if (e.status == BucketStatus.empty)
|
||||||
|
{
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
|
||||||
|
assert(5 !in set);
|
||||||
|
set.insert(5);
|
||||||
|
assert(5 in set);
|
||||||
|
assert(8 !in set);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sets the number of buckets in the container to at least $(D_PARAM n)
|
||||||
|
* and rearranges all the elements according to their hash values.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM n) is greater than the current $(D_PSYMBOL capacity)
|
||||||
|
* and lower than or equal to $(D_PSYMBOL maxBucketCount), a rehash is
|
||||||
|
* forced.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM n) is greater than $(D_PSYMBOL maxBucketCount),
|
||||||
|
* $(D_PSYMBOL maxBucketCount) is used instead as a new number of buckets.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM n) is equal to the current $(D_PSYMBOL capacity), rehashing
|
||||||
|
* is forced without resizing the container.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM n) is lower than the current $(D_PSYMBOL capacity), the
|
||||||
|
* function may have no effect.
|
||||||
|
*
|
||||||
|
* Rehashing is automatically performed whenever the container needs space
|
||||||
|
* to insert new elements.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* n = Minimum number of buckets.
|
||||||
|
*/
|
||||||
|
void rehash(const size_t n)
|
||||||
|
{
|
||||||
|
size_t lengthIndex;
|
||||||
|
for (; lengthIndex < primes.length; ++lengthIndex)
|
||||||
|
{
|
||||||
|
if (primes[lengthIndex] >= n)
|
||||||
|
{
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
rehashToSize(lengthIndex);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Takes an index in the primes array.
|
||||||
|
private void rehashToSize(const size_t n)
|
||||||
|
{
|
||||||
|
auto storage = DataType(primes[n], allocator);
|
||||||
|
DataLoop: foreach (ref e1; this.data[])
|
||||||
|
{
|
||||||
|
if (e1.status == BucketStatus.used)
|
||||||
|
{
|
||||||
|
auto bucketPosition = locateBucket(storage,
|
||||||
|
calculateHash(e1.content));
|
||||||
|
|
||||||
|
foreach (ref e2; storage[bucketPosition .. $])
|
||||||
|
{
|
||||||
|
if (e2.status != BucketStatus.used) // Insert the value.
|
||||||
|
{
|
||||||
|
e2.content = e1.content;
|
||||||
|
continue DataLoop;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return; // Rehashing failed.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
move(storage, this.data);
|
||||||
|
this.lengthIndex = n;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: A bidirectional range that iterates over the $(D_PSYMBOL Set)'s
|
||||||
|
* elements.
|
||||||
|
*/
|
||||||
|
Range opIndex()
|
||||||
|
{
|
||||||
|
return typeof(return)(this.data[]);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ConstRange opIndex() const
|
||||||
|
{
|
||||||
|
return typeof(return)(this.data[]);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
assert(set[].empty);
|
||||||
|
|
||||||
|
set.insert(8);
|
||||||
|
assert(!set[].empty);
|
||||||
|
assert(set[].front == 8);
|
||||||
|
assert(set[].back == 8);
|
||||||
|
|
||||||
|
set.remove(8);
|
||||||
|
assert(set[].empty);
|
||||||
|
}
|
||||||
|
|
||||||
|
private @nogc unittest
|
||||||
|
{
|
||||||
|
const Set!int set;
|
||||||
|
assert(set[].empty);
|
||||||
|
}
|
||||||
|
|
||||||
|
private @nogc unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
set.insert(8);
|
||||||
|
|
||||||
|
auto r1 = set[];
|
||||||
|
auto r2 = r1.save();
|
||||||
|
|
||||||
|
r1.popFront();
|
||||||
|
assert(r1.empty);
|
||||||
|
|
||||||
|
r2.popBack();
|
||||||
|
assert(r2.empty);
|
||||||
|
}
|
||||||
|
|
||||||
|
private alias DataType = Array!(Bucket!T);
|
||||||
|
private DataType data;
|
||||||
|
private size_t lengthIndex;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Basic insertion logic.
|
||||||
|
private @nogc unittest
|
||||||
|
{
|
||||||
|
Set!int set;
|
||||||
|
|
||||||
|
assert(set.insert(5) == 1);
|
||||||
|
assert(set.data[0].status == BucketStatus.empty);
|
||||||
|
assert(set.data[1].status == BucketStatus.empty);
|
||||||
|
assert(set.data[2].content == 5 && set.data[2].status == BucketStatus.used);
|
||||||
|
assert(set.data.length == 3);
|
||||||
|
|
||||||
|
assert(set.insert(5) == 0);
|
||||||
|
assert(set.data[0].status == BucketStatus.empty);
|
||||||
|
assert(set.data[1].status == BucketStatus.empty);
|
||||||
|
assert(set.data[2].content == 5 && set.data[2].status == BucketStatus.used);
|
||||||
|
assert(set.data.length == 3);
|
||||||
|
|
||||||
|
assert(set.insert(9) == 1);
|
||||||
|
assert(set.data[0].content == 9 && set.data[0].status == BucketStatus.used);
|
||||||
|
assert(set.data[1].status == BucketStatus.empty);
|
||||||
|
assert(set.data[2].content == 5 && set.data[2].status == BucketStatus.used);
|
||||||
|
assert(set.data.length == 3);
|
||||||
|
|
||||||
|
assert(set.insert(7) == 1);
|
||||||
|
assert(set.insert(8) == 1);
|
||||||
|
assert(set.data[0].content == 7);
|
||||||
|
assert(set.data[1].content == 8);
|
||||||
|
assert(set.data[2].content == 9);
|
||||||
|
assert(set.data[3].status == BucketStatus.empty);
|
||||||
|
assert(set.data[5].content == 5);
|
||||||
|
assert(set.data.length == 7);
|
||||||
|
|
||||||
|
assert(set.insert(16) == 1);
|
||||||
|
assert(set.data[2].content == 9);
|
||||||
|
assert(set.data[3].content == 16);
|
||||||
|
assert(set.data[4].status == BucketStatus.empty);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Static checks.
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
import tanya.range.primitive;
|
||||||
|
|
||||||
|
static assert(isBidirectionalRange!(Set!int.ConstRange));
|
||||||
|
static assert(isBidirectionalRange!(Set!int.Range));
|
||||||
|
|
||||||
|
static assert(!isInfinite!(Set!int.Range));
|
||||||
|
static assert(!hasLength!(Set!int.Range));
|
||||||
|
|
||||||
|
static assert(is(Set!uint));
|
||||||
|
static assert(is(Set!long));
|
||||||
|
static assert(is(Set!ulong));
|
||||||
|
static assert(is(Set!short));
|
||||||
|
static assert(is(Set!ushort));
|
||||||
|
static assert(is(Set!bool));
|
||||||
|
}
|
1680
source/tanya/container/string.d
Normal file
1680
source/tanya/container/string.d
Normal file
File diff suppressed because it is too large
Load Diff
709
source/tanya/conv.d
Normal file
709
source/tanya/conv.d
Normal file
@ -0,0 +1,709 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This module provides functions for converting between different types.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/conv.d,
|
||||||
|
* tanya/conv.d)
|
||||||
|
*/
|
||||||
|
module tanya.conv;
|
||||||
|
|
||||||
|
import tanya.container.string;
|
||||||
|
import tanya.format;
|
||||||
|
import tanya.memory;
|
||||||
|
import tanya.memory.op;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.meta.transform;
|
||||||
|
|
||||||
|
version (unittest)
|
||||||
|
{
|
||||||
|
import tanya.test.assertion;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new object of type $(D_PARAM T) in $(D_PARAM memory) with the
|
||||||
|
* given arguments.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM T) is a $(D_KEYWORD class), emplace returns a class reference
|
||||||
|
* of type $(D_PARAM T), otherwise a pointer to the constructed object is
|
||||||
|
* returned.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM T) is a nested class inside another class, $(D_PARAM outer)
|
||||||
|
* should be an instance of the outer class.
|
||||||
|
*
|
||||||
|
* $(D_PARAM args) are arguments for the constructor of $(D_PARAM T). If
|
||||||
|
* $(D_PARAM T) isn't an aggregate type and doesn't have a constructor,
|
||||||
|
* $(D_PARAM memory) can be initialized to `args[0]` if `Args.length == 1`,
|
||||||
|
* `Args[0]` should be implicitly convertible to $(D_PARAM T) then.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Constructed type.
|
||||||
|
* U = Type of the outer class if $(D_PARAM T) is a nested class.
|
||||||
|
* Args = Types of the constructor arguments if $(D_PARAM T) has a constructor
|
||||||
|
* or the type of the initial value.
|
||||||
|
* outer = Outer class instance if $(D_PARAM T) is a nested class.
|
||||||
|
* args = Constructor arguments if $(D_PARAM T) has a constructor or the
|
||||||
|
* initial value.
|
||||||
|
*
|
||||||
|
* Returns: New instance of type $(D_PARAM T) constructed in $(D_PARAM memory).
|
||||||
|
*
|
||||||
|
* Precondition: `memory.length == stateSize!T`.
|
||||||
|
* Postcondition: $(D_PARAM memory) and the result point to the same memory.
|
||||||
|
*/
|
||||||
|
T emplace(T, U, Args...)(void[] memory, U outer, auto ref Args args)
|
||||||
|
if (!isAbstractClass!T && isInnerClass!T && is(typeof(T.outer) == U))
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(memory.length >= stateSize!T);
|
||||||
|
}
|
||||||
|
out (result)
|
||||||
|
{
|
||||||
|
assert(memory.ptr is (() @trusted => cast(void*) result)());
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
copy(typeid(T).initializer, memory);
|
||||||
|
|
||||||
|
auto result = (() @trusted => cast(T) memory.ptr)();
|
||||||
|
result.outer = outer;
|
||||||
|
|
||||||
|
static if (is(typeof(result.__ctor(args))))
|
||||||
|
{
|
||||||
|
result.__ctor(args);
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T emplace(T, Args...)(void[] memory, auto ref Args args)
|
||||||
|
if (is(T == class) && !isAbstractClass!T && !isInnerClass!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(memory.length == stateSize!T);
|
||||||
|
}
|
||||||
|
out (result)
|
||||||
|
{
|
||||||
|
assert(memory.ptr is (() @trusted => cast(void*) result)());
|
||||||
|
}body
|
||||||
|
{
|
||||||
|
copy(typeid(T).initializer, memory);
|
||||||
|
|
||||||
|
auto result = (() @trusted => cast(T) memory.ptr)();
|
||||||
|
static if (is(typeof(result.__ctor(args))))
|
||||||
|
{
|
||||||
|
result.__ctor(args);
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
import tanya.memory : stateSize;
|
||||||
|
|
||||||
|
class C
|
||||||
|
{
|
||||||
|
int i = 5;
|
||||||
|
class Inner
|
||||||
|
{
|
||||||
|
int i;
|
||||||
|
|
||||||
|
this(int param) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.i = param;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
ubyte[stateSize!C] memory1;
|
||||||
|
ubyte[stateSize!(C.Inner)] memory2;
|
||||||
|
|
||||||
|
auto c = emplace!C(memory1);
|
||||||
|
assert(c.i == 5);
|
||||||
|
|
||||||
|
auto inner = emplace!(C.Inner)(memory2, c, 8);
|
||||||
|
assert(c.i == 5);
|
||||||
|
assert(inner.i == 8);
|
||||||
|
assert(inner.outer is c);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T* emplace(T, Args...)(void[] memory, auto ref Args args)
|
||||||
|
if (!isAggregateType!T && (Args.length <= 1))
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(memory.length >= T.sizeof);
|
||||||
|
}
|
||||||
|
out (result)
|
||||||
|
{
|
||||||
|
assert(memory.ptr is result);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto result = (() @trusted => cast(T*) memory.ptr)();
|
||||||
|
static if (Args.length == 1)
|
||||||
|
{
|
||||||
|
*result = T(args[0]);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
*result = T.init;
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T* emplace(T, Args...)(void[] memory, auto ref Args args)
|
||||||
|
if (!isPolymorphicType!T && isAggregateType!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(memory.length >= T.sizeof);
|
||||||
|
}
|
||||||
|
out (result)
|
||||||
|
{
|
||||||
|
assert(memory.ptr is result);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto result = (() @trusted => cast(T*) memory.ptr)();
|
||||||
|
static if (!hasElaborateAssign!T && isAssignable!T)
|
||||||
|
{
|
||||||
|
*result = T.init;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static const T init = T.init;
|
||||||
|
copy((cast(void*) &init)[0 .. T.sizeof], memory);
|
||||||
|
}
|
||||||
|
|
||||||
|
static if (Args.length == 0)
|
||||||
|
{
|
||||||
|
static assert(is(typeof({ static T t; })),
|
||||||
|
"Default constructor is disabled");
|
||||||
|
}
|
||||||
|
else static if (is(typeof(T(args))))
|
||||||
|
{
|
||||||
|
*result = T(args);
|
||||||
|
}
|
||||||
|
else static if (is(typeof(result.__ctor(args))))
|
||||||
|
{
|
||||||
|
result.__ctor(args);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false,
|
||||||
|
"Unable to construct value with the given arguments");
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[4] memory;
|
||||||
|
|
||||||
|
auto i = emplace!int(memory);
|
||||||
|
static assert(is(typeof(i) == int*));
|
||||||
|
assert(*i == 0);
|
||||||
|
|
||||||
|
i = emplace!int(memory, 5);
|
||||||
|
assert(*i == 5);
|
||||||
|
|
||||||
|
static struct S
|
||||||
|
{
|
||||||
|
int i;
|
||||||
|
@disable this();
|
||||||
|
@disable this(this);
|
||||||
|
this(int i) @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
this.i = i;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
auto s = emplace!S(memory, 8);
|
||||||
|
static assert(is(typeof(s) == S*));
|
||||||
|
assert(s.i == 8);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Handles "Cannot access frame pointer" error.
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
struct F
|
||||||
|
{
|
||||||
|
~this() @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static assert(is(typeof(emplace!F((void[]).init))));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Thrown if a type conversion fails.
|
||||||
|
*/
|
||||||
|
final class ConvException : Exception
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* msg = The message for the exception.
|
||||||
|
* file = The file where the exception occurred.
|
||||||
|
* line = The line number where the exception occurred.
|
||||||
|
* next = The previous exception in the chain of exceptions, if any.
|
||||||
|
*/
|
||||||
|
this(string msg,
|
||||||
|
string file = __FILE__,
|
||||||
|
size_t line = __LINE__,
|
||||||
|
Throwable next = null) @nogc @safe pure nothrow
|
||||||
|
{
|
||||||
|
super(msg, file, line, next);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If the source type $(D_PARAM From) and the target type $(D_PARAM To) are
|
||||||
|
* equal, does nothing. If $(D_PARAM From) can be implicitly converted to
|
||||||
|
* $(D_PARAM To), just returns $(D_PARAM from).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* To = Target type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from).
|
||||||
|
*/
|
||||||
|
template to(To)
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* from = Source value.
|
||||||
|
*/
|
||||||
|
ref To to(From)(ref From from)
|
||||||
|
if (is(To == From))
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
To to(From)(From from)
|
||||||
|
if (is(Unqual!To == Unqual!From) || (isNumeric!From && isFloatingPoint!To))
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
auto val = 5.to!int();
|
||||||
|
assert(val == 5);
|
||||||
|
static assert(is(typeof(val) == int));
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
int val = 5;
|
||||||
|
assert(val.to!int() == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Performs checked conversion from an integral type $(D_PARAM From) to an
|
||||||
|
* integral type $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from) converted to $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if $(D_PARAM from) is too small or too
|
||||||
|
* large to be represented by $(D_PARAM To).
|
||||||
|
*/
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isIntegral!From
|
||||||
|
&& isIntegral!To
|
||||||
|
&& !is(Unqual!To == Unqual!From)
|
||||||
|
&& !is(To == enum))
|
||||||
|
{
|
||||||
|
static if ((isUnsigned!From && isSigned!To && From.sizeof == To.sizeof)
|
||||||
|
|| From.sizeof > To.sizeof)
|
||||||
|
{
|
||||||
|
if (from > To.max)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Positive integer overflow");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static if (isSigned!From)
|
||||||
|
{
|
||||||
|
static if (isUnsigned!To)
|
||||||
|
{
|
||||||
|
if (from < 0)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative integer overflow");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else static if (From.sizeof > To.sizeof)
|
||||||
|
{
|
||||||
|
if (from < To.min)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative integer overflow");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static if (From.sizeof <= To.sizeof)
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
else static if (isSigned!To)
|
||||||
|
{
|
||||||
|
return cast(To) from;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return from & To.max;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
// ubyte -> ushort
|
||||||
|
assert((cast(ubyte) 0).to!ushort == 0);
|
||||||
|
assert((cast(ubyte) 1).to!ushort == 1);
|
||||||
|
assert((cast(ubyte) (ubyte.max - 1)).to!ushort == ubyte.max - 1);
|
||||||
|
assert((cast(ubyte) ubyte.max).to!ushort == ubyte.max);
|
||||||
|
|
||||||
|
// ubyte -> short
|
||||||
|
assert((cast(ubyte) 0).to!short == 0);
|
||||||
|
assert((cast(ubyte) 1).to!short == 1);
|
||||||
|
assert((cast(ubyte) (ubyte.max - 1)).to!short == ubyte.max - 1);
|
||||||
|
assert((cast(ubyte) ubyte.max).to!short == ubyte.max);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
// ubyte <- ushort
|
||||||
|
assert((cast(ushort) 0).to!ubyte == 0);
|
||||||
|
assert((cast(ushort) 1).to!ubyte == 1);
|
||||||
|
assert((cast(ushort) (ubyte.max - 1)).to!ubyte == ubyte.max - 1);
|
||||||
|
assert((cast(ushort) ubyte.max).to!ubyte == ubyte.max);
|
||||||
|
|
||||||
|
// ubyte <- short
|
||||||
|
assert((cast(short) 0).to!ubyte == 0);
|
||||||
|
assert((cast(short) 1).to!ubyte == 1);
|
||||||
|
assert((cast(short) (ubyte.max - 1)).to!ubyte == ubyte.max - 1);
|
||||||
|
assert((cast(short) ubyte.max).to!ubyte == ubyte.max);
|
||||||
|
|
||||||
|
// short <-> int
|
||||||
|
assert(short.min.to!int == short.min);
|
||||||
|
assert((short.min + 1).to!int == short.min + 1);
|
||||||
|
assert((cast(short) -1).to!int == -1);
|
||||||
|
assert((cast(short) 0).to!int == 0);
|
||||||
|
assert((cast(short) 1).to!int == 1);
|
||||||
|
assert((short.max - 1).to!int == short.max - 1);
|
||||||
|
assert(short.max.to!int == short.max);
|
||||||
|
|
||||||
|
assert((cast(int) short.min).to!short == short.min);
|
||||||
|
assert((cast(int) short.min + 1).to!short == short.min + 1);
|
||||||
|
assert((cast(int) -1).to!short == -1);
|
||||||
|
assert((cast(int) 0).to!short == 0);
|
||||||
|
assert((cast(int) 1).to!short == 1);
|
||||||
|
assert((cast(int) short.max - 1).to!short == short.max - 1);
|
||||||
|
assert((cast(int) short.max).to!short == short.max);
|
||||||
|
|
||||||
|
// uint <-> int
|
||||||
|
assert((cast(uint) 0).to!int == 0);
|
||||||
|
assert((cast(uint) 1).to!int == 1);
|
||||||
|
assert((cast(uint) (int.max - 1)).to!int == int.max - 1);
|
||||||
|
assert((cast(uint) int.max).to!int == int.max);
|
||||||
|
|
||||||
|
assert((cast(int) 0).to!uint == 0);
|
||||||
|
assert((cast(int) 1).to!uint == 1);
|
||||||
|
assert((cast(int) (int.max - 1)).to!uint == int.max - 1);
|
||||||
|
assert((cast(int) int.max).to!uint == int.max);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assertThrown!ConvException(&to!(short, int), int.min);
|
||||||
|
assertThrown!ConvException(&to!(short, int), int.max);
|
||||||
|
assertThrown!ConvException(&to!(ushort, uint), uint.max);
|
||||||
|
assertThrown!ConvException(&to!(uint, int), -1);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
enum Test : int
|
||||||
|
{
|
||||||
|
one,
|
||||||
|
two,
|
||||||
|
}
|
||||||
|
assert(Test.one.to!int == 0);
|
||||||
|
assert(Test.two.to!int == 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts a floating point number to an integral type.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: Truncated $(D_PARAM from) (everything after the decimal point is
|
||||||
|
* dropped).
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if
|
||||||
|
* $(D_INLINECODE from < To.min || from > To.max).
|
||||||
|
*/
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isFloatingPoint!From
|
||||||
|
&& isIntegral!To
|
||||||
|
&& !is(Unqual!To == Unqual!From)
|
||||||
|
&& !is(To == enum))
|
||||||
|
{
|
||||||
|
if (from > To.max)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Positive number overflow");
|
||||||
|
}
|
||||||
|
else if (from < To.min)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative number overflow");
|
||||||
|
}
|
||||||
|
return cast(To) from;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(1.5.to!int == 1);
|
||||||
|
assert(2147483646.5.to!int == 2147483646);
|
||||||
|
assert((-2147483647.5).to!int == -2147483647);
|
||||||
|
assert(2147483646.5.to!uint == 2147483646);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assertThrown!ConvException(&to!(int, double), 2147483647.5);
|
||||||
|
assertThrown!ConvException(&to!(int, double), -2147483648.5);
|
||||||
|
assertThrown!ConvException(&to!(uint, double), -21474.5);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Performs checked conversion from an integral type $(D_PARAM From) to an
|
||||||
|
* $(D_KEYWORD enum).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD enum) value.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if $(D_PARAM from) is not a member of
|
||||||
|
* $(D_PSYMBOL To).
|
||||||
|
*/
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isIntegral!From && is(To == enum))
|
||||||
|
{
|
||||||
|
foreach (m; EnumMembers!To)
|
||||||
|
{
|
||||||
|
if (from == m)
|
||||||
|
{
|
||||||
|
return m;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Value not found in enum '" ~ To.stringof ~ "'");
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
enum Test : int
|
||||||
|
{
|
||||||
|
one,
|
||||||
|
two,
|
||||||
|
}
|
||||||
|
static assert(is(typeof(1.to!Test) == Test));
|
||||||
|
assert(0.to!Test == Test.one);
|
||||||
|
assert(1.to!Test == Test.two);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
enum Test : uint
|
||||||
|
{
|
||||||
|
one,
|
||||||
|
two,
|
||||||
|
}
|
||||||
|
assertThrown!ConvException(&to!(Test, int), 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts $(D_PARAM from) to a boolean.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM From) is a numeric type, then `1` becomes $(D_KEYWORD true),
|
||||||
|
* `0` $(D_KEYWORD false). Otherwise $(D_PSYMBOL ConvException) is thrown.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM To) is a string (built-in string or $(D_PSYMBOL String)),
|
||||||
|
* then `"true"` or `"false"` are converted to the appropriate boolean value.
|
||||||
|
* Otherwise $(D_PSYMBOL ConvException) is thrown.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD from) converted to a boolean.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if $(D_PARAM from) isn't convertible.
|
||||||
|
*/
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isNumeric!From && is(Unqual!To == bool) && !is(Unqual!To == Unqual!From))
|
||||||
|
{
|
||||||
|
if (from == 0)
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
else if (from < 0)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative number overflow");
|
||||||
|
}
|
||||||
|
else if (from <= 1)
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Positive number overflow");
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(!0.0.to!bool);
|
||||||
|
assert(0.2.to!bool);
|
||||||
|
assert(0.5.to!bool);
|
||||||
|
assert(1.0.to!bool);
|
||||||
|
|
||||||
|
assert(!0.to!bool);
|
||||||
|
assert(1.to!bool);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assertThrown!ConvException(&to!(bool, int), -1);
|
||||||
|
assertThrown!ConvException(&to!(bool, int), 2);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
To to(To, From)(auto ref const From from)
|
||||||
|
if ((is(From == String) || isSomeString!From) && is(Unqual!To == bool))
|
||||||
|
{
|
||||||
|
if (from == "true")
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
else if (from == "false")
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"String doesn't contain a boolean value");
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assert("true".to!bool);
|
||||||
|
assert(!"false".to!bool);
|
||||||
|
assert(String("true").to!bool);
|
||||||
|
assert(!String("false").to!bool);
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @safe unittest
|
||||||
|
{
|
||||||
|
assertThrown!ConvException(() => "1".to!bool);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts a boolean to $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* If $(D_PARAM To) is a numeric type, then $(D_KEYWORD true) becomes `1`,
|
||||||
|
* $(D_KEYWORD false) `0`.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM To) is a $(D_PSYMBOL String), then `"true"` or `"false"`
|
||||||
|
* is returned.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from) converted to $(D_PARAM To).
|
||||||
|
*/
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (is(Unqual!From == bool) && isNumeric!To && !is(Unqual!To == Unqual!From))
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(true.to!float == 1.0);
|
||||||
|
assert(true.to!double == 1.0);
|
||||||
|
assert(true.to!ubyte == 1);
|
||||||
|
assert(true.to!byte == 1);
|
||||||
|
assert(true.to!ushort == 1);
|
||||||
|
assert(true.to!short == 1);
|
||||||
|
assert(true.to!uint == 1);
|
||||||
|
assert(true.to!int == 1);
|
||||||
|
|
||||||
|
assert(false.to!float == 0);
|
||||||
|
assert(false.to!double == 0);
|
||||||
|
assert(false.to!ubyte == 0);
|
||||||
|
assert(false.to!byte == 0);
|
||||||
|
assert(false.to!ushort == 0);
|
||||||
|
assert(false.to!short == 0);
|
||||||
|
assert(false.to!uint == 0);
|
||||||
|
assert(false.to!int == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts $(D_PARAM From) to a $(D_PSYMBOL String).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from) converted to $(D_PSYMBOL String).
|
||||||
|
*/
|
||||||
|
To to(To, From)(auto ref From from)
|
||||||
|
if (is(Unqual!To == String))
|
||||||
|
{
|
||||||
|
return format!"{}"(from);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(true.to!String == "true");
|
||||||
|
assert(false.to!String == "false");
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(typeof((const String("true")).to!bool)));
|
||||||
|
static assert(is(typeof(false.to!(const String) == "false")));
|
||||||
|
}
|
501
source/tanya/encoding/ascii.d
Normal file
501
source/tanya/encoding/ascii.d
Normal file
@ -0,0 +1,501 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Functions operating on ASCII characters.
|
||||||
|
*
|
||||||
|
* ASCII is $(B A)merican $(B S)tandard $(B C)ode for $(B I)nformation
|
||||||
|
* $(B I)nterchange.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/encoding/ascii.d,
|
||||||
|
* tanya/encoding/ascii.d)
|
||||||
|
*/
|
||||||
|
module tanya.encoding.ascii;
|
||||||
|
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
|
const string fullHexDigits = "0123456789ABCDEFabcdef"; /// 0..9A..Fa..f.
|
||||||
|
const string hexDigits = "0123456789ABCDEF"; /// 0..9A..F.
|
||||||
|
const string lowerHexDigits = "0123456789abcdef"; /// 0..9a..f.
|
||||||
|
const string digits = "0123456789"; /// 0..9.
|
||||||
|
const string octalDigits = "01234567"; /// 0..7.
|
||||||
|
|
||||||
|
/// A..Za..z.
|
||||||
|
const string letters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
|
||||||
|
|
||||||
|
const string uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"; /// A..Z.
|
||||||
|
const string lowercase = "abcdefghijklmnopqrstuvwxyz"; /// a..z.
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whitespace, Horizontal Tab (HT), Line Feed (LF), Carriage Return (CR),
|
||||||
|
* Vertical Tab (VT) or Form Feed (FF).
|
||||||
|
*/
|
||||||
|
const string whitespace = "\t\n\v\f\r ";
|
||||||
|
|
||||||
|
/// Letter case specifier.
|
||||||
|
enum LetterCase : bool
|
||||||
|
{
|
||||||
|
upper, /// Uppercase.
|
||||||
|
lower, /// Lowercase.
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for an uppecase alphabetic character.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is an uppercase alphabetic
|
||||||
|
* character, $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isUpper(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c >= 'A') && (c <= 'Z');
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isUpper('A'));
|
||||||
|
assert(isUpper('Z'));
|
||||||
|
assert(isUpper('L'));
|
||||||
|
assert(!isUpper('a'));
|
||||||
|
assert(!isUpper('!'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a lowercase alphabetic character.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a lowercase alphabetic
|
||||||
|
* character, $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isLower(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c >= 'a') && (c <= 'z');
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isLower('a'));
|
||||||
|
assert(isLower('z'));
|
||||||
|
assert(isLower('l'));
|
||||||
|
assert(!isLower('A'));
|
||||||
|
assert(!isLower('!'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for an alphabetic character (upper- or lowercase).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is an alphabetic character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isAlpha(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return isUpper(c) || isLower(c);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isAlpha('A'));
|
||||||
|
assert(isAlpha('Z'));
|
||||||
|
assert(isAlpha('L'));
|
||||||
|
assert(isAlpha('a'));
|
||||||
|
assert(isAlpha('z'));
|
||||||
|
assert(isAlpha('l'));
|
||||||
|
assert(!isAlpha('!'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a digit.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a digit,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isDigit(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c >= '0') && (c <= '9');
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isDigit('0'));
|
||||||
|
assert(isDigit('1'));
|
||||||
|
assert(isDigit('2'));
|
||||||
|
assert(isDigit('3'));
|
||||||
|
assert(isDigit('4'));
|
||||||
|
assert(isDigit('5'));
|
||||||
|
assert(isDigit('6'));
|
||||||
|
assert(isDigit('7'));
|
||||||
|
assert(isDigit('8'));
|
||||||
|
assert(isDigit('9'));
|
||||||
|
assert(!isDigit('a'));
|
||||||
|
assert(!isDigit('!'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for an alphabetic character (upper- or lowercase) or a digit.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is an alphabetic character or a
|
||||||
|
* digit, $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isAlphaNum(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return isAlpha(c) || isDigit(c);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isAlphaNum('0'));
|
||||||
|
assert(isAlphaNum('1'));
|
||||||
|
assert(isAlphaNum('9'));
|
||||||
|
assert(isAlphaNum('A'));
|
||||||
|
assert(isAlphaNum('Z'));
|
||||||
|
assert(isAlphaNum('L'));
|
||||||
|
assert(isAlphaNum('a'));
|
||||||
|
assert(isAlphaNum('z'));
|
||||||
|
assert(isAlphaNum('l'));
|
||||||
|
assert(!isAlphaNum('!'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a 7-bit ASCII character.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is an ASCII character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isASCII(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return c < 128;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isASCII('0'));
|
||||||
|
assert(isASCII('L'));
|
||||||
|
assert(isASCII('l'));
|
||||||
|
assert(isASCII('!'));
|
||||||
|
assert(!isASCII('©'));
|
||||||
|
assert(!isASCII('§'));
|
||||||
|
assert(!isASCII(char.init)); // 0xFF
|
||||||
|
assert(!isASCII(wchar.init)); // 0xFFFF
|
||||||
|
assert(!isASCII(dchar.init)); // 0xFFFF
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a control character.
|
||||||
|
*
|
||||||
|
* Control characters are non-printable characters. Their ASCII codes are those
|
||||||
|
* between 0x00 (NUL) and 0x1f (US), and 0x7f (DEL).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a control character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isPrintable), $(D_PSYMBOL isGraphical).
|
||||||
|
*/
|
||||||
|
bool isControl(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c <= 0x1f) || (c == 0x7f);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isControl('\t'));
|
||||||
|
assert(isControl('\0'));
|
||||||
|
assert(isControl('\u007f'));
|
||||||
|
assert(!isControl(' '));
|
||||||
|
assert(!isControl('a'));
|
||||||
|
assert(!isControl(char.init)); // 0xFF
|
||||||
|
assert(!isControl(wchar.init)); // 0xFFFF
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a whitespace character.
|
||||||
|
*
|
||||||
|
* Whitespace characters are:
|
||||||
|
*
|
||||||
|
* $(UL
|
||||||
|
* $(LI Whitespace)
|
||||||
|
* $(LI Horizontal Tab (HT))
|
||||||
|
* $(LI Line Feed (LF))
|
||||||
|
* $(LI Carriage Return (CR))
|
||||||
|
* $(LI Vertical Tab (VT))
|
||||||
|
* $(LI Form Feed (FF))
|
||||||
|
* )
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a whitespace character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL whitespace).
|
||||||
|
*/
|
||||||
|
bool isWhite(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return ((c >= 0x09) && (c <= 0x0d)) || (c == 0x20);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isWhite('\t'));
|
||||||
|
assert(isWhite('\n'));
|
||||||
|
assert(isWhite('\v'));
|
||||||
|
assert(isWhite('\f'));
|
||||||
|
assert(isWhite('\r'));
|
||||||
|
assert(isWhite(' '));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a graphical character.
|
||||||
|
*
|
||||||
|
* Graphical characters are printable characters but whitespace characters.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a control character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isControl), $(D_PSYMBOL isWhite).
|
||||||
|
*/
|
||||||
|
bool isGraphical(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c > 0x20) && (c < 0x7f);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isGraphical('a'));
|
||||||
|
assert(isGraphical('0'));
|
||||||
|
assert(!isGraphical('\u007f'));
|
||||||
|
assert(!isGraphical('§'));
|
||||||
|
assert(!isGraphical('\n'));
|
||||||
|
assert(!isGraphical(' '));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a printable character.
|
||||||
|
*
|
||||||
|
* This is the opposite of a control character.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a control character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isControl).
|
||||||
|
*/
|
||||||
|
bool isPrintable(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c >= 0x20) && (c < 0x7f);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isPrintable('a'));
|
||||||
|
assert(isPrintable('0'));
|
||||||
|
assert(!isPrintable('\u007f'));
|
||||||
|
assert(!isPrintable('§'));
|
||||||
|
assert(!isPrintable('\n'));
|
||||||
|
assert(isPrintable(' '));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a hexadecimal digit.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a hexadecimal digit,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isHexDigit(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return ((c >= '0') && (c <= '9'))
|
||||||
|
|| ((c >= 'a') && (c <= 'f'))
|
||||||
|
|| ((c >= 'A') && (c <= 'F'));
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isHexDigit('0'));
|
||||||
|
assert(isHexDigit('1'));
|
||||||
|
assert(isHexDigit('8'));
|
||||||
|
assert(isHexDigit('9'));
|
||||||
|
assert(isHexDigit('A'));
|
||||||
|
assert(isHexDigit('F'));
|
||||||
|
assert(!isHexDigit('G'));
|
||||||
|
assert(isHexDigit('a'));
|
||||||
|
assert(isHexDigit('f'));
|
||||||
|
assert(!isHexDigit('g'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for an octal character.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is an octal character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isOctalDigit(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return (c >= '0') && (c <= '7');
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isOctalDigit('0'));
|
||||||
|
assert(isOctalDigit('1'));
|
||||||
|
assert(isOctalDigit('2'));
|
||||||
|
assert(isOctalDigit('3'));
|
||||||
|
assert(isOctalDigit('4'));
|
||||||
|
assert(isOctalDigit('5'));
|
||||||
|
assert(isOctalDigit('6'));
|
||||||
|
assert(isOctalDigit('7'));
|
||||||
|
assert(!isOctalDigit('8'));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks for a octal character.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM c) is a octal character,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isPunctuation(C)(C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return ((c >= 0x21) && (c <= 0x2f))
|
||||||
|
|| ((c >= 0x3a) && (c <= 0x40))
|
||||||
|
|| ((c >= 0x5b) && (c <= 0x60))
|
||||||
|
|| ((c >= 0x7b) && (c <= 0x7e));
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(isPunctuation('!'));
|
||||||
|
assert(isPunctuation(':'));
|
||||||
|
assert(isPunctuation('\\'));
|
||||||
|
assert(isPunctuation('|'));
|
||||||
|
assert(!isPunctuation('0'));
|
||||||
|
assert(!isPunctuation(' '));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts $(D_PARAM c) to uppercase.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM c) is not a lowercase character, $(D_PARAM c) is returned
|
||||||
|
* unchanged.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: The lowercase of $(D_PARAM c) if available, just $(D_PARAM c)
|
||||||
|
* otherwise.
|
||||||
|
*/
|
||||||
|
C toUpper(C)(const C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return isLower(c) ? (cast(C) (c - 32)) : c;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(toUpper('a') == 'A');
|
||||||
|
assert(toUpper('A') == 'A');
|
||||||
|
assert(toUpper('!') == '!');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts $(D_PARAM c) to lowercase.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM c) is not an uppercase character, $(D_PARAM c) is returned
|
||||||
|
* unchanged.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* C = Some character type.
|
||||||
|
* c = Some character.
|
||||||
|
*
|
||||||
|
* Returns: The uppercase of $(D_PARAM c) if available, just $(D_PARAM c)
|
||||||
|
* otherwise.
|
||||||
|
*/
|
||||||
|
C toLower(C)(const C c)
|
||||||
|
if (isSomeChar!C)
|
||||||
|
{
|
||||||
|
return isUpper(c) ? (cast(C) (c + 32)) : c;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
assert(toLower('A') == 'a');
|
||||||
|
assert(toLower('a') == 'a');
|
||||||
|
assert(toLower('!') == '!');
|
||||||
|
}
|
17
source/tanya/encoding/package.d
Normal file
17
source/tanya/encoding/package.d
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This package provides tools to work with text encodings.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/encoding/package.d,
|
||||||
|
* tanya/encoding/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.encoding;
|
||||||
|
|
||||||
|
public import tanya.encoding.ascii;
|
66
source/tanya/exception.d
Normal file
66
source/tanya/exception.d
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Common exceptions and errors.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/exception.d,
|
||||||
|
* tanya/exception.d)
|
||||||
|
*/
|
||||||
|
module tanya.exception;
|
||||||
|
|
||||||
|
import tanya.conv;
|
||||||
|
import tanya.memory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Error thrown if memory allocation fails.
|
||||||
|
*/
|
||||||
|
final class OutOfMemoryError : Error
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Constructs new error.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* msg = The message for the exception.
|
||||||
|
* file = The file where the exception occurred.
|
||||||
|
* line = The line number where the exception occurred.
|
||||||
|
* next = The previous exception in the chain of exceptions, if any.
|
||||||
|
*/
|
||||||
|
this(string msg = "Out of memory",
|
||||||
|
string file = __FILE__,
|
||||||
|
size_t line = __LINE__,
|
||||||
|
Throwable next = null) @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
super(msg, file, line, next);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
this(string msg,
|
||||||
|
Throwable next,
|
||||||
|
string file = __FILE__,
|
||||||
|
size_t line = __LINE__) @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
super(msg, file, line, next);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Allocates $(D_PSYMBOL OutOfMemoryError) in a static storage and throws it.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* msg = Custom error message.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL OutOfMemoryError).
|
||||||
|
*/
|
||||||
|
void onOutOfMemoryError(string msg = "Out of memory")
|
||||||
|
@nogc nothrow pure @trusted
|
||||||
|
{
|
||||||
|
static ubyte[stateSize!OutOfMemoryError] memory;
|
||||||
|
alias PureType = OutOfMemoryError function(string) @nogc nothrow pure;
|
||||||
|
throw (cast(PureType) () => emplace!OutOfMemoryError(memory))(msg);
|
||||||
|
}
|
293
source/tanya/format/conv.d
Normal file
293
source/tanya/format/conv.d
Normal file
@ -0,0 +1,293 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This module provides functions for converting between different types.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: Jeff Roberts, $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/format/conv.d,
|
||||||
|
* tanya/format/conv.d)
|
||||||
|
*/
|
||||||
|
module tanya.format.conv;
|
||||||
|
|
||||||
|
import tanya.container.string;
|
||||||
|
import tanya.memory;
|
||||||
|
import tanya.memory.op;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.meta.transform;
|
||||||
|
|
||||||
|
version (unittest)
|
||||||
|
{
|
||||||
|
import tanya.test.assertion;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Thrown if a type conversion fails.
|
||||||
|
*/
|
||||||
|
final class ConvException : Exception
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* msg = The message for the exception.
|
||||||
|
* file = The file where the exception occurred.
|
||||||
|
* line = The line number where the exception occurred.
|
||||||
|
* next = The previous exception in the chain of exceptions, if any.
|
||||||
|
*/
|
||||||
|
this(string msg,
|
||||||
|
string file = __FILE__,
|
||||||
|
size_t line = __LINE__,
|
||||||
|
Throwable next = null) @nogc @safe pure nothrow
|
||||||
|
{
|
||||||
|
super(msg, file, line, next);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If the source type $(D_PARAM From) and the target type $(D_PARAM To) are
|
||||||
|
* equal, does nothing. If $(D_PARAM From) can be implicitly converted to
|
||||||
|
* $(D_PARAM To), just returns $(D_PARAM from).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* To = Target type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from).
|
||||||
|
*/
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
template to(To)
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* from = Source value.
|
||||||
|
*/
|
||||||
|
ref To to(From)(ref From from)
|
||||||
|
if (is(To == From))
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
To to(From)(From from)
|
||||||
|
if (is(Unqual!To == Unqual!From) || (isNumeric!From && isFloatingPoint!To))
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Performs checked conversion from an integral type $(D_PARAM From) to an
|
||||||
|
* integral type $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from) converted to $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if $(D_PARAM from) is too small or too
|
||||||
|
* large to be represented by $(D_PARAM To).
|
||||||
|
*/
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isIntegral!From
|
||||||
|
&& isIntegral!To
|
||||||
|
&& !is(Unqual!To == Unqual!From)
|
||||||
|
&& !is(To == enum))
|
||||||
|
{
|
||||||
|
static if ((isUnsigned!From && isSigned!To && From.sizeof == To.sizeof)
|
||||||
|
|| From.sizeof > To.sizeof)
|
||||||
|
{
|
||||||
|
if (from > To.max)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Positive integer overflow");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static if (isSigned!From)
|
||||||
|
{
|
||||||
|
static if (isUnsigned!To)
|
||||||
|
{
|
||||||
|
if (from < 0)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative integer overflow");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else static if (From.sizeof > To.sizeof)
|
||||||
|
{
|
||||||
|
if (from < To.min)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative integer overflow");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static if (From.sizeof <= To.sizeof)
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
else static if (isSigned!To)
|
||||||
|
{
|
||||||
|
return cast(To) from;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return from & To.max;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts $(D_PARAM from) to a boolean.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM From) is a numeric type, then `1` becomes $(D_KEYWORD true),
|
||||||
|
* `0` $(D_KEYWORD false). Otherwise $(D_PSYMBOL ConvException) is thrown.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM To) is a string (built-in string or $(D_PSYMBOL String)),
|
||||||
|
* then `"true"` or `"false"` are converted to the appropriate boolean value.
|
||||||
|
* Otherwise $(D_PSYMBOL ConvException) is thrown.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD from) converted to a boolean.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if $(D_PARAM from) isn't convertible.
|
||||||
|
*/
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isNumeric!From && is(Unqual!To == bool) && !is(Unqual!To == Unqual!From))
|
||||||
|
{
|
||||||
|
if (from == 0)
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
else if (from < 0)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative number overflow");
|
||||||
|
}
|
||||||
|
else if (from <= 1)
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Positive number overflow");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(auto ref const From from)
|
||||||
|
if ((is(From == String) || isSomeString!From) && is(Unqual!To == bool))
|
||||||
|
{
|
||||||
|
if (from == "true")
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
else if (from == "false")
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"String doesn't contain a boolean value");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts a boolean to $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* If $(D_PARAM To) is a numeric type, then $(D_KEYWORD true) becomes `1`,
|
||||||
|
* $(D_KEYWORD false) `0`.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM To) is a $(D_PSYMBOL String), then `"true"` or `"false"`
|
||||||
|
* is returned.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM from) converted to $(D_PARAM To).
|
||||||
|
*/
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(const From from)
|
||||||
|
if (is(Unqual!From == bool) && isNumeric!To && !is(Unqual!To == Unqual!From))
|
||||||
|
{
|
||||||
|
return from;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(const From from)
|
||||||
|
if (is(Unqual!From == bool) && is(Unqual!To == String))
|
||||||
|
{
|
||||||
|
return String(from ? "true" : "false");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts a floating point number to an integral type.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: Truncated $(D_PARAM from) (everything after the decimal point is
|
||||||
|
* dropped).
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if
|
||||||
|
* $(D_INLINECODE from < To.min || from > To.max).
|
||||||
|
*/
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isFloatingPoint!From
|
||||||
|
&& isIntegral!To
|
||||||
|
&& !is(Unqual!To == Unqual!From)
|
||||||
|
&& !is(To == enum))
|
||||||
|
{
|
||||||
|
if (from > To.max)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Positive number overflow");
|
||||||
|
}
|
||||||
|
else if (from < To.min)
|
||||||
|
{
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Negative number overflow");
|
||||||
|
}
|
||||||
|
return cast(To) from;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Performs checked conversion from an integral type $(D_PARAM From) to an
|
||||||
|
* $(D_KEYWORD enum).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
* from = Source value.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD enum) value.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL ConvException) if $(D_PARAM from) is not a member of
|
||||||
|
* $(D_PSYMBOL To).
|
||||||
|
*/
|
||||||
|
deprecated("Use tanya.conv.to instead")
|
||||||
|
To to(To, From)(From from)
|
||||||
|
if (isIntegral!From && is(To == enum))
|
||||||
|
{
|
||||||
|
foreach (m; EnumMembers!To)
|
||||||
|
{
|
||||||
|
if (from == m)
|
||||||
|
{
|
||||||
|
return m;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw make!ConvException(defaultAllocator,
|
||||||
|
"Value not found in enum '" ~ To.stringof ~ "'");
|
||||||
|
}
|
1031
source/tanya/format/package.d
Normal file
1031
source/tanya/format/package.d
Normal file
File diff suppressed because it is too large
Load Diff
@ -9,15 +9,21 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/math/mp.d,
|
||||||
|
* tanya/math/mp.d)
|
||||||
*/
|
*/
|
||||||
module tanya.math.mp;
|
module tanya.math.mp;
|
||||||
|
|
||||||
import std.algorithm;
|
import std.algorithm.comparison;
|
||||||
import std.ascii;
|
import std.algorithm.mutation : copy, fill, reverse;
|
||||||
import std.range;
|
import std.range;
|
||||||
import std.traits;
|
import tanya.algorithm.mutation;
|
||||||
import tanya.container.vector;
|
import tanya.container.array;
|
||||||
|
import tanya.encoding.ascii;
|
||||||
import tanya.memory;
|
import tanya.memory;
|
||||||
|
static import tanya.memory.op;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.meta.transform;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Algebraic sign.
|
* Algebraic sign.
|
||||||
@ -72,7 +78,7 @@ struct Integer
|
|||||||
this = value;
|
this = value;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
this(T)(ref T value, shared Allocator allocator = defaultAllocator)
|
this(T)(ref T value, shared Allocator allocator = defaultAllocator)
|
||||||
if (is(Unqual!T == Integer))
|
if (is(Unqual!T == Integer))
|
||||||
{
|
{
|
||||||
@ -80,9 +86,8 @@ struct Integer
|
|||||||
this = value;
|
this = value;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
this(T)(T value, shared Allocator allocator = defaultAllocator)
|
this(T)(T value, shared Allocator allocator = defaultAllocator)
|
||||||
nothrow @safe @nogc
|
|
||||||
if (is(T == Integer))
|
if (is(T == Integer))
|
||||||
{
|
{
|
||||||
this(allocator);
|
this(allocator);
|
||||||
@ -101,8 +106,8 @@ struct Integer
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
this(shared Allocator allocator) pure nothrow @safe @nogc
|
this(shared Allocator allocator) @nogc nothrow pure @safe
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(allocator !is null);
|
assert(allocator !is null);
|
||||||
@ -153,37 +158,141 @@ struct Integer
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
nothrow @safe @nogc unittest
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
ubyte[8] range = [ 0x66, 0x77, 0x88, 0x99, 0xaa, 0xbb, 0xdd, 0xee ];
|
ubyte[8] range = [ 0x66, 0x77, 0x88, 0x99, 0xaa, 0xbb, 0xdd, 0xee ];
|
||||||
auto integer = Integer(Sign.positive, range[]);
|
auto integer = Integer(Sign.positive, range[]);
|
||||||
assert(integer == 7383520307673030126);
|
assert(integer == 7383520307673030126);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs the integer from a two's complement representation.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* R = Range type.
|
||||||
|
* value = Range.
|
||||||
|
* allocator = Allocator.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
this(R)(R value, shared Allocator allocator = defaultAllocator)
|
||||||
|
if (isBidirectionalRange!R && hasLength!R
|
||||||
|
&& is(Unqual!(ElementType!R) == ubyte))
|
||||||
|
{
|
||||||
|
this(Sign.positive, value, allocator);
|
||||||
|
|
||||||
|
if (!value.empty && ((value.front & 0x80) != 0))
|
||||||
|
{
|
||||||
|
// Negative number.
|
||||||
|
opOpAssign!"-"(exp2(countBits()));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
ubyte[8] range = [ 0x66, 0x77, 0x88, 0x99, 0xaa, 0xbb, 0xdd, 0xee ];
|
||||||
|
auto integer = Integer(range[]);
|
||||||
|
assert(integer == 7383520307673030126);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
ubyte[8] range = [ 0xe6, 0x77, 0x88, 0x99, 0xaa, 0xbb, 0xdd, 0xee ];
|
||||||
|
auto integer = Integer(range[]);
|
||||||
|
assert(integer == -1839851729181745682);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Copies the integer.
|
* Copies the integer.
|
||||||
*/
|
*/
|
||||||
this(this) nothrow @trusted @nogc
|
this(this) @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
auto tmp = allocator.resize!digit(null, this.size);
|
auto tmp = allocator.resize!digit(null, this.size);
|
||||||
this.rep[0 .. this.size].copy(tmp);
|
tanya.memory.op.copy(this.rep[0 .. this.size], tmp);
|
||||||
this.rep = tmp;
|
this.rep = tmp;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Destroys the integer.
|
* Destroys the integer.
|
||||||
*/
|
*/
|
||||||
~this() nothrow @trusted @nogc
|
~this() @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
allocator.resize(this.rep, 0);
|
allocator.resize(this.rep, 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
static private const short[16] bitCounts = [
|
||||||
* Returns: Integer byte length.
|
4, 0, 1, 0, 2, 0, 1, 0, 3, 0, 1, 0, 2, 0, 1, 0
|
||||||
*/
|
];
|
||||||
@property size_t length() const pure nothrow @safe @nogc
|
|
||||||
|
// Counts the number of LSBs before the first non-zero bit.
|
||||||
|
private ptrdiff_t countLSBs() const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
return (countBits() + 7) / 8; // Round up.
|
if (this.size == 0)
|
||||||
|
{
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
ptrdiff_t bits;
|
||||||
|
for (bits = 0; (bits < this.size) && (this.rep[bits] == 0); ++bits)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
digit nonZero = this.rep[bits];
|
||||||
|
bits *= digitBitCount;
|
||||||
|
|
||||||
|
/* now scan this digit until a 1 is found */
|
||||||
|
if ((nonZero & 0x01) == 0)
|
||||||
|
{
|
||||||
|
digit bitCountsPos;
|
||||||
|
do
|
||||||
|
{
|
||||||
|
bitCountsPos = nonZero & 0x0f;
|
||||||
|
bits += bitCounts[bitCountsPos];
|
||||||
|
nonZero >>= 4;
|
||||||
|
}
|
||||||
|
while (bitCountsPos == 0);
|
||||||
|
}
|
||||||
|
return bits;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Number of bytes in the two's complement representation.
|
||||||
|
*/
|
||||||
|
@property size_t length() const @nogc nothrow pure @safe
|
||||||
|
{
|
||||||
|
if (this.sign)
|
||||||
|
{
|
||||||
|
const bc = countBits();
|
||||||
|
auto length = bc + (8 - (bc & 0x07));
|
||||||
|
|
||||||
|
if (((countLSBs() + 1) == bc) && ((bc & 0x07) == 0))
|
||||||
|
{
|
||||||
|
--length;
|
||||||
|
}
|
||||||
|
return length / 8;
|
||||||
|
}
|
||||||
|
else if (this.size == 0)
|
||||||
|
{
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return (countBits() / 8) + 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
Integer i;
|
||||||
|
assert(i.length == 0);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto i = Integer(-123456789);
|
||||||
|
assert(i.length == 4);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -229,32 +338,27 @@ struct Integer
|
|||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opAssign(T)(ref T value) @trusted
|
ref Integer opAssign(T)(ref T value)
|
||||||
if (is(Unqual!T == Integer))
|
if (is(Unqual!T == Integer))
|
||||||
{
|
{
|
||||||
this.rep = allocator.resize(this.rep, value.size);
|
this.rep = allocator.resize(this.rep, value.size);
|
||||||
value.rep[0 .. value.size].copy(this.rep[0 .. value.size]);
|
tanya.memory.op.copy(value.rep[0 .. value.size],
|
||||||
|
this.rep[0 .. value.size]);
|
||||||
this.size = value.size;
|
this.size = value.size;
|
||||||
this.sign = value.sign;
|
this.sign = value.sign;
|
||||||
|
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opAssign(T)(T value) nothrow @safe @nogc
|
ref Integer opAssign(T)(T value)
|
||||||
if (is(T == Integer))
|
if (is(T == Integer))
|
||||||
{
|
|
||||||
if (this.allocator is value.allocator)
|
|
||||||
{
|
{
|
||||||
swap(this.rep, value.rep);
|
swap(this.rep, value.rep);
|
||||||
swap(this.sign, value.sign);
|
swap(this.sign, value.sign);
|
||||||
swap(this.size, value.size);
|
swap(this.size, value.size);
|
||||||
}
|
swap(this.allocator_, value.allocator_);
|
||||||
else
|
|
||||||
{
|
|
||||||
this = value;
|
|
||||||
}
|
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -271,7 +375,7 @@ struct Integer
|
|||||||
return this.size > 0;
|
return this.size > 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
T opCast(T)() const
|
T opCast(T)() const
|
||||||
if (isIntegral!T && isUnsigned!T)
|
if (isIntegral!T && isUnsigned!T)
|
||||||
{
|
{
|
||||||
@ -285,15 +389,17 @@ struct Integer
|
|||||||
return ret;
|
return ret;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
T opCast(T)() const
|
T opCast(T)() const
|
||||||
if (isIntegral!T && isSigned!T)
|
if (isIntegral!T && isSigned!T)
|
||||||
{
|
{
|
||||||
return this.sign ? -(cast(Unsigned!T) this) : cast(Unsigned!T) this;
|
return this.sign
|
||||||
|
? cast(T) -(cast(Promoted!(Unsigned!T)) (cast(Unsigned!T) this))
|
||||||
|
: cast(Unsigned!T) this;
|
||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
@safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto integer = Integer(79);
|
auto integer = Integer(79);
|
||||||
assert(cast(ushort) integer == 79);
|
assert(cast(ushort) integer == 79);
|
||||||
@ -317,14 +423,14 @@ struct Integer
|
|||||||
assert(cast(long) integer == 0);
|
assert(cast(long) integer == 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
/* trim unused digits
|
/* Trim unused digits.
|
||||||
*
|
*
|
||||||
* This is used to ensure that leading zero digits are
|
* This is used to ensure that leading zero digits are
|
||||||
* trimed and the leading "size" digit will be non-zero
|
* trimed and the leading "size" digit will be non-zero
|
||||||
* Typically very fast. Also fixes the sign if there
|
* Typically very fast. Also fixes the sign if there
|
||||||
* are no more leading digits
|
* are no more leading digits
|
||||||
*/
|
*/
|
||||||
void contract() nothrow @safe @nogc
|
void contract() @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
/* decrease size while the most significant digit is
|
/* decrease size while the most significant digit is
|
||||||
* zero.
|
* zero.
|
||||||
@ -341,7 +447,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private void grow(const size_t size) nothrow @trusted @nogc
|
private void grow(const size_t size) @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
if (this.rep.length >= size)
|
if (this.rep.length >= size)
|
||||||
{
|
{
|
||||||
@ -352,7 +458,7 @@ struct Integer
|
|||||||
this.rep[oldLength .. $].fill(digit.init);
|
this.rep[oldLength .. $].fill(digit.init);
|
||||||
}
|
}
|
||||||
|
|
||||||
private size_t countBits() const pure nothrow @safe @nogc
|
private size_t countBits() const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
if (this.size == 0)
|
if (this.size == 0)
|
||||||
{
|
{
|
||||||
@ -370,7 +476,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
private void add(ref const Integer summand, ref Integer sum)
|
private void add(ref const Integer summand, ref Integer sum)
|
||||||
const nothrow @safe @nogc
|
const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
const(digit)[] max, min;
|
const(digit)[] max, min;
|
||||||
|
|
||||||
@ -421,7 +527,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
private void add(const digit summand, ref Integer sum)
|
private void add(const digit summand, ref Integer sum)
|
||||||
const nothrow @safe @nogc
|
const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
sum.grow(this.size + 2);
|
sum.grow(this.size + 2);
|
||||||
|
|
||||||
@ -447,7 +553,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
private void subtract(ref const Integer subtrahend, ref Integer difference)
|
private void subtract(ref const Integer subtrahend, ref Integer difference)
|
||||||
const nothrow @safe @nogc
|
const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
difference.grow(this.size);
|
difference.grow(this.size);
|
||||||
|
|
||||||
@ -483,7 +589,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
private void subtract(const digit subtrahend, ref Integer difference)
|
private void subtract(const digit subtrahend, ref Integer difference)
|
||||||
const nothrow @safe @nogc
|
const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
difference.grow(this.size);
|
difference.grow(this.size);
|
||||||
|
|
||||||
@ -512,7 +618,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Compare the magnitude.
|
// Compare the magnitude.
|
||||||
private int compare(ref const Integer that) const pure nothrow @safe @nogc
|
private int compare(ref const Integer that) const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
if (this.size > that.size)
|
if (this.size > that.size)
|
||||||
{
|
{
|
||||||
@ -561,7 +667,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
@safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto integer1 = Integer(1019);
|
auto integer1 = Integer(1019);
|
||||||
auto integer2 = Integer(1019);
|
auto integer2 = Integer(1019);
|
||||||
@ -577,7 +683,7 @@ struct Integer
|
|||||||
assert(integer1 > integer2);
|
assert(integer1 > integer2);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
int opCmp(I)(const I that) const
|
int opCmp(I)(const I that) const
|
||||||
if (isIntegral!I)
|
if (isIntegral!I)
|
||||||
{
|
{
|
||||||
@ -607,7 +713,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
@safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto integer = Integer(1019);
|
auto integer = Integer(1019);
|
||||||
|
|
||||||
@ -631,7 +737,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
@safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto integer = Integer(1019);
|
auto integer = Integer(1019);
|
||||||
|
|
||||||
@ -667,7 +773,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
{
|
{
|
||||||
auto h1 = Integer(1019);
|
auto h1 = Integer(1019);
|
||||||
@ -689,7 +795,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opOpAssign(string op : "-")(auto ref const Integer operand)
|
ref Integer opOpAssign(string op : "-")(auto ref const Integer operand)
|
||||||
{
|
{
|
||||||
if (this.sign != operand.sign)
|
if (this.sign != operand.sign)
|
||||||
@ -709,7 +815,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
{
|
{
|
||||||
auto h1 = Integer(3);
|
auto h1 = Integer(3);
|
||||||
@ -737,7 +843,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opOpAssign(string op : "*")(auto ref const Integer operand)
|
ref Integer opOpAssign(string op : "*")(auto ref const Integer operand)
|
||||||
{
|
{
|
||||||
const digits = this.size + operand.size + 1;
|
const digits = this.size + operand.size + 1;
|
||||||
@ -753,7 +859,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto h1 = Integer(123);
|
auto h1 = Integer(123);
|
||||||
auto h2 = Integer(456);
|
auto h2 = Integer(456);
|
||||||
@ -761,7 +867,7 @@ struct Integer
|
|||||||
assert(h1 == 56088);
|
assert(h1 == 56088);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opOpAssign(string op : "/")(auto ref const Integer operand)
|
ref Integer opOpAssign(string op : "/")(auto ref const Integer operand)
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
@ -773,7 +879,7 @@ struct Integer
|
|||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opOpAssign(string op : "%")(auto ref const Integer operand)
|
ref Integer opOpAssign(string op : "%")(auto ref const Integer operand)
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
@ -785,7 +891,7 @@ struct Integer
|
|||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto h1 = Integer(18);
|
auto h1 = Integer(18);
|
||||||
auto h2 = Integer(4);
|
auto h2 = Integer(4);
|
||||||
@ -806,7 +912,7 @@ struct Integer
|
|||||||
assert(h1 == 123);
|
assert(h1 == 123);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opOpAssign(string op : ">>")(const size_t operand)
|
ref Integer opOpAssign(string op : ">>")(const size_t operand)
|
||||||
{
|
{
|
||||||
if (operand == 0)
|
if (operand == 0)
|
||||||
@ -837,7 +943,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto integer = Integer(4294967294);
|
auto integer = Integer(4294967294);
|
||||||
integer >>= 10;
|
integer >>= 10;
|
||||||
@ -868,7 +974,7 @@ struct Integer
|
|||||||
assert(integer == 0);
|
assert(integer == 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opOpAssign(string op : "<<")(const size_t operand)
|
ref Integer opOpAssign(string op : "<<")(const size_t operand)
|
||||||
{
|
{
|
||||||
const step = operand / digitBitCount;
|
const step = operand / digitBitCount;
|
||||||
@ -905,7 +1011,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto integer = Integer(4294967295);
|
auto integer = Integer(4294967295);
|
||||||
integer <<= 1;
|
integer <<= 1;
|
||||||
@ -923,11 +1029,14 @@ struct Integer
|
|||||||
Integer opUnary(string op : "~")() const
|
Integer opUnary(string op : "~")() const
|
||||||
{
|
{
|
||||||
auto ret = Integer(this, allocator);
|
auto ret = Integer(this, allocator);
|
||||||
ret.rep[0 .. ret.size].each!((ref a) => a = ~a & mask);
|
foreach (ref a; ret.rep[0 .. ret.size])
|
||||||
|
{
|
||||||
|
a = ~a & mask;
|
||||||
|
}
|
||||||
return ret;
|
return ret;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
Integer opUnary(string op : "-")() const
|
Integer opUnary(string op : "-")() const
|
||||||
{
|
{
|
||||||
auto ret = Integer(this, allocator);
|
auto ret = Integer(this, allocator);
|
||||||
@ -949,7 +1058,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
//
|
//
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
auto h1 = Integer(79);
|
auto h1 = Integer(79);
|
||||||
Integer h2;
|
Integer h2;
|
||||||
@ -965,10 +1074,10 @@ struct Integer
|
|||||||
assert(h1 == 79);
|
assert(h1 == 79);
|
||||||
|
|
||||||
h2 = ~h1;
|
h2 = ~h1;
|
||||||
assert(h2 == ~cast(ubyte) 79);
|
assert(h2 == cast(ubyte) ~79);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opUnary(string op : "++")()
|
ref Integer opUnary(string op : "++")()
|
||||||
{
|
{
|
||||||
if (this.sign)
|
if (this.sign)
|
||||||
@ -982,7 +1091,7 @@ struct Integer
|
|||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
ref Integer opUnary(string op : "--")()
|
ref Integer opUnary(string op : "--")()
|
||||||
{
|
{
|
||||||
if (this.size == 0)
|
if (this.size == 0)
|
||||||
@ -1002,7 +1111,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
Integer integer;
|
Integer integer;
|
||||||
|
|
||||||
@ -1052,7 +1161,7 @@ struct Integer
|
|||||||
mixin("return Integer(this, allocator) " ~ op ~ "= operand;");
|
mixin("return Integer(this, allocator) " ~ op ~ "= operand;");
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
Integer opBinary(string op)(const auto ref Integer operand) const
|
Integer opBinary(string op)(const auto ref Integer operand) const
|
||||||
if (op == "/" || op == "%")
|
if (op == "/" || op == "%")
|
||||||
in
|
in
|
||||||
@ -1064,7 +1173,7 @@ struct Integer
|
|||||||
mixin("return Integer(this, allocator) " ~ op ~ "= operand;");
|
mixin("return Integer(this, allocator) " ~ op ~ "= operand;");
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
Integer opBinary(string op)(const size_t operand) const
|
Integer opBinary(string op)(const size_t operand) const
|
||||||
if (op == "<<" || op == ">>")
|
if (op == "<<" || op == ">>")
|
||||||
{
|
{
|
||||||
@ -1072,7 +1181,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Shift right a certain amount of digits.
|
// Shift right a certain amount of digits.
|
||||||
private void shiftRight(const size_t operand) nothrow @safe @nogc
|
private void shiftRight(const size_t operand) @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
if (operand == 0)
|
if (operand == 0)
|
||||||
{
|
{
|
||||||
@ -1091,7 +1200,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Shift left a certain amount of digits.
|
// Shift left a certain amount of digits.
|
||||||
private void shiftLeft(const size_t operand) nothrow @safe @nogc
|
private void shiftLeft(const size_t operand) @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
if (operand == 0)
|
if (operand == 0)
|
||||||
{
|
{
|
||||||
@ -1113,7 +1222,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
|
|
||||||
private void multiply(const digit factor, ref Integer product)
|
private void multiply(const digit factor, ref Integer product)
|
||||||
const nothrow @safe @nogc
|
const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
product.grow(this.size + 1);
|
product.grow(this.size + 1);
|
||||||
product.sign = this.sign;
|
product.sign = this.sign;
|
||||||
@ -1139,7 +1248,7 @@ struct Integer
|
|||||||
|
|
||||||
private void multiply(ref const Integer factor,
|
private void multiply(ref const Integer factor,
|
||||||
ref Integer product,
|
ref Integer product,
|
||||||
const size_t digits) const nothrow @safe @nogc
|
const size_t digits) const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
Integer intermediate;
|
Integer intermediate;
|
||||||
intermediate.grow(digits);
|
intermediate.grow(digits);
|
||||||
@ -1170,8 +1279,7 @@ struct Integer
|
|||||||
|
|
||||||
private void divide(Q, ARGS...)(ref const Integer divisor,
|
private void divide(Q, ARGS...)(ref const Integer divisor,
|
||||||
auto ref Q quotient,
|
auto ref Q quotient,
|
||||||
ref ARGS args)
|
ref ARGS args) const
|
||||||
const nothrow @safe @nogc
|
|
||||||
if ((is(Q : typeof(null))
|
if ((is(Q : typeof(null))
|
||||||
|| (is(Q : Integer) && __traits(isRef, quotient)))
|
|| (is(Q : Integer) && __traits(isRef, quotient)))
|
||||||
&& (ARGS.length == 0 || (ARGS.length == 1 && is(ARGS[0] : Integer))))
|
&& (ARGS.length == 0 || (ARGS.length == 1 && is(ARGS[0] : Integer))))
|
||||||
@ -1304,7 +1412,7 @@ struct Integer
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private Integer square() nothrow @safe @nogc
|
private Integer square() @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
Integer result;
|
Integer result;
|
||||||
const resultSize = 2 * this.size + 1;
|
const resultSize = 2 * this.size + 1;
|
||||||
@ -1343,97 +1451,98 @@ struct Integer
|
|||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
Vector!ubyte toVector() const nothrow @safe @nogc
|
// Returns 2^^n.
|
||||||
|
private Integer exp2(size_t n) const @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
Vector!ubyte vector;
|
auto ret = Integer(allocator);
|
||||||
bool firstBit;
|
const bytes = n / digitBitCount;
|
||||||
ubyte carry;
|
|
||||||
|
ret.grow(bytes + 1);
|
||||||
|
ret.size = bytes + 1;
|
||||||
|
ret.rep[bytes] = (cast(digit) 1) << (n % digitBitCount);
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Two's complement representation of the integer.
|
||||||
|
*/
|
||||||
|
Array!ubyte toArray() const @nogc nothrow pure @safe
|
||||||
|
out (array)
|
||||||
|
{
|
||||||
|
assert(array.length == length);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
Array!ubyte array;
|
||||||
|
|
||||||
if (this.size == 0)
|
if (this.size == 0)
|
||||||
{
|
{
|
||||||
return vector;
|
return array;
|
||||||
}
|
}
|
||||||
vector.reserve(this.size * digit.sizeof);
|
const bc = countBits();
|
||||||
|
const remainingBits = bc & 0x07;
|
||||||
|
|
||||||
// The first digit needs extra handling since it can have leading
|
array.reserve(bc / 8);
|
||||||
// non significant zeros.
|
if (remainingBits == 0)
|
||||||
int digitCount = digitBitCount - 8;
|
{
|
||||||
const first = this.rep[this.size - 1];
|
array.insertBack(ubyte.init);
|
||||||
const prevBitCount = ((this.size - 1) * digitBitCount);
|
|
||||||
const fullBytesBitCount = ((prevBitCount - 1) / 8 + 1) * 8;
|
|
||||||
|
|
||||||
// Find out the right alignment of the first byte.
|
|
||||||
if ((fullBytesBitCount - prevBitCount) == 0)
|
|
||||||
{
|
|
||||||
digitCount -= digit.sizeof * 8 - digitBitCount;
|
|
||||||
}
|
}
|
||||||
for (; digitCount >= 0; digitCount -= 8)
|
|
||||||
|
Integer tmp;
|
||||||
|
if (this.sign)
|
||||||
{
|
{
|
||||||
if (firstBit || ((first >> digitCount) != 0))
|
auto length = bc + (8 - remainingBits);
|
||||||
|
|
||||||
|
if (((countLSBs() + 1) == bc) && (remainingBits == 0))
|
||||||
{
|
{
|
||||||
firstBit = true;
|
length -= 8;
|
||||||
vector.insertBack(cast(ubyte) (first >> digitCount));
|
|
||||||
}
|
}
|
||||||
}
|
|
||||||
if (digitCount >= -8)
|
tmp = exp2(length) + this;
|
||||||
{
|
|
||||||
carry = (first << -digitCount) & 0xff;
|
|
||||||
digitCount += digitBitCount;
|
|
||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
carry = 0;
|
tmp = this;
|
||||||
digitCount = digitBitCount - 8;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
foreach_reverse (d; this.rep[0 .. this.size - 1])
|
do
|
||||||
{
|
{
|
||||||
if (carry != 0) // Check the carry from the previous digit.
|
array.insertBack(cast(ubyte) (tmp.rep[0] & 0xff));
|
||||||
{
|
tmp >>= 8;
|
||||||
vector.insertBack(cast(ubyte) (carry | (d >> digitCount)));
|
|
||||||
digitCount -= 8;
|
|
||||||
}
|
|
||||||
// Write the digit by bytes.
|
|
||||||
for (; digitCount >= 0; digitCount -= 8)
|
|
||||||
{
|
|
||||||
vector.insertBack(cast(ubyte) (d >> digitCount));
|
|
||||||
}
|
|
||||||
// Check for an incomplete byte.
|
|
||||||
if (digitCount >= -8)
|
|
||||||
{
|
|
||||||
carry = (d << -digitCount) & 0xff;
|
|
||||||
digitCount += digitBitCount;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
carry = 0;
|
|
||||||
digitCount = digitBitCount - 8;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (carry != 0)
|
|
||||||
{
|
|
||||||
vector.insertBack(cast(ubyte) (carry >> (digitBitCount - digitCount)));
|
|
||||||
}
|
}
|
||||||
|
while (tmp != 0);
|
||||||
|
|
||||||
return vector;
|
array[].reverse();
|
||||||
|
|
||||||
|
return array;
|
||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
{
|
{
|
||||||
auto integer = Integer(0x66778899aabbddee);
|
auto integer = Integer(0x66778899aabbddee);
|
||||||
ubyte[8] expected = [ 0x66, 0x77, 0x88, 0x99, 0xaa, 0xbb, 0xdd, 0xee ];
|
ubyte[8] expected = [ 0x66, 0x77, 0x88, 0x99, 0xaa, 0xbb, 0xdd, 0xee ];
|
||||||
|
|
||||||
auto vector = integer.toVector();
|
auto array = integer.toArray();
|
||||||
assert(equal(vector[], expected[]));
|
assert(equal(array[], expected[]));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
Integer integer;
|
||||||
|
assert(integer.toArray().length == 0);
|
||||||
}
|
}
|
||||||
{
|
{
|
||||||
auto integer = Integer(0x03);
|
auto integer = Integer(0x03);
|
||||||
ubyte[1] expected = [ 0x03 ];
|
ubyte[1] expected = [ 0x03 ];
|
||||||
|
|
||||||
auto vector = integer.toVector();
|
auto array = integer.toArray();
|
||||||
assert(equal(vector[], expected[]));
|
assert(equal(array[], expected[]));
|
||||||
}
|
}
|
||||||
{
|
{
|
||||||
ubyte[63] expected = [
|
ubyte[63] expected = [
|
||||||
@ -1448,8 +1557,8 @@ struct Integer
|
|||||||
];
|
];
|
||||||
auto integer = Integer(Sign.positive, expected[]);
|
auto integer = Integer(Sign.positive, expected[]);
|
||||||
|
|
||||||
auto vector = integer.toVector();
|
auto array = integer.toArray();
|
||||||
assert(equal(vector[], expected[]));
|
assert(equal(array[], expected[]));
|
||||||
}
|
}
|
||||||
{
|
{
|
||||||
ubyte[14] expected = [
|
ubyte[14] expected = [
|
||||||
@ -1458,8 +1567,8 @@ struct Integer
|
|||||||
];
|
];
|
||||||
auto integer = Integer(Sign.positive, expected[]);
|
auto integer = Integer(Sign.positive, expected[]);
|
||||||
|
|
||||||
auto vector = integer.toVector();
|
auto array = integer.toArray();
|
||||||
assert(equal(vector[], expected[]));
|
assert(equal(array[], expected[]));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
165
source/tanya/math/nbtheory.d
Normal file
165
source/tanya/math/nbtheory.d
Normal file
@ -0,0 +1,165 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Number theory.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/math/nbtheory.d,
|
||||||
|
* tanya/math/nbtheory.d)
|
||||||
|
*/
|
||||||
|
module tanya.math.nbtheory;
|
||||||
|
|
||||||
|
import tanya.math.mp;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
|
version (TanyaNative)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
import core.math : fabs;
|
||||||
|
import std.math : log;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Calculates the absolute value of a number.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* I = Value type.
|
||||||
|
* x = Value.
|
||||||
|
*
|
||||||
|
* Returns: Absolute value of $(D_PARAM x).
|
||||||
|
*/
|
||||||
|
I abs(I)(I x)
|
||||||
|
if (isIntegral!I)
|
||||||
|
{
|
||||||
|
static if (isSigned!I)
|
||||||
|
{
|
||||||
|
return x >= 0 ? x : -x;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return x;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
int i = -1;
|
||||||
|
assert(i.abs == 1);
|
||||||
|
static assert(is(typeof(i.abs) == int));
|
||||||
|
|
||||||
|
uint u = 1;
|
||||||
|
assert(u.abs == 1);
|
||||||
|
static assert(is(typeof(u.abs) == uint));
|
||||||
|
}
|
||||||
|
|
||||||
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
/// ditto
|
||||||
|
I abs(I)(I x)
|
||||||
|
if (isFloatingPoint!I);
|
||||||
|
}
|
||||||
|
else version (TanyaNative)
|
||||||
|
{
|
||||||
|
extern I abs(I)(I number) pure nothrow @safe @nogc
|
||||||
|
if (isFloatingPoint!I);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
I abs(I)(I x)
|
||||||
|
if (isFloatingPoint!I)
|
||||||
|
{
|
||||||
|
return fabs(cast(real) x);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
float f = -1.64;
|
||||||
|
assert(f.abs == 1.64F);
|
||||||
|
static assert(is(typeof(f.abs) == float));
|
||||||
|
|
||||||
|
double d = -1.64;
|
||||||
|
assert(d.abs == 1.64);
|
||||||
|
static assert(is(typeof(d.abs) == double));
|
||||||
|
|
||||||
|
real r = -1.64;
|
||||||
|
assert(r.abs == 1.64L);
|
||||||
|
static assert(is(typeof(r.abs) == real));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
I abs(I : Integer)(const auto ref I x)
|
||||||
|
{
|
||||||
|
auto result = Integer(x, x.allocator);
|
||||||
|
result.sign = Sign.positive;
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
I abs(I : Integer)(I x)
|
||||||
|
{
|
||||||
|
x.sign = Sign.positive;
|
||||||
|
return x;
|
||||||
|
}
|
||||||
|
|
||||||
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Calculates natural logarithm of $(D_PARAM x).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* x = Argument.
|
||||||
|
*
|
||||||
|
* Returns: Natural logarithm of $(D_PARAM x).
|
||||||
|
*/
|
||||||
|
float ln(float x) pure nothrow @safe @nogc;
|
||||||
|
/// ditto
|
||||||
|
double ln(double x) pure nothrow @safe @nogc;
|
||||||
|
/// ditto
|
||||||
|
real ln(real x) pure nothrow @safe @nogc;
|
||||||
|
}
|
||||||
|
else version (TanyaNative)
|
||||||
|
{
|
||||||
|
extern float ln(float x) pure nothrow @safe @nogc;
|
||||||
|
extern double ln(double x) pure nothrow @safe @nogc;
|
||||||
|
extern real ln(real x) pure nothrow @safe @nogc;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
float ln(float x) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return log(x);
|
||||||
|
}
|
||||||
|
double ln(double x) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return log(x);
|
||||||
|
}
|
||||||
|
alias ln = log;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
import tanya.math;
|
||||||
|
|
||||||
|
assert(isNaN(ln(-7.389f)));
|
||||||
|
assert(isNaN(ln(-7.389)));
|
||||||
|
assert(isNaN(ln(-7.389L)));
|
||||||
|
|
||||||
|
assert(isInfinity(ln(0.0f)));
|
||||||
|
assert(isInfinity(ln(0.0)));
|
||||||
|
assert(isInfinity(ln(0.0L)));
|
||||||
|
|
||||||
|
assert(ln(1.0f) == 0.0f);
|
||||||
|
assert(ln(1.0) == 0.0);
|
||||||
|
assert(ln(1.0L) == 0.0L);
|
||||||
|
}
|
@ -3,20 +3,562 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This package provides mathematical functions.
|
||||||
|
*
|
||||||
|
* The $(D_PSYMBOL tanya.math) package itself provides only representation
|
||||||
|
* functions for built-in types, such as functions that provide information
|
||||||
|
* about internal representation of floating-point numbers and low-level
|
||||||
|
* operatons on these. Actual mathematical functions and additional types can
|
||||||
|
* be found in its submodules. $(D_PSYMBOL tanya.math) doesn't import any
|
||||||
|
* submodules publically, they should be imported explicitly.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/math/package.d,
|
||||||
|
* tanya/math/package.d)
|
||||||
*/
|
*/
|
||||||
module tanya.math;
|
module tanya.math;
|
||||||
|
|
||||||
import std.traits;
|
import tanya.algorithm.mutation;
|
||||||
public import tanya.math.mp;
|
import tanya.math.mp;
|
||||||
public import tanya.math.random;
|
import tanya.math.nbtheory;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.meta.transform;
|
||||||
|
|
||||||
version (unittest)
|
/// Floating-point number precisions according to IEEE-754.
|
||||||
|
enum IEEEPrecision : ubyte
|
||||||
{
|
{
|
||||||
import std.algorithm.iteration;
|
single = 4, /// Single precision: 64-bit.
|
||||||
|
double_ = 8, /// Single precision: 64-bit.
|
||||||
|
doubleExtended = 10, /// Double extended precision: 80-bit.
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tests the precision of floating-point type $(D_PARAM F).
|
||||||
|
*
|
||||||
|
* For $(D_KEYWORD float), $(D_PSYMBOL ieeePrecision) always evaluates to
|
||||||
|
* $(D_INLINECODE IEEEPrecision.single); for $(D_KEYWORD double) - to
|
||||||
|
* $(D_INLINECODE IEEEPrecision.double). It returns different values only
|
||||||
|
* for $(D_KEYWORD real), since $(D_KEYWORD real) is a platform-dependent type.
|
||||||
|
*
|
||||||
|
* If $(D_PARAM F) is a $(D_KEYWORD real) and the target platform isn't
|
||||||
|
* currently supported, static assertion error will be raised (you can use
|
||||||
|
* $(D_INLINECODE is(typeof(ieeePrecision!F))) for testing the platform support
|
||||||
|
* without a compilation error).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type to be tested.
|
||||||
|
*
|
||||||
|
* Returns: Precision according to IEEE-754.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL IEEEPrecision).
|
||||||
|
*/
|
||||||
|
template ieeePrecision(F)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
static if (F.sizeof == float.sizeof)
|
||||||
|
{
|
||||||
|
enum IEEEPrecision ieeePrecision = IEEEPrecision.single;
|
||||||
|
}
|
||||||
|
else static if (F.sizeof == double.sizeof)
|
||||||
|
{
|
||||||
|
enum IEEEPrecision ieeePrecision = IEEEPrecision.double_;
|
||||||
|
}
|
||||||
|
else version (X86)
|
||||||
|
{
|
||||||
|
enum IEEEPrecision ieeePrecision = IEEEPrecision.doubleExtended;
|
||||||
|
}
|
||||||
|
else version (X86_64)
|
||||||
|
{
|
||||||
|
enum IEEEPrecision ieeePrecision = IEEEPrecision.doubleExtended;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false, "Unsupported IEEE 754 floating point precision");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(ieeePrecision!float == IEEEPrecision.single);
|
||||||
|
static assert(ieeePrecision!double == IEEEPrecision.double_);
|
||||||
|
}
|
||||||
|
|
||||||
|
private union FloatBits(F)
|
||||||
|
{
|
||||||
|
F floating;
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single)
|
||||||
|
{
|
||||||
|
uint integral;
|
||||||
|
enum uint expMask = 0x7f800000;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
ulong integral;
|
||||||
|
enum ulong expMask = 0x7ff0000000000000;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
struct // Little-endian.
|
||||||
|
{
|
||||||
|
ulong mantissa;
|
||||||
|
ushort exp;
|
||||||
|
}
|
||||||
|
enum ulong mantissaMask = 0x7fffffffffffffff;
|
||||||
|
enum uint expMask = 0x7fff;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false, "Unsupported IEEE 754 floating point precision");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Floating-point number classifications.
|
||||||
|
*/
|
||||||
|
enum FloatingPointClass : ubyte
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Not a Number.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isNaN).
|
||||||
|
*/
|
||||||
|
nan,
|
||||||
|
|
||||||
|
/// Zero.
|
||||||
|
zero,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Infinity.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isInfinity).
|
||||||
|
*/
|
||||||
|
infinite,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Denormalized number.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isSubnormal).
|
||||||
|
*/
|
||||||
|
subnormal,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Normalized number.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isNormal).
|
||||||
|
*/
|
||||||
|
normal,
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns whether $(D_PARAM x) is a NaN, zero, infinity, subnormal or
|
||||||
|
* normalized number.
|
||||||
|
*
|
||||||
|
* This function doesn't distinguish between negative and positive infinity,
|
||||||
|
* negative and positive NaN or negative and positive zero.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: Classification of $(D_PARAM x).
|
||||||
|
*/
|
||||||
|
FloatingPointClass classify(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
if (x == 0)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.zero;
|
||||||
|
}
|
||||||
|
FloatBits!F bits;
|
||||||
|
bits.floating = abs(x);
|
||||||
|
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single)
|
||||||
|
{
|
||||||
|
if (bits.integral > bits.expMask)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.nan;
|
||||||
|
}
|
||||||
|
else if (bits.integral == bits.expMask)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.infinite;
|
||||||
|
}
|
||||||
|
else if (bits.integral < (1 << 23))
|
||||||
|
{
|
||||||
|
return FloatingPointClass.subnormal;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
if (bits.integral > bits.expMask)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.nan;
|
||||||
|
}
|
||||||
|
else if (bits.integral == bits.expMask)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.infinite;
|
||||||
|
}
|
||||||
|
else if (bits.integral < (1L << 52))
|
||||||
|
{
|
||||||
|
return FloatingPointClass.subnormal;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
if (bits.exp == bits.expMask)
|
||||||
|
{
|
||||||
|
if ((bits.mantissa & bits.mantissaMask) == 0)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.infinite;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return FloatingPointClass.nan;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (bits.exp == 0)
|
||||||
|
{
|
||||||
|
return FloatingPointClass.subnormal;
|
||||||
|
}
|
||||||
|
else if (bits.mantissa < (1L << 63)) // "Unnormal".
|
||||||
|
{
|
||||||
|
return FloatingPointClass.nan;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return FloatingPointClass.normal;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(classify(0.0) == FloatingPointClass.zero);
|
||||||
|
assert(classify(double.nan) == FloatingPointClass.nan);
|
||||||
|
assert(classify(double.infinity) == FloatingPointClass.infinite);
|
||||||
|
assert(classify(-double.infinity) == FloatingPointClass.infinite);
|
||||||
|
assert(classify(1.4) == FloatingPointClass.normal);
|
||||||
|
assert(classify(1.11254e-307 / 10) == FloatingPointClass.subnormal);
|
||||||
|
|
||||||
|
assert(classify(0.0f) == FloatingPointClass.zero);
|
||||||
|
assert(classify(float.nan) == FloatingPointClass.nan);
|
||||||
|
assert(classify(float.infinity) == FloatingPointClass.infinite);
|
||||||
|
assert(classify(-float.infinity) == FloatingPointClass.infinite);
|
||||||
|
assert(classify(0.3) == FloatingPointClass.normal);
|
||||||
|
assert(classify(5.87747e-38f / 10) == FloatingPointClass.subnormal);
|
||||||
|
|
||||||
|
assert(classify(0.0L) == FloatingPointClass.zero);
|
||||||
|
assert(classify(real.nan) == FloatingPointClass.nan);
|
||||||
|
assert(classify(real.infinity) == FloatingPointClass.infinite);
|
||||||
|
assert(classify(-real.infinity) == FloatingPointClass.infinite);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static if (ieeePrecision!float == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
assert(classify(1.68105e-10) == FloatingPointClass.normal);
|
||||||
|
assert(classify(1.68105e-4932L) == FloatingPointClass.subnormal);
|
||||||
|
|
||||||
|
// Emulate unnormals, because they aren't generated anymore since i386
|
||||||
|
FloatBits!real unnormal;
|
||||||
|
unnormal.exp = 0x123;
|
||||||
|
unnormal.mantissa = 0x1;
|
||||||
|
assert(classify(unnormal) == FloatingPointClass.subnormal);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines whether $(D_PARAM x) is a finite number.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is a finite number,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isInfinity).
|
||||||
|
*/
|
||||||
|
bool isFinite(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
FloatBits!F bits;
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single
|
||||||
|
|| ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
bits.floating = x;
|
||||||
|
bits.integral &= bits.expMask;
|
||||||
|
return bits.integral != bits.expMask;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
bits.floating = abs(x);
|
||||||
|
return (bits.exp != bits.expMask)
|
||||||
|
&& (bits.exp == 0 || bits.mantissa >= (1L << 63));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(!isFinite(float.infinity));
|
||||||
|
assert(!isFinite(-double.infinity));
|
||||||
|
assert(isFinite(0.0));
|
||||||
|
assert(!isFinite(float.nan));
|
||||||
|
assert(isFinite(5.87747e-38f / 10));
|
||||||
|
assert(isFinite(1.11254e-307 / 10));
|
||||||
|
assert(isFinite(0.5));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines whether $(D_PARAM x) is $(B n)ot $(B a) $(B n)umber (NaN).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is not a number,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool isNaN(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
FloatBits!F bits;
|
||||||
|
bits.floating = abs(x);
|
||||||
|
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single
|
||||||
|
|| ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
return bits.integral > bits.expMask;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
const maskedMantissa = bits.mantissa & bits.mantissaMask;
|
||||||
|
if ((bits.exp == bits.expMask && maskedMantissa != 0)
|
||||||
|
|| ((bits.exp != 0) && (bits.mantissa < (1L << 63))))
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(isNaN(float.init));
|
||||||
|
assert(isNaN(double.init));
|
||||||
|
assert(isNaN(real.init));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines whether $(D_PARAM x) is a positive or negative infinity.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is infinity, $(D_KEYWORD false)
|
||||||
|
* otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isFinite).
|
||||||
|
*/
|
||||||
|
bool isInfinity(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
FloatBits!F bits;
|
||||||
|
bits.floating = abs(x);
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single
|
||||||
|
|| ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
return bits.integral == bits.expMask;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
return (bits.exp == bits.expMask)
|
||||||
|
&& ((bits.mantissa & bits.mantissaMask) == 0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(isInfinity(float.infinity));
|
||||||
|
assert(isInfinity(-float.infinity));
|
||||||
|
assert(isInfinity(double.infinity));
|
||||||
|
assert(isInfinity(-double.infinity));
|
||||||
|
assert(isInfinity(real.infinity));
|
||||||
|
assert(isInfinity(-real.infinity));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines whether $(D_PARAM x) is a denormilized number or not.
|
||||||
|
|
||||||
|
* Denormalized number is a number between `0` and `1` that cannot be
|
||||||
|
* represented as
|
||||||
|
*
|
||||||
|
* <pre>
|
||||||
|
* m*2<sup>e</sup>
|
||||||
|
* </pre>
|
||||||
|
*
|
||||||
|
* where $(I m) is the mantissa and $(I e) is an exponent that fits into the
|
||||||
|
* exponent field of the type $(D_PARAM F).
|
||||||
|
*
|
||||||
|
* `0` is neither normalized nor denormalized.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is a denormilized number,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isNormal).
|
||||||
|
*/
|
||||||
|
bool isSubnormal(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
FloatBits!F bits;
|
||||||
|
bits.floating = abs(x);
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single)
|
||||||
|
{
|
||||||
|
return bits.integral < (1 << 23) && bits.integral > 0;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
return bits.integral < (1L << 52) && bits.integral > 0;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
return bits.exp == 0 && bits.mantissa != 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(!isSubnormal(0.0f));
|
||||||
|
assert(!isSubnormal(float.nan));
|
||||||
|
assert(!isSubnormal(float.infinity));
|
||||||
|
assert(!isSubnormal(0.3f));
|
||||||
|
assert(isSubnormal(5.87747e-38f / 10));
|
||||||
|
|
||||||
|
assert(!isSubnormal(0.0));
|
||||||
|
assert(!isSubnormal(double.nan));
|
||||||
|
assert(!isSubnormal(double.infinity));
|
||||||
|
assert(!isSubnormal(1.4));
|
||||||
|
assert(isSubnormal(1.11254e-307 / 10));
|
||||||
|
|
||||||
|
assert(!isSubnormal(0.0L));
|
||||||
|
assert(!isSubnormal(real.nan));
|
||||||
|
assert(!isSubnormal(real.infinity));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines whether $(D_PARAM x) is a normilized number or not.
|
||||||
|
|
||||||
|
* Normalized number is a number that can be represented as
|
||||||
|
*
|
||||||
|
* <pre>
|
||||||
|
* m*2<sup>e</sup>
|
||||||
|
* </pre>
|
||||||
|
*
|
||||||
|
* where $(I m) is the mantissa and $(I e) is an exponent that fits into the
|
||||||
|
* exponent field of the type $(D_PARAM F).
|
||||||
|
*
|
||||||
|
* `0` is neither normalized nor denormalized.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is a normilized number,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isSubnormal).
|
||||||
|
*/
|
||||||
|
bool isNormal(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single
|
||||||
|
|| ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
FloatBits!F bits;
|
||||||
|
bits.floating = x;
|
||||||
|
bits.integral &= bits.expMask;
|
||||||
|
return bits.integral != 0 && bits.integral != bits.expMask;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
return classify(x) == FloatingPointClass.normal;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(!isNormal(0.0f));
|
||||||
|
assert(!isNormal(float.nan));
|
||||||
|
assert(!isNormal(float.infinity));
|
||||||
|
assert(isNormal(0.3f));
|
||||||
|
assert(!isNormal(5.87747e-38f / 10));
|
||||||
|
|
||||||
|
assert(!isNormal(0.0));
|
||||||
|
assert(!isNormal(double.nan));
|
||||||
|
assert(!isNormal(double.infinity));
|
||||||
|
assert(isNormal(1.4));
|
||||||
|
assert(!isNormal(1.11254e-307 / 10));
|
||||||
|
|
||||||
|
assert(!isNormal(0.0L));
|
||||||
|
assert(!isNormal(real.nan));
|
||||||
|
assert(!isNormal(real.infinity));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines whether the sign bit of $(D_PARAM x) is set or not.
|
||||||
|
*
|
||||||
|
* If the sign bit, $(D_PARAM x) is a negative number, otherwise positive.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* F = Type of the floating point number.
|
||||||
|
* x = Floating point number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if the sign bit of $(D_PARAM x) is set,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
bool signBit(F)(F x)
|
||||||
|
if (isFloatingPoint!F)
|
||||||
|
{
|
||||||
|
FloatBits!F bits;
|
||||||
|
bits.floating = x;
|
||||||
|
static if (ieeePrecision!F == IEEEPrecision.single)
|
||||||
|
{
|
||||||
|
return (bits.integral & (1 << 31)) != 0;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.double_)
|
||||||
|
{
|
||||||
|
return (bits.integral & (1L << 63)) != 0;
|
||||||
|
}
|
||||||
|
else static if (ieeePrecision!F == IEEEPrecision.doubleExtended)
|
||||||
|
{
|
||||||
|
return (bits.exp & (1 << 15)) != 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(signBit(-1.0f));
|
||||||
|
assert(!signBit(1.0f));
|
||||||
|
|
||||||
|
assert(signBit(-1.0));
|
||||||
|
assert(!signBit(1.0));
|
||||||
|
|
||||||
|
assert(signBit(-1.0L));
|
||||||
|
assert(!signBit(1.0L));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -78,7 +620,7 @@ body
|
|||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
I pow(I)(const auto ref I x, const auto ref I y, const auto ref I z)
|
I pow(I)(const auto ref I x, const auto ref I y, const auto ref I z)
|
||||||
if (is(I == Integer))
|
if (is(I == Integer))
|
||||||
in
|
in
|
||||||
@ -119,7 +661,7 @@ body
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
pure nothrow @safe @nogc unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
assert(pow(3, 5, 7) == 5);
|
assert(pow(3, 5, 7) == 5);
|
||||||
assert(pow(2, 2, 1) == 0);
|
assert(pow(2, 2, 1) == 0);
|
||||||
@ -133,7 +675,7 @@ pure nothrow @safe @nogc unittest
|
|||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
assert(pow(Integer(3), Integer(5), Integer(7)) == 5);
|
assert(pow(Integer(3), Integer(5), Integer(7)) == 5);
|
||||||
assert(pow(Integer(2), Integer(2), Integer(1)) == 0);
|
assert(pow(Integer(2), Integer(2), Integer(1)) == 0);
|
||||||
@ -155,47 +697,201 @@ unittest
|
|||||||
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is a prime number,
|
* Returns: $(D_KEYWORD true) if $(D_PARAM x) is a prime number,
|
||||||
* $(D_KEYWORD false) otherwise.
|
* $(D_KEYWORD false) otherwise.
|
||||||
*/
|
*/
|
||||||
bool isPseudoprime(ulong x) nothrow pure @safe @nogc
|
bool isPseudoprime(ulong x) @nogc nothrow pure @safe
|
||||||
{
|
{
|
||||||
return pow(2, x - 1, x) == 1;
|
return pow(2, x - 1, x) == 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
unittest
|
@nogc nothrow pure @safe unittest
|
||||||
{
|
{
|
||||||
uint[30] known = [74623, 74653, 74687, 74699, 74707, 74713, 74717, 74719,
|
assert(74623.isPseudoprime);
|
||||||
74843, 74747, 74759, 74761, 74771, 74779, 74797, 74821,
|
assert(104729.isPseudoprime);
|
||||||
74827, 9973, 104729, 15485867, 49979693, 104395303,
|
assert(15485867.isPseudoprime);
|
||||||
593441861, 104729, 15485867, 49979693, 104395303,
|
assert(!15485868.isPseudoprime);
|
||||||
593441861, 899809363, 982451653];
|
}
|
||||||
|
|
||||||
known.each!((ref x) => assert(isPseudoprime(x)));
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(74653.isPseudoprime);
|
||||||
|
assert(74687.isPseudoprime);
|
||||||
|
assert(74699.isPseudoprime);
|
||||||
|
assert(74707.isPseudoprime);
|
||||||
|
assert(74713.isPseudoprime);
|
||||||
|
assert(74717.isPseudoprime);
|
||||||
|
assert(74719.isPseudoprime);
|
||||||
|
assert(74747.isPseudoprime);
|
||||||
|
assert(74759.isPseudoprime);
|
||||||
|
assert(74761.isPseudoprime);
|
||||||
|
assert(74771.isPseudoprime);
|
||||||
|
assert(74779.isPseudoprime);
|
||||||
|
assert(74797.isPseudoprime);
|
||||||
|
assert(74821.isPseudoprime);
|
||||||
|
assert(74827.isPseudoprime);
|
||||||
|
assert(9973.isPseudoprime);
|
||||||
|
assert(49979693.isPseudoprime);
|
||||||
|
assert(104395303.isPseudoprime);
|
||||||
|
assert(593441861.isPseudoprime);
|
||||||
|
assert(104729.isPseudoprime);
|
||||||
|
assert(15485867.isPseudoprime);
|
||||||
|
assert(49979693.isPseudoprime);
|
||||||
|
assert(104395303.isPseudoprime);
|
||||||
|
assert(593441861.isPseudoprime);
|
||||||
|
assert(899809363.isPseudoprime);
|
||||||
|
assert(982451653.isPseudoprime);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Params:
|
* Determines minimum of two numbers.
|
||||||
* I = Value type.
|
|
||||||
* x = Value.
|
|
||||||
*
|
*
|
||||||
* Returns: The absolute value of a number.
|
* Params:
|
||||||
|
* x = First number.
|
||||||
|
* y = Second number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM x) if $(D_PARAM x) is smaller than $(D_PSYMBOL y),
|
||||||
|
* $(D_PARAM y) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL max).
|
||||||
*/
|
*/
|
||||||
I abs(I : Integer)(const auto ref I x)
|
T min(T)(T x, T y)
|
||||||
|
if (isIntegral!T)
|
||||||
{
|
{
|
||||||
auto result = Integer(x, x.allocator);
|
return x < y ? x : y;
|
||||||
result.sign = Sign.positive;
|
|
||||||
return result;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
///
|
||||||
I abs(I : Integer)(I x)
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(min(5, 3) == 3);
|
||||||
|
assert(min(4, 4) == 4);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T min(T)(T x, T y)
|
||||||
|
if (isFloatingPoint!T)
|
||||||
|
{
|
||||||
|
if (isNaN(x))
|
||||||
|
{
|
||||||
|
return y;
|
||||||
|
}
|
||||||
|
if (isNaN(y))
|
||||||
{
|
{
|
||||||
x.sign = Sign.positive;
|
|
||||||
return x;
|
return x;
|
||||||
}
|
}
|
||||||
|
return x < y ? x : y;
|
||||||
/// Ditto.
|
}
|
||||||
I abs(I)(const I x)
|
|
||||||
if (isIntegral!I)
|
///
|
||||||
{
|
@nogc nothrow pure @safe unittest
|
||||||
return x >= 0 ? x : -x;
|
{
|
||||||
|
assert(min(5.2, 3.0) == 3.0);
|
||||||
|
|
||||||
|
assert(min(5.2, double.nan) == 5.2);
|
||||||
|
assert(min(double.nan, 3.0) == 3.0);
|
||||||
|
assert(isNaN(min(double.nan, double.nan)));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref T min(T)(ref T x, ref T y)
|
||||||
|
if (is(Unqual!T == Integer))
|
||||||
|
{
|
||||||
|
return x < y ? x : y;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T min(T)(T x, T y)
|
||||||
|
if (is(T == Integer))
|
||||||
|
{
|
||||||
|
return x < y ? move(x) : move(y);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(min(Integer(5), Integer(3)) == 3);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines maximum of two numbers.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* x = First number.
|
||||||
|
* y = Second number.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM x) if $(D_PARAM x) is larger than $(D_PSYMBOL y),
|
||||||
|
* $(D_PARAM y) otherwise.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL min).
|
||||||
|
*/
|
||||||
|
T max(T)(T x, T y)
|
||||||
|
if (isIntegral!T)
|
||||||
|
{
|
||||||
|
return x > y ? x : y;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(max(5, 3) == 5);
|
||||||
|
assert(max(4, 4) == 4);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T max(T)(T x, T y)
|
||||||
|
if (isFloatingPoint!T)
|
||||||
|
{
|
||||||
|
if (isNaN(x))
|
||||||
|
{
|
||||||
|
return y;
|
||||||
|
}
|
||||||
|
if (isNaN(y))
|
||||||
|
{
|
||||||
|
return x;
|
||||||
|
}
|
||||||
|
return x > y ? x : y;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(max(5.2, 3.0) == 5.2);
|
||||||
|
|
||||||
|
assert(max(5.2, double.nan) == 5.2);
|
||||||
|
assert(max(double.nan, 3.0) == 3.0);
|
||||||
|
assert(isNaN(max(double.nan, double.nan)));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref T max(T)(ref T x, ref T y)
|
||||||
|
if (is(Unqual!T == Integer))
|
||||||
|
{
|
||||||
|
return x > y ? x : y;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
T max(T)(T x, T y)
|
||||||
|
if (is(T == Integer))
|
||||||
|
{
|
||||||
|
return x > y ? move(x) : move(y);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
assert(max(Integer(5), Integer(3)) == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
// min/max accept const and mutable references.
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
Integer i1 = 5, i2 = 3;
|
||||||
|
assert(min(i1, i2) == 3);
|
||||||
|
assert(max(i1, i2) == 5);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
const Integer i1 = 5, i2 = 3;
|
||||||
|
assert(min(i1, i2) == 3);
|
||||||
|
assert(max(i1, i2) == 5);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@ -9,6 +9,8 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/math/random.d,
|
||||||
|
* tanya/math/random.d)
|
||||||
*/
|
*/
|
||||||
module tanya.math.random;
|
module tanya.math.random;
|
||||||
|
|
||||||
@ -54,17 +56,17 @@ abstract class EntropySource
|
|||||||
/**
|
/**
|
||||||
* Returns: Minimum bytes required from the entropy source.
|
* Returns: Minimum bytes required from the entropy source.
|
||||||
*/
|
*/
|
||||||
@property immutable(ubyte) threshold() const @safe pure nothrow;
|
@property ubyte threshold() const pure nothrow @safe @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns: Whether this entropy source is strong.
|
* Returns: Whether this entropy source is strong.
|
||||||
*/
|
*/
|
||||||
@property immutable(bool) strong() const @safe pure nothrow;
|
@property bool strong() const pure nothrow @safe @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns: Amount of already generated entropy.
|
* Returns: Amount of already generated entropy.
|
||||||
*/
|
*/
|
||||||
@property ushort size() const @safe pure nothrow
|
@property ushort size() const pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
return size_;
|
return size_;
|
||||||
}
|
}
|
||||||
@ -74,7 +76,7 @@ abstract class EntropySource
|
|||||||
* size = Amount of already generated entropy. Cannot be smaller than the
|
* size = Amount of already generated entropy. Cannot be smaller than the
|
||||||
* already set value.
|
* already set value.
|
||||||
*/
|
*/
|
||||||
@property void size(ushort size) @safe pure nothrow
|
@property void size(ushort size) pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
size_ = size;
|
size_ = size;
|
||||||
}
|
}
|
||||||
@ -89,12 +91,12 @@ abstract class EntropySource
|
|||||||
* Returns: Number of bytes that were copied to the $(D_PARAM output)
|
* Returns: Number of bytes that were copied to the $(D_PARAM output)
|
||||||
* or $(D_PSYMBOL Nullable!ubyte.init) on error.
|
* or $(D_PSYMBOL Nullable!ubyte.init) on error.
|
||||||
*/
|
*/
|
||||||
Nullable!ubyte poll(out ubyte[maxGather] output);
|
Nullable!ubyte poll(out ubyte[maxGather] output) @nogc;
|
||||||
}
|
}
|
||||||
|
|
||||||
version (linux)
|
version (linux)
|
||||||
{
|
{
|
||||||
extern (C) long syscall(long number, ...) nothrow;
|
extern (C) long syscall(long number, ...) nothrow @system @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Uses getrandom system call.
|
* Uses getrandom system call.
|
||||||
@ -104,7 +106,7 @@ version (linux)
|
|||||||
/**
|
/**
|
||||||
* Returns: Minimum bytes required from the entropy source.
|
* Returns: Minimum bytes required from the entropy source.
|
||||||
*/
|
*/
|
||||||
override @property immutable(ubyte) threshold() const @safe pure nothrow
|
override @property ubyte threshold() const pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
return 32;
|
return 32;
|
||||||
}
|
}
|
||||||
@ -112,7 +114,7 @@ version (linux)
|
|||||||
/**
|
/**
|
||||||
* Returns: Whether this entropy source is strong.
|
* Returns: Whether this entropy source is strong.
|
||||||
*/
|
*/
|
||||||
override @property immutable(bool) strong() const @safe pure nothrow
|
override @property bool strong() const pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
@ -127,7 +129,7 @@ version (linux)
|
|||||||
* Returns: Number of bytes that were copied to the $(D_PARAM output)
|
* Returns: Number of bytes that were copied to the $(D_PARAM output)
|
||||||
* or $(D_PSYMBOL Nullable!ubyte.init) on error.
|
* or $(D_PSYMBOL Nullable!ubyte.init) on error.
|
||||||
*/
|
*/
|
||||||
override Nullable!ubyte poll(out ubyte[maxGather] output) nothrow
|
override Nullable!ubyte poll(out ubyte[maxGather] output) nothrow @nogc
|
||||||
out (length)
|
out (length)
|
||||||
{
|
{
|
||||||
assert(length <= maxGather);
|
assert(length <= maxGather);
|
||||||
@ -145,6 +147,18 @@ version (linux)
|
|||||||
return ret;
|
return ret;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
version (X86_64)
|
||||||
|
{
|
||||||
|
private unittest
|
||||||
|
{
|
||||||
|
auto entropy = defaultAllocator.make!Entropy();
|
||||||
|
ubyte[blockSize] output;
|
||||||
|
output = entropy.random;
|
||||||
|
|
||||||
|
defaultAllocator.dispose(entropy);
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -177,7 +191,8 @@ class Entropy
|
|||||||
* allocator = Allocator to allocate entropy sources available on the
|
* allocator = Allocator to allocate entropy sources available on the
|
||||||
* system.
|
* system.
|
||||||
*/
|
*/
|
||||||
this(size_t maxSources = 20, shared Allocator allocator = defaultAllocator)
|
this(const size_t maxSources = 20,
|
||||||
|
shared Allocator allocator = defaultAllocator) @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(maxSources > 0 && maxSources <= ubyte.max);
|
assert(maxSources > 0 && maxSources <= ubyte.max);
|
||||||
@ -196,7 +211,7 @@ class Entropy
|
|||||||
/**
|
/**
|
||||||
* Returns: Amount of the registered entropy sources.
|
* Returns: Amount of the registered entropy sources.
|
||||||
*/
|
*/
|
||||||
@property ubyte sourceCount() const @safe pure nothrow
|
@property ubyte sourceCount() const pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
return sourceCount_;
|
return sourceCount_;
|
||||||
}
|
}
|
||||||
@ -212,8 +227,9 @@ class Entropy
|
|||||||
* See_Also:
|
* See_Also:
|
||||||
* $(D_PSYMBOL EntropySource)
|
* $(D_PSYMBOL EntropySource)
|
||||||
*/
|
*/
|
||||||
Entropy opOpAssign(string Op)(EntropySource source) @safe pure nothrow
|
Entropy opOpAssign(string op)(EntropySource source)
|
||||||
if (Op == "~")
|
pure nothrow @safe @nogc
|
||||||
|
if (op == "~")
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(sourceCount_ <= sources.length);
|
assert(sourceCount_ <= sources.length);
|
||||||
@ -230,7 +246,7 @@ class Entropy
|
|||||||
* Throws: $(D_PSYMBOL EntropyException) if no strong entropy source was
|
* Throws: $(D_PSYMBOL EntropyException) if no strong entropy source was
|
||||||
* registered or it failed.
|
* registered or it failed.
|
||||||
*/
|
*/
|
||||||
@property ubyte[blockSize] random()
|
@property ubyte[blockSize] random() @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(sourceCount_ > 0, "No entropy sources defined.");
|
assert(sourceCount_ > 0, "No entropy sources defined.");
|
||||||
@ -284,7 +300,7 @@ class Entropy
|
|||||||
// Perform second SHA-512 on entropy
|
// Perform second SHA-512 on entropy
|
||||||
output = sha512Of(output);
|
output = sha512Of(output);
|
||||||
|
|
||||||
for (ubyte i = 0; i < sourceCount; ++i)
|
for (ubyte i; i < sourceCount; ++i)
|
||||||
{
|
{
|
||||||
sources[i].size = 0;
|
sources[i].size = 0;
|
||||||
}
|
}
|
||||||
@ -301,7 +317,7 @@ class Entropy
|
|||||||
*/
|
*/
|
||||||
protected void update(in ubyte sourceId,
|
protected void update(in ubyte sourceId,
|
||||||
ref ubyte[maxGather] data,
|
ref ubyte[maxGather] data,
|
||||||
ubyte length) @safe pure nothrow
|
ubyte length) pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
ubyte[2] header;
|
ubyte[2] header;
|
||||||
|
|
||||||
|
@ -3,10 +3,17 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* This module contains the interface for implementing custom allocators.
|
||||||
|
*
|
||||||
|
* Allocators are classes encapsulating memory allocation strategy. This allows
|
||||||
|
* to decouple memory management from the algorithms and the data.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/memory/allocator.d,
|
||||||
|
* tanya/memory/allocator.d)
|
||||||
*/
|
*/
|
||||||
module tanya.memory.allocator;
|
module tanya.memory.allocator;
|
||||||
|
|
||||||
@ -28,7 +35,7 @@ interface Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Pointer to the new allocated memory.
|
* Returns: Pointer to the new allocated memory.
|
||||||
*/
|
*/
|
||||||
void[] allocate(in size_t size) shared nothrow @nogc;
|
void[] allocate(const size_t size) shared pure nothrow @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Deallocates a memory block.
|
* Deallocates a memory block.
|
||||||
@ -38,7 +45,7 @@ interface Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Whether the deallocation was successful.
|
* Returns: Whether the deallocation was successful.
|
||||||
*/
|
*/
|
||||||
bool deallocate(void[] p) shared nothrow @nogc;
|
bool deallocate(void[] p) shared pure nothrow @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Increases or decreases the size of a memory block.
|
* Increases or decreases the size of a memory block.
|
||||||
@ -49,7 +56,7 @@ interface Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Pointer to the allocated memory.
|
* Returns: Pointer to the allocated memory.
|
||||||
*/
|
*/
|
||||||
bool reallocate(ref void[] p, in size_t size) shared nothrow @nogc;
|
bool reallocate(ref void[] p, const size_t size) shared pure nothrow @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Reallocates a memory block in place if possible or returns
|
* Reallocates a memory block in place if possible or returns
|
||||||
@ -63,5 +70,12 @@ interface Allocator
|
|||||||
*
|
*
|
||||||
* Returns: $(D_KEYWORD true) if successful, $(D_KEYWORD false) otherwise.
|
* Returns: $(D_KEYWORD true) if successful, $(D_KEYWORD false) otherwise.
|
||||||
*/
|
*/
|
||||||
bool reallocateInPlace(ref void[] p, in size_t size) shared nothrow @nogc;
|
bool reallocateInPlace(ref void[] p, const size_t size)
|
||||||
|
shared pure nothrow @nogc;
|
||||||
|
}
|
||||||
|
|
||||||
|
package template GetPureInstance(T : Allocator)
|
||||||
|
{
|
||||||
|
alias GetPureInstance = shared(T) function()
|
||||||
|
pure nothrow @nogc;
|
||||||
}
|
}
|
||||||
|
@ -3,22 +3,35 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Allocator based on $(D_PSYMBOL malloc), $(D_PSYMBOL realloc) and $(D_PSYMBOL free).
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2017.
|
* Copyright: Eugene Wissner 2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/memory/mallocator.d,
|
||||||
|
* tanya/memory/mallocator.d)
|
||||||
*/
|
*/
|
||||||
module tanya.memory.mallocator;
|
module tanya.memory.mallocator;
|
||||||
|
|
||||||
|
version (TanyaPhobos):
|
||||||
|
|
||||||
import core.stdc.stdlib;
|
import core.stdc.stdlib;
|
||||||
import std.algorithm.comparison;
|
|
||||||
import tanya.memory.allocator;
|
import tanya.memory.allocator;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Wrapper for malloc/realloc/free from the C standard library.
|
* Wrapper for $(D_PSYMBOL malloc)/$(D_PSYMBOL realloc)/$(D_PSYMBOL free) from
|
||||||
|
* the C standard library.
|
||||||
*/
|
*/
|
||||||
final class Mallocator : Allocator
|
final class Mallocator : Allocator
|
||||||
{
|
{
|
||||||
|
private alias MallocType = extern (C) void* function(size_t)
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
private alias FreeType = extern (C) void function(void*)
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
private alias ReallocType = extern (C) void* function(void*, size_t)
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Allocates $(D_PARAM size) bytes of memory.
|
* Allocates $(D_PARAM size) bytes of memory.
|
||||||
*
|
*
|
||||||
@ -27,13 +40,13 @@ final class Mallocator : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: The pointer to the new allocated memory.
|
* Returns: The pointer to the new allocated memory.
|
||||||
*/
|
*/
|
||||||
void[] allocate(in size_t size) shared nothrow @nogc
|
void[] allocate(const size_t size) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (!size)
|
if (size == 0)
|
||||||
{
|
{
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
auto p = malloc(size + psize);
|
auto p = (cast(MallocType) &malloc)(size + psize);
|
||||||
|
|
||||||
return p is null ? null : p[psize .. psize + size];
|
return p is null ? null : p[psize .. psize + size];
|
||||||
}
|
}
|
||||||
@ -42,10 +55,11 @@ final class Mallocator : Allocator
|
|||||||
@nogc nothrow unittest
|
@nogc nothrow unittest
|
||||||
{
|
{
|
||||||
auto p = Mallocator.instance.allocate(20);
|
auto p = Mallocator.instance.allocate(20);
|
||||||
|
|
||||||
assert(p.length == 20);
|
assert(p.length == 20);
|
||||||
|
|
||||||
Mallocator.instance.deallocate(p);
|
Mallocator.instance.deallocate(p);
|
||||||
|
|
||||||
|
p = Mallocator.instance.allocate(0);
|
||||||
|
assert(p.length == 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -56,11 +70,11 @@ final class Mallocator : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Whether the deallocation was successful.
|
* Returns: Whether the deallocation was successful.
|
||||||
*/
|
*/
|
||||||
bool deallocate(void[] p) shared nothrow @nogc
|
bool deallocate(void[] p) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (p !is null)
|
if (p !is null)
|
||||||
{
|
{
|
||||||
free(p.ptr - psize);
|
(cast(FreeType) &free)(p.ptr - psize);
|
||||||
}
|
}
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
@ -84,11 +98,19 @@ final class Mallocator : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: $(D_KEYWORD false).
|
* Returns: $(D_KEYWORD false).
|
||||||
*/
|
*/
|
||||||
bool reallocateInPlace(ref void[] p, const size_t size) shared nothrow @nogc
|
bool reallocateInPlace(ref void[] p, const size_t size)
|
||||||
|
shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow unittest
|
||||||
|
{
|
||||||
|
void[] p;
|
||||||
|
assert(!Mallocator.instance.reallocateInPlace(p, 8));
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Increases or decreases the size of a memory block.
|
* Increases or decreases the size of a memory block.
|
||||||
*
|
*
|
||||||
@ -98,7 +120,7 @@ final class Mallocator : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Whether the reallocation was successful.
|
* Returns: Whether the reallocation was successful.
|
||||||
*/
|
*/
|
||||||
bool reallocate(ref void[] p, const size_t size) shared nothrow @nogc
|
bool reallocate(ref void[] p, const size_t size) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (size == 0)
|
if (size == 0)
|
||||||
{
|
{
|
||||||
@ -115,7 +137,7 @@ final class Mallocator : Allocator
|
|||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
auto r = realloc(p.ptr - psize, size + psize);
|
auto r = (cast(ReallocType) &realloc)(p.ptr - psize, size + psize);
|
||||||
|
|
||||||
if (r !is null)
|
if (r !is null)
|
||||||
{
|
{
|
||||||
@ -144,24 +166,34 @@ final class Mallocator : Allocator
|
|||||||
assert(p is null);
|
assert(p is null);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Fails with false.
|
||||||
|
private @nogc nothrow unittest
|
||||||
|
{
|
||||||
|
void[] p = Mallocator.instance.allocate(20);
|
||||||
|
void[] oldP = p;
|
||||||
|
assert(!Mallocator.instance.reallocate(p, size_t.max - Mallocator.psize * 2));
|
||||||
|
assert(oldP is p);
|
||||||
|
Mallocator.instance.deallocate(p);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns: The alignment offered.
|
* Returns: The alignment offered.
|
||||||
*/
|
*/
|
||||||
@property uint alignment() shared const pure nothrow @safe @nogc
|
@property uint alignment() shared const pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
return cast(uint) max(double.alignof, real.alignof);
|
return (void*).alignof;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
private nothrow @nogc unittest
|
||||||
* Static allocator instance and initializer.
|
{
|
||||||
*
|
assert(Mallocator.instance.alignment == (void*).alignof);
|
||||||
* Returns: The global $(D_PSYMBOL Allocator) instance.
|
}
|
||||||
*/
|
|
||||||
static @property ref shared(Mallocator) instance() @nogc nothrow
|
static private shared(Mallocator) instantiate() nothrow @nogc
|
||||||
{
|
{
|
||||||
if (instance_ is null)
|
if (instance_ is null)
|
||||||
{
|
{
|
||||||
immutable size = __traits(classInstanceSize, Mallocator) + psize;
|
const size = __traits(classInstanceSize, Mallocator) + psize;
|
||||||
void* p = malloc(size);
|
void* p = malloc(size);
|
||||||
|
|
||||||
if (p !is null)
|
if (p !is null)
|
||||||
@ -173,13 +205,23 @@ final class Mallocator : Allocator
|
|||||||
return instance_;
|
return instance_;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Static allocator instance and initializer.
|
||||||
|
*
|
||||||
|
* Returns: The global $(D_PSYMBOL Allocator) instance.
|
||||||
|
*/
|
||||||
|
static @property shared(Mallocator) instance() pure nothrow @nogc
|
||||||
|
{
|
||||||
|
return (cast(GetPureInstance!Mallocator) &instantiate)();
|
||||||
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
@nogc nothrow unittest
|
@nogc nothrow unittest
|
||||||
{
|
{
|
||||||
assert(instance is instance);
|
assert(instance is instance);
|
||||||
}
|
}
|
||||||
|
|
||||||
private enum psize = 8;
|
private enum ushort psize = 8;
|
||||||
|
|
||||||
private shared static Mallocator instance_;
|
private shared static Mallocator instance_;
|
||||||
}
|
}
|
||||||
|
@ -3,27 +3,83 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Native allocator for Posix and Windows.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/memory/mmappool.d,
|
||||||
|
* tanya/memory/mmappool.d)
|
||||||
*/
|
*/
|
||||||
module tanya.memory.mmappool;
|
module tanya.memory.mmappool;
|
||||||
|
|
||||||
import core.stdc.string;
|
|
||||||
import std.algorithm.comparison;
|
import std.algorithm.comparison;
|
||||||
import tanya.memory.allocator;
|
import tanya.memory.allocator;
|
||||||
|
import tanya.memory.op;
|
||||||
|
|
||||||
version (Posix)
|
version (Posix)
|
||||||
{
|
{
|
||||||
import core.stdc.errno;
|
import core.sys.posix.sys.mman : MAP_ANON,
|
||||||
import core.sys.posix.sys.mman;
|
MAP_FAILED,
|
||||||
|
MAP_PRIVATE,
|
||||||
|
PROT_READ,
|
||||||
|
PROT_WRITE;
|
||||||
import core.sys.posix.unistd;
|
import core.sys.posix.unistd;
|
||||||
|
|
||||||
|
extern(C)
|
||||||
|
private void* mmap(void* addr,
|
||||||
|
size_t len,
|
||||||
|
int prot,
|
||||||
|
int flags,
|
||||||
|
int fd,
|
||||||
|
off_t offset) pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(C)
|
||||||
|
private int munmap(void* addr, size_t len) pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
private void* mapMemory(const size_t len) pure nothrow @system @nogc
|
||||||
|
{
|
||||||
|
void* p = mmap(null,
|
||||||
|
len,
|
||||||
|
PROT_READ | PROT_WRITE,
|
||||||
|
MAP_PRIVATE | MAP_ANON,
|
||||||
|
-1,
|
||||||
|
0);
|
||||||
|
return p is MAP_FAILED ? null : p;
|
||||||
|
}
|
||||||
|
|
||||||
|
private bool unmapMemory(shared void* addr, const size_t len)
|
||||||
|
pure nothrow @system @nogc
|
||||||
|
{
|
||||||
|
return munmap(cast(void*) addr, len) == 0;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
else version (Windows)
|
else version (Windows)
|
||||||
{
|
{
|
||||||
import core.sys.windows.winbase;
|
import core.sys.windows.winbase : GetSystemInfo, SYSTEM_INFO;
|
||||||
import core.sys.windows.windows;
|
|
||||||
|
extern(Windows)
|
||||||
|
private void* VirtualAlloc(void*, size_t, uint, uint)
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
private int VirtualFree(void* addr, size_t len, uint)
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
private void* mapMemory(const size_t len) pure nothrow @system @nogc
|
||||||
|
{
|
||||||
|
return VirtualAlloc(null,
|
||||||
|
len,
|
||||||
|
0x00001000, // MEM_COMMIT
|
||||||
|
0x04); // PAGE_READWRITE
|
||||||
|
}
|
||||||
|
|
||||||
|
private bool unmapMemory(shared void* addr, const size_t len)
|
||||||
|
pure nothrow @system @nogc
|
||||||
|
{
|
||||||
|
return VirtualFree(cast(void*) addr, 0, 0x8000) == 0;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -36,6 +92,7 @@ else version (Windows)
|
|||||||
* block as free and only if all blocks in the region are free, the complete
|
* block as free and only if all blocks in the region are free, the complete
|
||||||
* region is deallocated.
|
* region is deallocated.
|
||||||
*
|
*
|
||||||
|
* <pre>
|
||||||
* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
||||||
* | | | | | || | | |
|
* | | | | | || | | |
|
||||||
* | |prev <----------- | || | | |
|
* | |prev <----------- | || | | |
|
||||||
@ -47,10 +104,13 @@ else version (Windows)
|
|||||||
* | N | -----------> next| || N | | |
|
* | N | -----------> next| || N | | |
|
||||||
* | | | | | || | | |
|
* | | | | | || | | |
|
||||||
* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
* ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
||||||
|
* </pre>
|
||||||
*/
|
*/
|
||||||
final class MmapPool : Allocator
|
final class MmapPool : Allocator
|
||||||
{
|
{
|
||||||
invariant
|
version (none)
|
||||||
|
{
|
||||||
|
pure nothrow @nogc invariant
|
||||||
{
|
{
|
||||||
for (auto r = &head; *r !is null; r = &((*r).next))
|
for (auto r = &head; *r !is null; r = &((*r).next))
|
||||||
{
|
{
|
||||||
@ -64,6 +124,7 @@ final class MmapPool : Allocator
|
|||||||
while ((block = block.next) !is null);
|
while ((block = block.next) !is null);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Allocates $(D_PARAM size) bytes of memory.
|
* Allocates $(D_PARAM size) bytes of memory.
|
||||||
@ -73,13 +134,17 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Pointer to the new allocated memory.
|
* Returns: Pointer to the new allocated memory.
|
||||||
*/
|
*/
|
||||||
void[] allocate(in size_t size) shared nothrow @nogc
|
void[] allocate(const size_t size) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (!size)
|
if (size == 0)
|
||||||
|
{
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
const dataSize = addAlignment(size);
|
||||||
|
if (dataSize < size)
|
||||||
{
|
{
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
immutable dataSize = addAlignment(size);
|
|
||||||
|
|
||||||
void* data = findBlock(dataSize);
|
void* data = findBlock(dataSize);
|
||||||
if (data is null)
|
if (data is null)
|
||||||
@ -94,13 +159,32 @@ final class MmapPool : Allocator
|
|||||||
nothrow unittest
|
nothrow unittest
|
||||||
{
|
{
|
||||||
auto p = MmapPool.instance.allocate(20);
|
auto p = MmapPool.instance.allocate(20);
|
||||||
|
|
||||||
assert(p);
|
assert(p);
|
||||||
|
|
||||||
MmapPool.instance.deallocate(p);
|
MmapPool.instance.deallocate(p);
|
||||||
|
|
||||||
|
p = MmapPool.instance.allocate(0);
|
||||||
|
assert(p.length == 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// Issue 245: https://issues.caraus.io/issues/245.
|
||||||
|
private @nogc unittest
|
||||||
|
{
|
||||||
|
// allocate() check.
|
||||||
|
size_t tooMuchMemory = size_t.max
|
||||||
|
- MmapPool.alignment_
|
||||||
|
- BlockEntry.sizeof * 2
|
||||||
|
- RegionEntry.sizeof
|
||||||
|
- MmapPool.instance.pageSize;
|
||||||
|
assert(MmapPool.instance.allocate(tooMuchMemory) is null);
|
||||||
|
|
||||||
|
assert(MmapPool.instance.allocate(size_t.max) is null);
|
||||||
|
|
||||||
|
// initializeRegion() check.
|
||||||
|
tooMuchMemory = size_t.max - MmapPool.alignment_;
|
||||||
|
assert(MmapPool.instance.allocate(tooMuchMemory) is null);
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
* Search for a block large enough to keep $(D_PARAM size) and split it
|
* Search for a block large enough to keep $(D_PARAM size) and split it
|
||||||
* into two blocks if the block is too large.
|
* into two blocks if the block is too large.
|
||||||
*
|
*
|
||||||
@ -109,7 +193,7 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Data the block points to or $(D_KEYWORD null).
|
* Returns: Data the block points to or $(D_KEYWORD null).
|
||||||
*/
|
*/
|
||||||
private void* findBlock(in ref size_t size) shared nothrow @nogc
|
private void* findBlock(const ref size_t size) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
Block block1;
|
Block block1;
|
||||||
RegionLoop: for (auto r = head; r !is null; r = r.next)
|
RegionLoop: for (auto r = head; r !is null; r = r.next)
|
||||||
@ -169,7 +253,7 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Whether the deallocation was successful.
|
* Returns: Whether the deallocation was successful.
|
||||||
*/
|
*/
|
||||||
bool deallocate(void[] p) shared nothrow @nogc
|
bool deallocate(void[] p) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (p.ptr is null)
|
if (p.ptr is null)
|
||||||
{
|
{
|
||||||
@ -191,14 +275,7 @@ final class MmapPool : Allocator
|
|||||||
{
|
{
|
||||||
block.region.next.prev = block.region.prev;
|
block.region.next.prev = block.region.prev;
|
||||||
}
|
}
|
||||||
version (Posix)
|
return unmapMemory(block.region, block.region.size);
|
||||||
{
|
|
||||||
return munmap(cast(void*) block.region, block.region.size) == 0;
|
|
||||||
}
|
|
||||||
version (Windows)
|
|
||||||
{
|
|
||||||
return VirtualFree(cast(void*) block.region, 0, MEM_RELEASE) == 0;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
// Merge blocks if neigbours are free.
|
// Merge blocks if neigbours are free.
|
||||||
if (block.next !is null && block.next.free)
|
if (block.next !is null && block.next.free)
|
||||||
@ -242,7 +319,8 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: $(D_KEYWORD true) if successful, $(D_KEYWORD false) otherwise.
|
* Returns: $(D_KEYWORD true) if successful, $(D_KEYWORD false) otherwise.
|
||||||
*/
|
*/
|
||||||
bool reallocateInPlace(ref void[] p, in size_t size) shared nothrow @nogc
|
bool reallocateInPlace(ref void[] p, const size_t size)
|
||||||
|
shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (p is null || size == 0)
|
if (p is null || size == 0)
|
||||||
{
|
{
|
||||||
@ -258,19 +336,25 @@ final class MmapPool : Allocator
|
|||||||
|
|
||||||
if (block1.size >= size)
|
if (block1.size >= size)
|
||||||
{
|
{
|
||||||
// Enough space in the current block. Can happen because of the alignment.
|
// Enough space in the current block.
|
||||||
p = p.ptr[0 .. size];
|
p = p.ptr[0 .. size];
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
immutable dataSize = addAlignment(size);
|
const dataSize = addAlignment(size);
|
||||||
immutable delta = dataSize - addAlignment(p.length);
|
const pAlignment = addAlignment(p.length);
|
||||||
|
assert(pAlignment >= p.length, "Invalid memory chunk length");
|
||||||
|
const delta = dataSize - pAlignment;
|
||||||
|
|
||||||
if (block1.next is null
|
if (block1.next is null
|
||||||
|| !block1.next.free
|
|| !block1.next.free
|
||||||
|
|| dataSize < size
|
||||||
|| block1.next.size + BlockEntry.sizeof < delta)
|
|| block1.next.size + BlockEntry.sizeof < delta)
|
||||||
{
|
{
|
||||||
// It is the last block in the region or the next block is too small or not
|
/* - It is the last block in the region
|
||||||
// free.
|
* - The next block isn't free
|
||||||
|
* - The next block is too small
|
||||||
|
* - Requested size is too large
|
||||||
|
*/
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
if (block1.next.size >= delta + alignment_)
|
if (block1.next.size >= delta + alignment_)
|
||||||
@ -284,8 +368,8 @@ final class MmapPool : Allocator
|
|||||||
{
|
{
|
||||||
block1.next.next.prev = block2;
|
block1.next.next.prev = block2;
|
||||||
}
|
}
|
||||||
// block1.next and block2 can overlap.
|
copyBackward((cast(void*) block1.next)[0 .. BlockEntry.sizeof],
|
||||||
memmove(cast(void*) block2, cast(void*) block1.next, BlockEntry.sizeof);
|
(cast(void*) block2)[0 .. BlockEntry.sizeof]);
|
||||||
block1.next = block2;
|
block1.next = block2;
|
||||||
}
|
}
|
||||||
else
|
else
|
||||||
@ -333,7 +417,7 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Whether the reallocation was successful.
|
* Returns: Whether the reallocation was successful.
|
||||||
*/
|
*/
|
||||||
bool reallocate(ref void[] p, in size_t size) shared nothrow @nogc
|
bool reallocate(ref void[] p, const size_t size) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
if (size == 0)
|
if (size == 0)
|
||||||
{
|
{
|
||||||
@ -357,7 +441,7 @@ final class MmapPool : Allocator
|
|||||||
}
|
}
|
||||||
if (p !is null)
|
if (p !is null)
|
||||||
{
|
{
|
||||||
memcpy(reallocP.ptr, p.ptr, min(p.length, size));
|
copy(p[0 .. min(p.length, size)], reallocP);
|
||||||
deallocate(p);
|
deallocate(p);
|
||||||
}
|
}
|
||||||
p = reallocP;
|
p = reallocP;
|
||||||
@ -394,19 +478,14 @@ final class MmapPool : Allocator
|
|||||||
MmapPool.instance.deallocate(p);
|
MmapPool.instance.deallocate(p);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
static private shared(MmapPool) instantiate() nothrow @nogc
|
||||||
* Static allocator instance and initializer.
|
|
||||||
*
|
|
||||||
* Returns: Global $(D_PSYMBOL MmapPool) instance.
|
|
||||||
*/
|
|
||||||
static @property ref shared(MmapPool) instance() nothrow @nogc
|
|
||||||
{
|
{
|
||||||
if (instance_ is null)
|
if (instance_ is null)
|
||||||
{
|
{
|
||||||
// Get system dependend page size.
|
// Get system dependend page size.
|
||||||
version (Posix)
|
version (Posix)
|
||||||
{
|
{
|
||||||
pageSize = sysconf(_SC_PAGE_SIZE);
|
size_t pageSize = sysconf(_SC_PAGE_SIZE);
|
||||||
if (pageSize < 65536)
|
if (pageSize < 65536)
|
||||||
{
|
{
|
||||||
pageSize = pageSize * 65536 / pageSize;
|
pageSize = pageSize * 65536 / pageSize;
|
||||||
@ -416,23 +495,35 @@ final class MmapPool : Allocator
|
|||||||
{
|
{
|
||||||
SYSTEM_INFO si;
|
SYSTEM_INFO si;
|
||||||
GetSystemInfo(&si);
|
GetSystemInfo(&si);
|
||||||
pageSize = si.dwPageSize;
|
size_t pageSize = si.dwPageSize;
|
||||||
}
|
}
|
||||||
|
|
||||||
immutable instanceSize = addAlignment(__traits(classInstanceSize, MmapPool));
|
const instanceSize = addAlignment(__traits(classInstanceSize,
|
||||||
|
MmapPool));
|
||||||
|
|
||||||
Region head; // Will become soon our region list head
|
Region head; // Will become soon our region list head
|
||||||
void* data = initializeRegion(instanceSize, head);
|
void* data = initializeRegion(instanceSize, head, pageSize);
|
||||||
if (data !is null)
|
if (data !is null)
|
||||||
{
|
{
|
||||||
memcpy(data, typeid(MmapPool).initializer.ptr, instanceSize);
|
copy(typeid(MmapPool).initializer, data[0 .. instanceSize]);
|
||||||
instance_ = cast(shared MmapPool) data;
|
instance_ = cast(shared MmapPool) data;
|
||||||
instance_.head = head;
|
instance_.head = head;
|
||||||
|
instance_.pageSize = pageSize;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
return instance_;
|
return instance_;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Static allocator instance and initializer.
|
||||||
|
*
|
||||||
|
* Returns: Global $(D_PSYMBOL MmapPool) instance.
|
||||||
|
*/
|
||||||
|
static @property shared(MmapPool) instance() pure nothrow @nogc
|
||||||
|
{
|
||||||
|
return (cast(GetPureInstance!MmapPool) &instantiate)();
|
||||||
|
}
|
||||||
|
|
||||||
///
|
///
|
||||||
nothrow unittest
|
nothrow unittest
|
||||||
{
|
{
|
||||||
@ -448,35 +539,22 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: A pointer to the data.
|
* Returns: A pointer to the data.
|
||||||
*/
|
*/
|
||||||
private static void* initializeRegion(size_t size, ref Region head)
|
private static void* initializeRegion(const size_t size,
|
||||||
nothrow @nogc
|
ref Region head,
|
||||||
|
const size_t pageSize)
|
||||||
|
pure nothrow @nogc
|
||||||
{
|
{
|
||||||
immutable regionSize = calculateRegionSize(size);
|
const regionSize = calculateRegionSize(size, pageSize);
|
||||||
|
if (regionSize < size)
|
||||||
version (Posix)
|
|
||||||
{
|
|
||||||
void* p = mmap(null,
|
|
||||||
regionSize,
|
|
||||||
PROT_READ | PROT_WRITE,
|
|
||||||
MAP_PRIVATE | MAP_ANON,
|
|
||||||
-1,
|
|
||||||
0);
|
|
||||||
if (p is MAP_FAILED)
|
|
||||||
{
|
{
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
}
|
|
||||||
else version (Windows)
|
void* p = mapMemory(regionSize);
|
||||||
{
|
|
||||||
void* p = VirtualAlloc(null,
|
|
||||||
regionSize,
|
|
||||||
MEM_COMMIT,
|
|
||||||
PAGE_READWRITE);
|
|
||||||
if (p is null)
|
if (p is null)
|
||||||
{
|
{
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
}
|
|
||||||
|
|
||||||
Region region = cast(Region) p;
|
Region region = cast(Region) p;
|
||||||
region.blocks = 1;
|
region.blocks = 1;
|
||||||
@ -513,9 +591,9 @@ final class MmapPool : Allocator
|
|||||||
return data;
|
return data;
|
||||||
}
|
}
|
||||||
|
|
||||||
private void* initializeRegion(size_t size) shared nothrow @nogc
|
private void* initializeRegion(const size_t size) shared pure nothrow @nogc
|
||||||
{
|
{
|
||||||
return initializeRegion(size, head);
|
return initializeRegion(size, this.head, this.pageSize);
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
@ -524,13 +602,7 @@ final class MmapPool : Allocator
|
|||||||
*
|
*
|
||||||
* Returns: Aligned size of $(D_PARAM x).
|
* Returns: Aligned size of $(D_PARAM x).
|
||||||
*/
|
*/
|
||||||
private static immutable(size_t) addAlignment(size_t x)
|
private static size_t addAlignment(const size_t x) pure nothrow @safe @nogc
|
||||||
pure nothrow @safe @nogc
|
|
||||||
out (result)
|
|
||||||
{
|
|
||||||
assert(result > 0);
|
|
||||||
}
|
|
||||||
body
|
|
||||||
{
|
{
|
||||||
return (x - 1) / alignment_ * alignment_ + alignment_;
|
return (x - 1) / alignment_ * alignment_ + alignment_;
|
||||||
}
|
}
|
||||||
@ -538,19 +610,16 @@ final class MmapPool : Allocator
|
|||||||
/*
|
/*
|
||||||
* Params:
|
* Params:
|
||||||
* x = Required space.
|
* x = Required space.
|
||||||
|
* pageSize = Page size.
|
||||||
*
|
*
|
||||||
* Returns: Minimum region size (a multiple of $(D_PSYMBOL pageSize)).
|
* Returns: Minimum region size (a multiple of $(D_PSYMBOL pageSize)).
|
||||||
*/
|
*/
|
||||||
private static immutable(size_t) calculateRegionSize(size_t x)
|
private static size_t calculateRegionSize(ref const size_t x,
|
||||||
nothrow @safe @nogc
|
ref const size_t pageSize)
|
||||||
out (result)
|
pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
assert(result > 0);
|
return (x + RegionEntry.sizeof + BlockEntry.sizeof * 2)
|
||||||
}
|
/ pageSize * pageSize + pageSize;
|
||||||
body
|
|
||||||
{
|
|
||||||
x += RegionEntry.sizeof + BlockEntry.sizeof * 2;
|
|
||||||
return x / pageSize * pageSize + pageSize;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -560,10 +629,16 @@ final class MmapPool : Allocator
|
|||||||
{
|
{
|
||||||
return alignment_;
|
return alignment_;
|
||||||
}
|
}
|
||||||
private enum alignment_ = 8;
|
|
||||||
|
private nothrow @nogc unittest
|
||||||
|
{
|
||||||
|
assert(MmapPool.instance.alignment == MmapPool.alignment_);
|
||||||
|
}
|
||||||
|
|
||||||
|
private enum uint alignment_ = 8;
|
||||||
|
|
||||||
private shared static MmapPool instance_;
|
private shared static MmapPool instance_;
|
||||||
private shared static size_t pageSize;
|
private shared size_t pageSize;
|
||||||
|
|
||||||
private shared struct RegionEntry
|
private shared struct RegionEntry
|
||||||
{
|
{
|
||||||
@ -588,7 +663,7 @@ final class MmapPool : Allocator
|
|||||||
|
|
||||||
// A lot of allocations/deallocations, but it is the minimum caused a
|
// A lot of allocations/deallocations, but it is the minimum caused a
|
||||||
// segmentation fault because MmapPool reallocateInPlace moves a block wrong.
|
// segmentation fault because MmapPool reallocateInPlace moves a block wrong.
|
||||||
unittest
|
private @nogc unittest
|
||||||
{
|
{
|
||||||
auto a = MmapPool.instance.allocate(16);
|
auto a = MmapPool.instance.allocate(16);
|
||||||
auto d = MmapPool.instance.allocate(16);
|
auto d = MmapPool.instance.allocate(16);
|
||||||
|
385
source/tanya/memory/op.d
Normal file
385
source/tanya/memory/op.d
Normal file
@ -0,0 +1,385 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set of operations on memory blocks.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/memory/op.d,
|
||||||
|
* tanya/memory/op.d)
|
||||||
|
*/
|
||||||
|
module tanya.memory.op;
|
||||||
|
|
||||||
|
version (TanyaNative)
|
||||||
|
{
|
||||||
|
extern private void fillMemory(void[], size_t) pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern private void copyMemory(const void[], void[])
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern private void moveMemory(const void[], void[])
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern private int cmpMemory(const void[], const void[])
|
||||||
|
pure nothrow @system @nogc;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
import core.stdc.string;
|
||||||
|
}
|
||||||
|
|
||||||
|
private enum alignMask = size_t.sizeof - 1;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copies $(D_PARAM source) into $(D_PARAM target).
|
||||||
|
*
|
||||||
|
* $(D_PARAM source) and $(D_PARAM target) shall not overlap so that
|
||||||
|
* $(D_PARAM source) points ahead of $(D_PARAM target).
|
||||||
|
*
|
||||||
|
* $(D_PARAM target) shall have enough space for $(D_INLINECODE source.length)
|
||||||
|
* elements.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* source = Memory to copy from.
|
||||||
|
* target = Destination memory.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL copyBackward).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE source.length <= target.length).
|
||||||
|
*/
|
||||||
|
void copy(const void[] source, void[] target) @nogc nothrow pure @trusted
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(source.length <= target.length);
|
||||||
|
assert(source.length == 0 || source.ptr !is null);
|
||||||
|
assert(target.length == 0 || target.ptr !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
version (TanyaNative)
|
||||||
|
{
|
||||||
|
copyMemory(source, target);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
memcpy(target.ptr, source.ptr, source.length);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[9] source = [1, 2, 3, 4, 5, 6, 7, 8, 9];
|
||||||
|
ubyte[9] target;
|
||||||
|
source.copy(target);
|
||||||
|
assert(cmp(source, target) == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
ubyte[0] source, target;
|
||||||
|
source.copy(target);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
ubyte[1] source = [1];
|
||||||
|
ubyte[1] target;
|
||||||
|
source.copy(target);
|
||||||
|
assert(target[0] == 1);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
ubyte[8] source = [1, 2, 3, 4, 5, 6, 7, 8];
|
||||||
|
ubyte[8] target;
|
||||||
|
source.copy(target);
|
||||||
|
assert(cmp(source, target) == 0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* size_t value each of which bytes is set to `Byte`.
|
||||||
|
*/
|
||||||
|
private template filledBytes(ubyte Byte, ubyte I = 0)
|
||||||
|
{
|
||||||
|
static if (I == size_t.sizeof)
|
||||||
|
{
|
||||||
|
enum size_t filledBytes = Byte;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
enum size_t filledBytes = (filledBytes!(Byte, I + 1) << 8) | Byte;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Fills $(D_PARAM memory) with the single byte $(D_PARAM c).
|
||||||
|
*
|
||||||
|
* Param:
|
||||||
|
* c = The value to fill $(D_PARAM memory) with.
|
||||||
|
* memory = Memory block.
|
||||||
|
*/
|
||||||
|
void fill(ubyte c = 0)(void[] memory) @trusted
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(memory.length == 0 || memory.ptr !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
version (TanyaNative)
|
||||||
|
{
|
||||||
|
fillMemory(memory, filledBytes!c);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
memset(memory.ptr, c, memory.length);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[9] memory = [1, 2, 3, 4, 5, 6, 7, 8, 9];
|
||||||
|
memory.fill!0();
|
||||||
|
foreach (ubyte v; memory)
|
||||||
|
{
|
||||||
|
assert(v == 0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Stress test. Checks that `fill` can handle unaligned pointers and different
|
||||||
|
// lengths.
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[192] memory;
|
||||||
|
|
||||||
|
foreach (j; 0 .. 192)
|
||||||
|
{
|
||||||
|
foreach (ubyte i, ref ubyte v; memory[j .. $])
|
||||||
|
{
|
||||||
|
v = i;
|
||||||
|
}
|
||||||
|
fill(memory[j .. $]);
|
||||||
|
foreach (ubyte v; memory[j .. $])
|
||||||
|
{
|
||||||
|
assert(v == 0);
|
||||||
|
}
|
||||||
|
fill!1(memory[j .. $]);
|
||||||
|
foreach (ubyte v; memory[j .. $])
|
||||||
|
{
|
||||||
|
assert(v == 1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copies starting from the end of $(D_PARAM source) into the end of
|
||||||
|
* $(D_PARAM target).
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL copyBackward) copies the elements in reverse order, but the
|
||||||
|
* order of elements in the $(D_PARAM target) is exactly the same as in the
|
||||||
|
* $(D_PARAM source).
|
||||||
|
*
|
||||||
|
* $(D_PARAM source) and $(D_PARAM target) shall not overlap so that
|
||||||
|
* $(D_PARAM target) points ahead of $(D_PARAM source).
|
||||||
|
*
|
||||||
|
* $(D_PARAM target) shall have enough space for $(D_INLINECODE source.length)
|
||||||
|
* elements.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* source = Memory to copy from.
|
||||||
|
* target = Destination memory.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL copy).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE source.length <= target.length).
|
||||||
|
*/
|
||||||
|
void copyBackward(const void[] source, void[] target) @nogc nothrow pure @trusted
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(source.length <= target.length);
|
||||||
|
assert(source.length == 0 || source.ptr !is null);
|
||||||
|
assert(target.length == 0 || target.ptr !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
version (TanyaNative)
|
||||||
|
{
|
||||||
|
moveMemory(source, target);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
memmove(target.ptr, source.ptr, source.length);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[6] mem = [ 'a', 'a', 'b', 'b', 'c', 'c' ];
|
||||||
|
ubyte[6] expected = [ 'a', 'a', 'a', 'a', 'b', 'b' ];
|
||||||
|
|
||||||
|
copyBackward(mem[0 .. 4], mem[2 .. $]);
|
||||||
|
assert(cmp(expected, mem) == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[9] r1 = [ 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i' ];
|
||||||
|
ubyte[9] r2;
|
||||||
|
|
||||||
|
copyBackward(r1, r2);
|
||||||
|
assert(cmp(r1, r2) == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Compares two memory areas $(D_PARAM r1) and $(D_PARAM r2).
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL cmp) returns a positive integer if
|
||||||
|
* $(D_INLINECODE r1.length > r2.length) or the first `n` compared bytes of
|
||||||
|
* $(D_PARAM r1) found to be greater than the first `n` bytes of $(D_PARAM r2),
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL cmp) returns a negative integer if
|
||||||
|
* $(D_INLINECODE r2.length > r1.length) or the first `n` compared bytes of
|
||||||
|
* $(D_PARAM r1) found to be less than the first `n` bytes of $(D_PARAM r2),
|
||||||
|
*
|
||||||
|
* `0` is returned otherwise.
|
||||||
|
*
|
||||||
|
* Returns: Positive integer if $(D_INLINECODE r1 > r2),
|
||||||
|
* negative integer if $(D_INLINECODE r2 > r1),
|
||||||
|
* `0` if $(D_INLINECODE r1 == r2).
|
||||||
|
*/
|
||||||
|
int cmp(const void[] r1, const void[] r2) @nogc nothrow pure @trusted
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(r1.length == 0 || r1.ptr !is null);
|
||||||
|
assert(r2.length == 0 || r2.ptr !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
version (TanyaNative)
|
||||||
|
{
|
||||||
|
return cmpMemory(r1, r2);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
if (r1.length > r2.length)
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
return r1.length < r2.length ? -1 : memcmp(r1.ptr, r2.ptr, r1.length);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[4] r1 = [ 'a', 'b', 'c', 'd' ];
|
||||||
|
ubyte[3] r2 = [ 'c', 'a', 'b' ];
|
||||||
|
|
||||||
|
assert(cmp(r1[0 .. 3], r2[]) < 0);
|
||||||
|
assert(cmp(r2[], r1[0 .. 3]) > 0);
|
||||||
|
|
||||||
|
assert(cmp(r1, r2) > 0);
|
||||||
|
assert(cmp(r2, r1) < 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[16] r1 = [
|
||||||
|
'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h',
|
||||||
|
'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p',
|
||||||
|
];
|
||||||
|
ubyte[16] r2 = [
|
||||||
|
'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h',
|
||||||
|
'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p',
|
||||||
|
];
|
||||||
|
|
||||||
|
assert(cmp(r1, r2) == 0);
|
||||||
|
assert(cmp(r1[1 .. $], r2[1 .. $]) == 0);
|
||||||
|
assert(cmp(r1[0 .. $ - 1], r2[0 .. $ - 1]) == 0);
|
||||||
|
assert(cmp(r1[0 .. 8], r2[0 .. 8]) == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Finds the first occurrence of $(D_PARAM needle) in $(D_PARAM haystack) if
|
||||||
|
* any.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* haystack = Memory block.
|
||||||
|
* needle = A byte.
|
||||||
|
*
|
||||||
|
* Returns: The subrange of $(D_PARAM haystack) whose first element is the
|
||||||
|
* first occurrence of $(D_PARAM needle). If $(D_PARAM needle)
|
||||||
|
* couldn't be found, an empty `inout void[]` is returned.
|
||||||
|
*/
|
||||||
|
inout(void[]) find(return inout void[] haystack, const ubyte needle)
|
||||||
|
@nogc nothrow pure @trusted
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(haystack.length == 0 || haystack.ptr !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto length = haystack.length;
|
||||||
|
const size_t needleWord = size_t.max * needle;
|
||||||
|
enum size_t highBits = filledBytes!(0x01, 0);
|
||||||
|
enum size_t mask = filledBytes!(0x80, 0);
|
||||||
|
|
||||||
|
// Align
|
||||||
|
auto bytes = cast(inout(ubyte)*) haystack;
|
||||||
|
while (length > 0 && ((cast(size_t) bytes) & 3) != 0)
|
||||||
|
{
|
||||||
|
if (*bytes == needle)
|
||||||
|
{
|
||||||
|
return bytes[0 .. length];
|
||||||
|
}
|
||||||
|
bytes++;
|
||||||
|
length--;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check if some of the words has the needle
|
||||||
|
auto words = cast(inout(size_t)*) bytes;
|
||||||
|
while (length >= size_t.sizeof)
|
||||||
|
{
|
||||||
|
if (((*words ^ needleWord) - highBits) & (~*words) & mask)
|
||||||
|
{
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
words++;
|
||||||
|
length -= size_t.sizeof;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find the exact needle position in the word
|
||||||
|
bytes = cast(inout(ubyte)*) words;
|
||||||
|
while (length > 0)
|
||||||
|
{
|
||||||
|
if (*bytes == needle)
|
||||||
|
{
|
||||||
|
return bytes[0 .. length];
|
||||||
|
}
|
||||||
|
bytes++;
|
||||||
|
length--;
|
||||||
|
}
|
||||||
|
|
||||||
|
return haystack[$ .. $];
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
const ubyte[9] haystack = ['a', 'b', 'c', 'd', 'e', 'f', 'b', 'g', 'h'];
|
||||||
|
|
||||||
|
assert(find(haystack, 'a') == haystack[]);
|
||||||
|
assert(find(haystack, 'b') == haystack[1 .. $]);
|
||||||
|
assert(find(haystack, 'c') == haystack[2 .. $]);
|
||||||
|
assert(find(haystack, 'd') == haystack[3 .. $]);
|
||||||
|
assert(find(haystack, 'e') == haystack[4 .. $]);
|
||||||
|
assert(find(haystack, 'f') == haystack[5 .. $]);
|
||||||
|
assert(find(haystack, 'h') == haystack[8 .. $]);
|
||||||
|
assert(find(haystack, 'i').length == 0);
|
||||||
|
|
||||||
|
assert(find(null, 'a').length == 0);
|
||||||
|
}
|
@ -3,18 +3,25 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Dynamic memory management.
|
||||||
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/memory/package.d,
|
||||||
|
* tanya/memory/package.d)
|
||||||
*/
|
*/
|
||||||
module tanya.memory;
|
module tanya.memory;
|
||||||
|
|
||||||
import core.exception;
|
|
||||||
import std.algorithm.iteration;
|
import std.algorithm.iteration;
|
||||||
public import std.experimental.allocator : make;
|
import std.algorithm.mutation;
|
||||||
import std.traits;
|
import tanya.conv;
|
||||||
|
import tanya.exception;
|
||||||
public import tanya.memory.allocator;
|
public import tanya.memory.allocator;
|
||||||
|
import tanya.memory.mmappool;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.range.primitive;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The mixin generates common methods for classes and structs using
|
* The mixin generates common methods for classes and structs using
|
||||||
@ -33,7 +40,7 @@ mixin template DefaultAllocator()
|
|||||||
*
|
*
|
||||||
* Precondition: $(D_INLINECODE allocator_ !is null)
|
* Precondition: $(D_INLINECODE allocator_ !is null)
|
||||||
*/
|
*/
|
||||||
this(shared Allocator allocator)
|
this(shared Allocator allocator) pure nothrow @safe @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(allocator !is null);
|
assert(allocator !is null);
|
||||||
@ -51,7 +58,7 @@ mixin template DefaultAllocator()
|
|||||||
*
|
*
|
||||||
* Postcondition: $(D_INLINECODE allocator !is null)
|
* Postcondition: $(D_INLINECODE allocator !is null)
|
||||||
*/
|
*/
|
||||||
protected @property shared(Allocator) allocator() nothrow @safe @nogc
|
protected @property shared(Allocator) allocator() pure nothrow @safe @nogc
|
||||||
out (allocator)
|
out (allocator)
|
||||||
{
|
{
|
||||||
assert(allocator !is null);
|
assert(allocator !is null);
|
||||||
@ -65,8 +72,8 @@ mixin template DefaultAllocator()
|
|||||||
return allocator_;
|
return allocator_;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// ditto
|
||||||
@property shared(Allocator) allocator() const nothrow @trusted @nogc
|
@property shared(Allocator) allocator() const pure nothrow @trusted @nogc
|
||||||
out (allocator)
|
out (allocator)
|
||||||
{
|
{
|
||||||
assert(allocator !is null);
|
assert(allocator !is null);
|
||||||
@ -82,26 +89,44 @@ mixin template DefaultAllocator()
|
|||||||
}
|
}
|
||||||
|
|
||||||
// From druntime
|
// From druntime
|
||||||
private extern (C) void _d_monitordelete(Object h, bool det) nothrow @nogc;
|
extern (C)
|
||||||
|
private void _d_monitordelete(Object h, bool det) pure nothrow @nogc;
|
||||||
|
|
||||||
shared Allocator allocator;
|
shared Allocator allocator;
|
||||||
|
|
||||||
shared static this() nothrow @trusted @nogc
|
shared static this() nothrow @nogc
|
||||||
{
|
{
|
||||||
import tanya.memory.mmappool;
|
|
||||||
allocator = MmapPool.instance;
|
allocator = MmapPool.instance;
|
||||||
}
|
}
|
||||||
|
|
||||||
@property ref shared(Allocator) defaultAllocator() nothrow @safe @nogc
|
private shared(Allocator) getAllocatorInstance() nothrow @nogc
|
||||||
|
{
|
||||||
|
return allocator;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Default allocator.
|
||||||
|
*
|
||||||
|
* Postcondition: $(D_INLINECODE allocator !is null).
|
||||||
|
*/
|
||||||
|
@property shared(Allocator) defaultAllocator() pure nothrow @trusted @nogc
|
||||||
out (allocator)
|
out (allocator)
|
||||||
{
|
{
|
||||||
assert(allocator !is null);
|
assert(allocator !is null);
|
||||||
}
|
}
|
||||||
body
|
body
|
||||||
{
|
{
|
||||||
return allocator;
|
return (cast(GetPureInstance!Allocator) &getAllocatorInstance)();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sets the default allocator.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* allocator = $(D_PSYMBOL Allocator) instance.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null).
|
||||||
|
*/
|
||||||
@property void defaultAllocator(shared(Allocator) allocator) nothrow @safe @nogc
|
@property void defaultAllocator(shared(Allocator) allocator) nothrow @safe @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
@ -116,21 +141,54 @@ body
|
|||||||
* Returns the size in bytes of the state that needs to be allocated to hold an
|
* Returns the size in bytes of the state that needs to be allocated to hold an
|
||||||
* object of type $(D_PARAM T).
|
* object of type $(D_PARAM T).
|
||||||
*
|
*
|
||||||
|
* There is a difference between the `.sizeof`-property and
|
||||||
|
* $(D_PSYMBOL stateSize) if $(D_PARAM T) is a class or an interface.
|
||||||
|
* `T.sizeof` is constant on the given architecture then and is the same as
|
||||||
|
* `size_t.sizeof` and `ptrdiff_t.sizeof`. This is because classes and
|
||||||
|
* interfaces are reference types and `.sizeof` returns the size of the
|
||||||
|
* reference which is the same as the size of a pointer. $(D_PSYMBOL stateSize)
|
||||||
|
* returns the size of the instance itself.
|
||||||
|
*
|
||||||
|
* The size of a dynamic array is `size_t.sizeof * 2` since a dynamic array
|
||||||
|
* stores its length and a data pointer. The size of the static arrays is
|
||||||
|
* calculated differently since they are value types. It is the array length
|
||||||
|
* multiplied by the element size.
|
||||||
|
*
|
||||||
|
* `stateSize!void` is `1` since $(D_KEYWORD void) is mostly used as a synonym
|
||||||
|
* for $(D_KEYWORD byte)/$(D_KEYWORD ubyte) in `void*`.
|
||||||
|
*
|
||||||
* Params:
|
* Params:
|
||||||
* T = Object type.
|
* T = Object type.
|
||||||
|
*
|
||||||
|
* Returns: Size of an instance of type $(D_PARAM T).
|
||||||
*/
|
*/
|
||||||
template stateSize(T)
|
template stateSize(T)
|
||||||
{
|
{
|
||||||
static if (is(T == class) || is(T == interface))
|
static if (isPolymorphicType!T)
|
||||||
{
|
{
|
||||||
enum stateSize = __traits(classInstanceSize, T);
|
enum size_t stateSize = __traits(classInstanceSize, T);
|
||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
enum stateSize = T.sizeof;
|
enum size_t stateSize = T.sizeof;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(stateSize!int == 4);
|
||||||
|
static assert(stateSize!bool == 1);
|
||||||
|
static assert(stateSize!(int[]) == (size_t.sizeof * 2));
|
||||||
|
static assert(stateSize!(short[3]) == 6);
|
||||||
|
|
||||||
|
static struct Empty
|
||||||
|
{
|
||||||
|
}
|
||||||
|
static assert(stateSize!Empty == 1);
|
||||||
|
static assert(stateSize!void == 1);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Params:
|
* Params:
|
||||||
* size = Raw size.
|
* size = Raw size.
|
||||||
@ -144,7 +202,7 @@ pure nothrow @safe @nogc
|
|||||||
return (size - 1) / alignment * alignment + alignment;
|
return (size - 1) / alignment * alignment + alignment;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Internal function used to create, resize or destroy a dynamic array. It
|
* Internal function used to create, resize or destroy a dynamic array. It
|
||||||
* may throw $(D_PSYMBOL OutOfMemoryError). The new
|
* may throw $(D_PSYMBOL OutOfMemoryError). The new
|
||||||
* allocated part of the array isn't initialized. This function can be trusted
|
* allocated part of the array isn't initialized. This function can be trusted
|
||||||
@ -171,14 +229,14 @@ package(tanya) T[] resize(T)(shared Allocator allocator,
|
|||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
onOutOfMemoryErrorNoGC();
|
onOutOfMemoryError();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
void[] buf = array;
|
void[] buf = array;
|
||||||
if (!allocator.reallocate(buf, length * T.sizeof))
|
if (!allocator.reallocate(buf, length * T.sizeof))
|
||||||
{
|
{
|
||||||
onOutOfMemoryErrorNoGC();
|
onOutOfMemoryError();
|
||||||
}
|
}
|
||||||
// Casting from void[] is unsafe, but we know we cast to the original type.
|
// Casting from void[] is unsafe, but we know we cast to the original type.
|
||||||
array = cast(T[]) buf;
|
array = cast(T[]) buf;
|
||||||
@ -258,7 +316,8 @@ package(tanya) void[] finalize(T)(ref T p)
|
|||||||
// shouldn't throw and if it does, it is an error anyway.
|
// shouldn't throw and if it does, it is an error anyway.
|
||||||
if (c.destructor)
|
if (c.destructor)
|
||||||
{
|
{
|
||||||
(cast(void function (Object) nothrow @safe @nogc) c.destructor)(ob);
|
alias DtorType = void function(Object) pure nothrow @safe @nogc;
|
||||||
|
(cast(DtorType) c.destructor)(ob);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
while ((c = c.base) !is null);
|
while ((c = c.base) !is null);
|
||||||
@ -307,3 +366,136 @@ private unittest
|
|||||||
|
|
||||||
defaultAllocator.dispose(p);
|
defaultAllocator.dispose(p);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Works with interfaces.
|
||||||
|
private pure unittest
|
||||||
|
{
|
||||||
|
interface I
|
||||||
|
{
|
||||||
|
}
|
||||||
|
class C : I
|
||||||
|
{
|
||||||
|
}
|
||||||
|
auto c = defaultAllocator.make!C();
|
||||||
|
I i = c;
|
||||||
|
|
||||||
|
defaultAllocator.dispose(i);
|
||||||
|
defaultAllocator.dispose(i);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new class instance of type $(D_PARAM T) using $(D_PARAM args)
|
||||||
|
* as the parameter list for the constructor of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Class type.
|
||||||
|
* A = Types of the arguments to the constructor of $(D_PARAM T).
|
||||||
|
* allocator = Allocator.
|
||||||
|
* args = Constructor arguments of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Returns: Newly created $(D_PSYMBOL T).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
T make(T, A...)(shared Allocator allocator, auto ref A args)
|
||||||
|
if (is(T == class))
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto mem = (() @trusted => allocator.allocate(stateSize!T))();
|
||||||
|
if (mem is null)
|
||||||
|
{
|
||||||
|
onOutOfMemoryError();
|
||||||
|
}
|
||||||
|
scope (failure)
|
||||||
|
{
|
||||||
|
() @trusted { allocator.deallocate(mem); }();
|
||||||
|
}
|
||||||
|
|
||||||
|
return emplace!T(mem[0 .. stateSize!T], args);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a value object of type $(D_PARAM T) using $(D_PARAM args)
|
||||||
|
* as the parameter list for the constructor of $(D_PARAM T) and returns a
|
||||||
|
* pointer to the new object.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Object type.
|
||||||
|
* A = Types of the arguments to the constructor of $(D_PARAM T).
|
||||||
|
* allocator = Allocator.
|
||||||
|
* args = Constructor arguments of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Returns: Pointer to the created object.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
T* make(T, A...)(shared Allocator allocator, auto ref A args)
|
||||||
|
if (!is(T == interface)
|
||||||
|
&& !is(T == class)
|
||||||
|
&& !isAssociativeArray!T
|
||||||
|
&& !isArray!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto mem = (() @trusted => allocator.allocate(stateSize!T))();
|
||||||
|
if (mem is null)
|
||||||
|
{
|
||||||
|
onOutOfMemoryError();
|
||||||
|
}
|
||||||
|
scope (failure)
|
||||||
|
{
|
||||||
|
() @trusted { allocator.deallocate(mem); }();
|
||||||
|
}
|
||||||
|
return emplace!T(mem[0 .. stateSize!T], args);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
int* i = defaultAllocator.make!int(5);
|
||||||
|
assert(*i == 5);
|
||||||
|
defaultAllocator.dispose(i);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new array with $(D_PARAM n) elements.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Array type.
|
||||||
|
* allocator = Allocator.
|
||||||
|
* n = Array size.
|
||||||
|
*
|
||||||
|
* Returns: Newly created array.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null
|
||||||
|
* && n <= size_t.max / ElementType!T.sizeof)
|
||||||
|
*/
|
||||||
|
T make(T)(shared Allocator allocator, const size_t n)
|
||||||
|
if (isArray!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
assert(n <= size_t.max / ElementType!T.sizeof);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto ret = allocator.resize!(ElementType!T)(null, n);
|
||||||
|
ret.uninitializedFill(ElementType!T.init);
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
int[] i = defaultAllocator.make!(int[])(2);
|
||||||
|
assert(i.length == 2);
|
||||||
|
assert(i[0] == int.init && i[1] == int.init);
|
||||||
|
defaultAllocator.dispose(i);
|
||||||
|
}
|
||||||
|
923
source/tanya/memory/smartref.d
Normal file
923
source/tanya/memory/smartref.d
Normal file
@ -0,0 +1,923 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Smart pointers.
|
||||||
|
*
|
||||||
|
* A smart pointer is an object that wraps a raw pointer or a reference
|
||||||
|
* (class, dynamic array) to manage its lifetime.
|
||||||
|
*
|
||||||
|
* This module provides two kinds of lifetime management strategies:
|
||||||
|
* $(UL
|
||||||
|
* $(LI Reference counting)
|
||||||
|
* $(LI Unique ownership)
|
||||||
|
* )
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/memory/smartref.d,
|
||||||
|
* tanya/memory/smartref.d)
|
||||||
|
*/
|
||||||
|
module tanya.memory.smartref;
|
||||||
|
|
||||||
|
import std.algorithm.comparison;
|
||||||
|
import tanya.algorithm.mutation;
|
||||||
|
import tanya.conv;
|
||||||
|
import tanya.exception;
|
||||||
|
import tanya.memory;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
import tanya.range.primitive;
|
||||||
|
|
||||||
|
private template Payload(T)
|
||||||
|
{
|
||||||
|
static if (isPolymorphicType!T || isArray!T)
|
||||||
|
{
|
||||||
|
alias Payload = T;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias Payload = T*;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private final class RefCountedStore(T)
|
||||||
|
{
|
||||||
|
T payload;
|
||||||
|
size_t counter = 1;
|
||||||
|
|
||||||
|
size_t opUnary(string op)()
|
||||||
|
if (op == "--" || op == "++")
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(this.counter > 0);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
mixin("return " ~ op ~ "counter;");
|
||||||
|
}
|
||||||
|
|
||||||
|
int opCmp(const size_t counter)
|
||||||
|
{
|
||||||
|
if (this.counter > counter)
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
else if (this.counter < counter)
|
||||||
|
{
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void separateDeleter(T)(RefCountedStore!T storage,
|
||||||
|
shared Allocator allocator)
|
||||||
|
{
|
||||||
|
allocator.dispose(storage.payload);
|
||||||
|
allocator.dispose(storage);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void unifiedDeleter(T)(RefCountedStore!T storage,
|
||||||
|
shared Allocator allocator)
|
||||||
|
{
|
||||||
|
auto ptr1 = finalize(storage);
|
||||||
|
auto ptr2 = finalize(storage.payload);
|
||||||
|
allocator.deallocate(ptr1.ptr[0 .. ptr1.length + ptr2.length]);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Reference-counted object containing a $(D_PARAM T) value as payload.
|
||||||
|
* $(D_PSYMBOL RefCounted) keeps track of all references of an object, and
|
||||||
|
* when the reference count goes down to zero, frees the underlying store.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Type of the reference-counted value.
|
||||||
|
*/
|
||||||
|
struct RefCounted(T)
|
||||||
|
{
|
||||||
|
private alias Storage = RefCountedStore!(Payload!T);
|
||||||
|
|
||||||
|
private Storage storage;
|
||||||
|
private void function(Storage storage,
|
||||||
|
shared Allocator allocator) @nogc deleter;
|
||||||
|
|
||||||
|
invariant
|
||||||
|
{
|
||||||
|
assert(this.storage is null || this.allocator_ !is null);
|
||||||
|
assert(this.storage is null || this.deleter !is null);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Takes ownership over $(D_PARAM value), setting the counter to 1.
|
||||||
|
* $(D_PARAM value) may be a pointer, an object or a dynamic array.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* value = Value whose ownership is taken over.
|
||||||
|
* allocator = Allocator used to destroy the $(D_PARAM value) and to
|
||||||
|
* allocate/deallocate internal storage.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
this(Payload!T value, shared Allocator allocator = defaultAllocator)
|
||||||
|
{
|
||||||
|
this(allocator);
|
||||||
|
this.storage = allocator.make!Storage();
|
||||||
|
this.deleter = &separateDeleter!(Payload!T);
|
||||||
|
|
||||||
|
this.storage.payload = value;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
this(shared Allocator allocator)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
this.allocator_ = allocator;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Increases the reference counter by one.
|
||||||
|
*/
|
||||||
|
this(this)
|
||||||
|
{
|
||||||
|
if (count != 0)
|
||||||
|
{
|
||||||
|
++this.storage;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Decreases the reference counter by one.
|
||||||
|
*
|
||||||
|
* If the counter reaches 0, destroys the owned object.
|
||||||
|
*/
|
||||||
|
~this()
|
||||||
|
{
|
||||||
|
if (this.storage !is null && !(this.storage > 0 && --this.storage))
|
||||||
|
{
|
||||||
|
deleter(this.storage, allocator);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Takes ownership over $(D_PARAM rhs). Initializes this
|
||||||
|
* $(D_PSYMBOL RefCounted) if needed.
|
||||||
|
*
|
||||||
|
* If it is the last reference of the previously owned object,
|
||||||
|
* it will be destroyed.
|
||||||
|
*
|
||||||
|
* To reset $(D_PSYMBOL RefCounted) assign $(D_KEYWORD null).
|
||||||
|
*
|
||||||
|
* If the allocator wasn't set before, $(D_PSYMBOL defaultAllocator) will
|
||||||
|
* be used. If you need a different allocator, create a new
|
||||||
|
* $(D_PSYMBOL RefCounted) and assign it.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* rhs = New object.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD this).
|
||||||
|
*/
|
||||||
|
ref typeof(this) opAssign(Payload!T rhs)
|
||||||
|
{
|
||||||
|
if (this.storage is null)
|
||||||
|
{
|
||||||
|
this.storage = allocator.make!Storage();
|
||||||
|
this.deleter = &separateDeleter!(Payload!T);
|
||||||
|
}
|
||||||
|
else if (this.storage > 1)
|
||||||
|
{
|
||||||
|
--this.storage;
|
||||||
|
this.storage = allocator.make!Storage();
|
||||||
|
this.deleter = &separateDeleter!(Payload!T);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
finalize(this.storage.payload);
|
||||||
|
this.storage.payload = Payload!T.init;
|
||||||
|
}
|
||||||
|
this.storage.payload = rhs;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref typeof(this) opAssign(typeof(null))
|
||||||
|
{
|
||||||
|
if (this.storage is null)
|
||||||
|
{
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
else if (this.storage > 1)
|
||||||
|
{
|
||||||
|
--this.storage;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
deleter(this.storage, allocator);
|
||||||
|
}
|
||||||
|
this.storage = null;
|
||||||
|
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref typeof(this) opAssign(typeof(this) rhs)
|
||||||
|
{
|
||||||
|
swap(this.allocator_, rhs.allocator_);
|
||||||
|
swap(this.storage, rhs.storage);
|
||||||
|
swap(this.deleter, rhs.deleter);
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Reference to the owned object.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE cound > 0).
|
||||||
|
*/
|
||||||
|
inout(Payload!T) get() inout
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(count > 0, "Attempted to access an uninitialized reference");
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return this.storage.payload;
|
||||||
|
}
|
||||||
|
|
||||||
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Dereferences the pointer. It is defined only for pointers, not for
|
||||||
|
* reference types like classes, that can be accessed directly.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* op = Operation.
|
||||||
|
*
|
||||||
|
* Returns: Reference to the pointed value.
|
||||||
|
*/
|
||||||
|
ref inout(T) opUnary(string op)() inout
|
||||||
|
if (op == "*");
|
||||||
|
}
|
||||||
|
else static if (isPointer!(Payload!T))
|
||||||
|
{
|
||||||
|
ref inout(T) opUnary(string op)() inout
|
||||||
|
if (op == "*")
|
||||||
|
{
|
||||||
|
return *this.storage.payload;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Whether this $(D_PSYMBOL RefCounted) already has an internal
|
||||||
|
* storage.
|
||||||
|
*/
|
||||||
|
@property bool isInitialized() const
|
||||||
|
{
|
||||||
|
return this.storage !is null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: The number of $(D_PSYMBOL RefCounted) instances that share
|
||||||
|
* ownership over the same pointer (including $(D_KEYWORD this)).
|
||||||
|
* If this $(D_PSYMBOL RefCounted) isn't initialized, returns `0`.
|
||||||
|
*/
|
||||||
|
@property size_t count() const
|
||||||
|
{
|
||||||
|
return this.storage is null ? 0 : this.storage.counter;
|
||||||
|
}
|
||||||
|
|
||||||
|
mixin DefaultAllocator;
|
||||||
|
alias get this;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = RefCounted!int(defaultAllocator.make!int(5), defaultAllocator);
|
||||||
|
auto val = rc.get();
|
||||||
|
|
||||||
|
*val = 8;
|
||||||
|
assert(*rc.storage.payload == 8);
|
||||||
|
|
||||||
|
val = null;
|
||||||
|
assert(rc.storage.payload !is null);
|
||||||
|
assert(*rc.storage.payload == 8);
|
||||||
|
|
||||||
|
*rc = 9;
|
||||||
|
assert(*rc.storage.payload == 9);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!int(5);
|
||||||
|
rc = defaultAllocator.make!int(7);
|
||||||
|
assert(*rc == 7);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
RefCounted!int rc;
|
||||||
|
assert(!rc.isInitialized);
|
||||||
|
rc = null;
|
||||||
|
assert(!rc.isInitialized);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!int(5);
|
||||||
|
|
||||||
|
void func(RefCounted!int param) @nogc
|
||||||
|
{
|
||||||
|
assert(param.count == 2);
|
||||||
|
param = defaultAllocator.make!int(7);
|
||||||
|
assert(param.count == 1);
|
||||||
|
assert(*param == 7);
|
||||||
|
}
|
||||||
|
func(rc);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
assert(*rc == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
RefCounted!int rc;
|
||||||
|
|
||||||
|
void func(RefCounted!int param) @nogc
|
||||||
|
{
|
||||||
|
assert(param.count == 0);
|
||||||
|
param = defaultAllocator.make!int(7);
|
||||||
|
assert(param.count == 1);
|
||||||
|
assert(*param == 7);
|
||||||
|
}
|
||||||
|
func(rc);
|
||||||
|
assert(rc.count == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
RefCounted!int rc1, rc2;
|
||||||
|
static assert(is(typeof(rc1 = rc2)));
|
||||||
|
}
|
||||||
|
|
||||||
|
version (unittest)
|
||||||
|
{
|
||||||
|
private class A
|
||||||
|
{
|
||||||
|
uint *destroyed;
|
||||||
|
|
||||||
|
this(ref uint destroyed) @nogc
|
||||||
|
{
|
||||||
|
this.destroyed = &destroyed;
|
||||||
|
}
|
||||||
|
|
||||||
|
~this() @nogc
|
||||||
|
{
|
||||||
|
++(*destroyed);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private struct B
|
||||||
|
{
|
||||||
|
int prop;
|
||||||
|
@disable this();
|
||||||
|
this(int param1) @nogc
|
||||||
|
{
|
||||||
|
prop = param1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
uint destroyed;
|
||||||
|
auto a = defaultAllocator.make!A(destroyed);
|
||||||
|
|
||||||
|
assert(destroyed == 0);
|
||||||
|
{
|
||||||
|
auto rc = RefCounted!A(a, defaultAllocator);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
|
||||||
|
void func(RefCounted!A rc) @nogc @system
|
||||||
|
{
|
||||||
|
assert(rc.count == 2);
|
||||||
|
}
|
||||||
|
func(rc);
|
||||||
|
|
||||||
|
assert(rc.count == 1);
|
||||||
|
}
|
||||||
|
assert(destroyed == 1);
|
||||||
|
|
||||||
|
RefCounted!int rc;
|
||||||
|
assert(rc.count == 0);
|
||||||
|
rc = defaultAllocator.make!int(8);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = RefCounted!int(defaultAllocator);
|
||||||
|
assert(!rc.isInitialized);
|
||||||
|
assert(rc.allocator is defaultAllocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!int(5);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
|
||||||
|
void func(RefCounted!int rc) @nogc
|
||||||
|
{
|
||||||
|
assert(rc.count == 2);
|
||||||
|
rc = null;
|
||||||
|
assert(!rc.isInitialized);
|
||||||
|
assert(rc.count == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
assert(rc.count == 1);
|
||||||
|
func(rc);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
|
||||||
|
rc = null;
|
||||||
|
assert(!rc.isInitialized);
|
||||||
|
assert(rc.count == 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!int(5);
|
||||||
|
assert(*rc == 5);
|
||||||
|
|
||||||
|
void func(RefCounted!int rc) @nogc
|
||||||
|
{
|
||||||
|
assert(rc.count == 2);
|
||||||
|
rc = defaultAllocator.refCounted!int(4);
|
||||||
|
assert(*rc == 4);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
}
|
||||||
|
func(rc);
|
||||||
|
assert(*rc == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(typeof(RefCounted!int.storage.payload) == int*));
|
||||||
|
static assert(is(typeof(RefCounted!A.storage.payload) == A));
|
||||||
|
|
||||||
|
static assert(is(RefCounted!B));
|
||||||
|
static assert(is(RefCounted!A));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new object of type $(D_PARAM T) and wraps it in a
|
||||||
|
* $(D_PSYMBOL RefCounted) using $(D_PARAM args) as the parameter list for
|
||||||
|
* the constructor of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* This function is more efficient than the using of $(D_PSYMBOL RefCounted)
|
||||||
|
* directly, since it allocates only ones (the internal storage and the
|
||||||
|
* object).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Type of the constructed object.
|
||||||
|
* A = Types of the arguments to the constructor of $(D_PARAM T).
|
||||||
|
* allocator = Allocator.
|
||||||
|
* args = Constructor arguments of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Returns: Newly created $(D_PSYMBOL RefCounted!T).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
RefCounted!T refCounted(T, A...)(shared Allocator allocator, auto ref A args)
|
||||||
|
if (!is(T == interface) && !isAbstractClass!T
|
||||||
|
&& !isAssociativeArray!T && !isArray!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto rc = typeof(return)(allocator);
|
||||||
|
|
||||||
|
const storageSize = alignedSize(stateSize!(RefCounted!T.Storage));
|
||||||
|
const size = alignedSize(stateSize!T + storageSize);
|
||||||
|
|
||||||
|
auto mem = (() @trusted => allocator.allocate(size))();
|
||||||
|
if (mem is null)
|
||||||
|
{
|
||||||
|
onOutOfMemoryError();
|
||||||
|
}
|
||||||
|
scope (failure)
|
||||||
|
{
|
||||||
|
() @trusted { allocator.deallocate(mem); }();
|
||||||
|
}
|
||||||
|
rc.storage = emplace!(RefCounted!T.Storage)(mem[0 .. storageSize]);
|
||||||
|
rc.storage.payload = emplace!T(mem[storageSize .. $], args);
|
||||||
|
|
||||||
|
rc.deleter = &unifiedDeleter!(Payload!T);
|
||||||
|
return rc;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new array with $(D_PARAM size) elements and wraps it in a
|
||||||
|
* $(D_PSYMBOL RefCounted).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Array type.
|
||||||
|
* size = Array size.
|
||||||
|
* allocator = Allocator.
|
||||||
|
*
|
||||||
|
* Returns: Newly created $(D_PSYMBOL RefCounted!T).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null
|
||||||
|
* && size <= size_t.max / ElementType!T.sizeof)
|
||||||
|
*/
|
||||||
|
RefCounted!T refCounted(T)(shared Allocator allocator, const size_t size)
|
||||||
|
@trusted
|
||||||
|
if (isArray!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
assert(size <= size_t.max / ElementType!T.sizeof);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return RefCounted!T(allocator.make!T(size), allocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!int(5);
|
||||||
|
assert(rc.count == 1);
|
||||||
|
|
||||||
|
void func(RefCounted!int param) @nogc
|
||||||
|
{
|
||||||
|
if (param.count == 2)
|
||||||
|
{
|
||||||
|
func(param);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
assert(param.count == 3);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
func(rc);
|
||||||
|
|
||||||
|
assert(rc.count == 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
struct E
|
||||||
|
{
|
||||||
|
}
|
||||||
|
auto b = defaultAllocator.refCounted!B(15);
|
||||||
|
static assert(is(typeof(b.storage.payload) == B*));
|
||||||
|
static assert(is(typeof(b.prop) == int));
|
||||||
|
static assert(!is(typeof(defaultAllocator.refCounted!B())));
|
||||||
|
|
||||||
|
static assert(is(typeof(defaultAllocator.refCounted!E())));
|
||||||
|
static assert(!is(typeof(defaultAllocator.refCounted!E(5))));
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!B(3);
|
||||||
|
assert(rc.get().prop == 3);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!E();
|
||||||
|
assert(rc.count);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!(int[])(5);
|
||||||
|
assert(rc.length == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
auto p1 = defaultAllocator.make!int(5);
|
||||||
|
auto p2 = p1;
|
||||||
|
auto rc = RefCounted!int(p1, defaultAllocator);
|
||||||
|
assert(rc.get() is p2);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc @system unittest
|
||||||
|
{
|
||||||
|
static bool destroyed;
|
||||||
|
|
||||||
|
static struct F
|
||||||
|
{
|
||||||
|
~this() @nogc nothrow @safe
|
||||||
|
{
|
||||||
|
destroyed = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.refCounted!F();
|
||||||
|
}
|
||||||
|
assert(destroyed);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_PSYMBOL Unique) stores an object that gets destroyed at the end of its scope.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Value type.
|
||||||
|
*/
|
||||||
|
struct Unique(T)
|
||||||
|
{
|
||||||
|
private Payload!T payload;
|
||||||
|
|
||||||
|
invariant
|
||||||
|
{
|
||||||
|
assert(payload is null || allocator_ !is null);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Takes ownership over $(D_PARAM value), setting the counter to 1.
|
||||||
|
* $(D_PARAM value) may be a pointer, an object or a dynamic array.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* value = Value whose ownership is taken over.
|
||||||
|
* allocator = Allocator used to destroy the $(D_PARAM value) and to
|
||||||
|
* allocate/deallocate internal storage.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
this(Payload!T value, shared Allocator allocator = defaultAllocator)
|
||||||
|
{
|
||||||
|
this(allocator);
|
||||||
|
this.payload = value;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
this(shared Allocator allocator)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
this.allocator_ = allocator;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_PSYMBOL Unique) is noncopyable.
|
||||||
|
*/
|
||||||
|
@disable this(this);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Destroys the owned object.
|
||||||
|
*/
|
||||||
|
~this()
|
||||||
|
{
|
||||||
|
allocator.dispose(this.payload);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Initialized this $(D_PARAM Unique) and takes ownership over
|
||||||
|
* $(D_PARAM rhs).
|
||||||
|
*
|
||||||
|
* To reset $(D_PSYMBOL Unique) assign $(D_KEYWORD null).
|
||||||
|
*
|
||||||
|
* If the allocator wasn't set before, $(D_PSYMBOL defaultAllocator) will
|
||||||
|
* be used. If you need a different allocator, create a new
|
||||||
|
* $(D_PSYMBOL Unique) and assign it.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* rhs = New object.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD this).
|
||||||
|
*/
|
||||||
|
ref typeof(this) opAssign(Payload!T rhs)
|
||||||
|
{
|
||||||
|
allocator.dispose(this.payload);
|
||||||
|
this.payload = rhs;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref typeof(this) opAssign(typeof(null))
|
||||||
|
{
|
||||||
|
allocator.dispose(this.payload);
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref typeof(this) opAssign(typeof(this) rhs)
|
||||||
|
{
|
||||||
|
swap(this.allocator_, rhs.allocator_);
|
||||||
|
swap(this.payload, rhs.payload);
|
||||||
|
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto rc = defaultAllocator.unique!int(5);
|
||||||
|
rc = defaultAllocator.make!int(7);
|
||||||
|
assert(*rc == 7);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Reference to the owned object.
|
||||||
|
*/
|
||||||
|
inout(Payload!T) get() inout
|
||||||
|
{
|
||||||
|
return this.payload;
|
||||||
|
}
|
||||||
|
|
||||||
|
version (D_Ddoc)
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Dereferences the pointer. It is defined only for pointers, not for
|
||||||
|
* reference types like classes, that can be accessed directly.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* op = Operation.
|
||||||
|
*
|
||||||
|
* Returns: Reference to the pointed value.
|
||||||
|
*/
|
||||||
|
ref inout(T) opUnary(string op)() inout
|
||||||
|
if (op == "*");
|
||||||
|
}
|
||||||
|
else static if (isPointer!(Payload!T))
|
||||||
|
{
|
||||||
|
ref inout(T) opUnary(string op)() inout
|
||||||
|
if (op == "*")
|
||||||
|
{
|
||||||
|
return *this.payload;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Whether this $(D_PSYMBOL Unique) holds some value.
|
||||||
|
*/
|
||||||
|
@property bool isInitialized() const
|
||||||
|
{
|
||||||
|
return this.payload !is null;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
Unique!int u;
|
||||||
|
assert(!u.isInitialized);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sets the internal pointer to $(D_KEYWORD). The allocator isn't changed.
|
||||||
|
*
|
||||||
|
* Returns: Reference to the owned object.
|
||||||
|
*/
|
||||||
|
Payload!T release()
|
||||||
|
{
|
||||||
|
auto payload = this.payload;
|
||||||
|
this.payload = null;
|
||||||
|
return payload;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto u = defaultAllocator.unique!int(5);
|
||||||
|
assert(u.isInitialized);
|
||||||
|
|
||||||
|
auto i = u.release();
|
||||||
|
assert(*i == 5);
|
||||||
|
assert(!u.isInitialized);
|
||||||
|
}
|
||||||
|
|
||||||
|
mixin DefaultAllocator;
|
||||||
|
alias get this;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto p = defaultAllocator.make!int(5);
|
||||||
|
auto s = Unique!int(p, defaultAllocator);
|
||||||
|
assert(*s == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow @system unittest
|
||||||
|
{
|
||||||
|
static bool destroyed;
|
||||||
|
|
||||||
|
static struct F
|
||||||
|
{
|
||||||
|
~this() @nogc nothrow @safe
|
||||||
|
{
|
||||||
|
destroyed = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto s = Unique!F(defaultAllocator.make!F(), defaultAllocator);
|
||||||
|
}
|
||||||
|
assert(destroyed);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new object of type $(D_PARAM T) and wraps it in a
|
||||||
|
* $(D_PSYMBOL Unique) using $(D_PARAM args) as the parameter list for
|
||||||
|
* the constructor of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Type of the constructed object.
|
||||||
|
* A = Types of the arguments to the constructor of $(D_PARAM T).
|
||||||
|
* allocator = Allocator.
|
||||||
|
* args = Constructor arguments of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Returns: Newly created $(D_PSYMBOL Unique!T).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null)
|
||||||
|
*/
|
||||||
|
Unique!T unique(T, A...)(shared Allocator allocator, auto ref A args)
|
||||||
|
if (!is(T == interface) && !isAbstractClass!T
|
||||||
|
&& !isAssociativeArray!T && !isArray!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto payload = allocator.make!(T, A)(args);
|
||||||
|
return Unique!T(payload, allocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new array with $(D_PARAM size) elements and wraps it in a
|
||||||
|
* $(D_PSYMBOL Unique).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Array type.
|
||||||
|
* size = Array size.
|
||||||
|
* allocator = Allocator.
|
||||||
|
*
|
||||||
|
* Returns: Newly created $(D_PSYMBOL Unique!T).
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE allocator !is null
|
||||||
|
* && size <= size_t.max / ElementType!T.sizeof)
|
||||||
|
*/
|
||||||
|
Unique!T unique(T)(shared Allocator allocator, const size_t size)
|
||||||
|
@trusted
|
||||||
|
if (isArray!T)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(allocator !is null);
|
||||||
|
assert(size <= size_t.max / ElementType!T.sizeof);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
auto payload = allocator.resize!(ElementType!T)(null, size);
|
||||||
|
return Unique!T(payload, allocator);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(typeof(defaultAllocator.unique!B(5))));
|
||||||
|
static assert(is(typeof(defaultAllocator.unique!(int[])(5))));
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto s = defaultAllocator.unique!int(5);
|
||||||
|
assert(*s == 5);
|
||||||
|
|
||||||
|
s = null;
|
||||||
|
assert(s is null);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto s = defaultAllocator.unique!int(5);
|
||||||
|
assert(*s == 5);
|
||||||
|
|
||||||
|
s = defaultAllocator.unique!int(4);
|
||||||
|
assert(*s == 4);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto p1 = defaultAllocator.make!int(5);
|
||||||
|
auto p2 = p1;
|
||||||
|
|
||||||
|
auto rc = Unique!int(p1, defaultAllocator);
|
||||||
|
assert(rc.get() is p2);
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc nothrow pure @system unittest
|
||||||
|
{
|
||||||
|
auto rc = Unique!int(defaultAllocator);
|
||||||
|
assert(rc.allocator is defaultAllocator);
|
||||||
|
}
|
@ -1,497 +0,0 @@
|
|||||||
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
||||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
|
||||||
* Mozilla Public License, v. 2.0).
|
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
|
||||||
*/
|
|
||||||
module tanya.memory.types;
|
|
||||||
|
|
||||||
import core.exception;
|
|
||||||
import std.algorithm.comparison;
|
|
||||||
import std.algorithm.mutation;
|
|
||||||
import std.conv;
|
|
||||||
import std.range;
|
|
||||||
import std.traits;
|
|
||||||
import tanya.memory;
|
|
||||||
|
|
||||||
package(tanya) final class RefCountedStore(T)
|
|
||||||
{
|
|
||||||
T payload;
|
|
||||||
size_t counter = 1;
|
|
||||||
|
|
||||||
size_t opUnary(string op)()
|
|
||||||
if (op == "--" || op == "++")
|
|
||||||
in
|
|
||||||
{
|
|
||||||
assert(counter > 0);
|
|
||||||
}
|
|
||||||
body
|
|
||||||
{
|
|
||||||
mixin("return " ~ op ~ "counter;");
|
|
||||||
}
|
|
||||||
|
|
||||||
int opCmp(size_t counter)
|
|
||||||
{
|
|
||||||
if (this.counter > counter)
|
|
||||||
{
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
else if (this.counter < counter)
|
|
||||||
{
|
|
||||||
return -1;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
int opEquals(size_t counter)
|
|
||||||
{
|
|
||||||
return this.counter == counter;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private void separateDeleter(T)(RefCountedStore!T storage,
|
|
||||||
shared Allocator allocator)
|
|
||||||
{
|
|
||||||
allocator.dispose(storage.payload);
|
|
||||||
allocator.dispose(storage);
|
|
||||||
}
|
|
||||||
|
|
||||||
private void unifiedDeleter(T)(RefCountedStore!T storage,
|
|
||||||
shared Allocator allocator)
|
|
||||||
{
|
|
||||||
auto ptr1 = finalize(storage);
|
|
||||||
auto ptr2 = finalize(storage.payload);
|
|
||||||
allocator.deallocate(ptr1.ptr[0 .. ptr1.length + ptr2.length]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reference-counted object containing a $(D_PARAM T) value as payload.
|
|
||||||
* $(D_PSYMBOL RefCounted) keeps track of all references of an object, and
|
|
||||||
* when the reference count goes down to zero, frees the underlying store.
|
|
||||||
*
|
|
||||||
* Params:
|
|
||||||
* T = Type of the reference-counted value.
|
|
||||||
*/
|
|
||||||
struct RefCounted(T)
|
|
||||||
{
|
|
||||||
static if (is(T == class) || is(T == interface) || isArray!T)
|
|
||||||
{
|
|
||||||
private alias Payload = T;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
private alias Payload = T*;
|
|
||||||
}
|
|
||||||
private alias Storage = RefCountedStore!Payload;
|
|
||||||
|
|
||||||
private Storage storage;
|
|
||||||
private void function(Storage storage,
|
|
||||||
shared Allocator allocator) @nogc deleter;
|
|
||||||
|
|
||||||
invariant
|
|
||||||
{
|
|
||||||
assert(storage is null || allocator_ !is null);
|
|
||||||
assert(storage is null || deleter !is null);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Takes ownership over $(D_PARAM value), setting the counter to 1.
|
|
||||||
* $(D_PARAM value) may be a pointer, an object or a dynamic array.
|
|
||||||
*
|
|
||||||
* Params:
|
|
||||||
* value = Value whose ownership is taken over.
|
|
||||||
* allocator = Allocator used to destroy the $(D_PARAM value) and to
|
|
||||||
* allocate/deallocate internal storage.
|
|
||||||
*
|
|
||||||
* Precondition: $(D_INLINECODE allocator !is null)
|
|
||||||
*/
|
|
||||||
this()(auto ref Payload value,
|
|
||||||
shared Allocator allocator = defaultAllocator)
|
|
||||||
{
|
|
||||||
this(allocator);
|
|
||||||
this.storage = allocator.make!Storage();
|
|
||||||
this.deleter = &separateDeleter!Payload;
|
|
||||||
move(value, this.storage.payload);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Ditto.
|
|
||||||
this(shared Allocator allocator)
|
|
||||||
in
|
|
||||||
{
|
|
||||||
assert(allocator !is null);
|
|
||||||
}
|
|
||||||
body
|
|
||||||
{
|
|
||||||
this.allocator_ = allocator;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Increases the reference counter by one.
|
|
||||||
*/
|
|
||||||
this(this)
|
|
||||||
{
|
|
||||||
if (count != 0)
|
|
||||||
{
|
|
||||||
++storage;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Decreases the reference counter by one.
|
|
||||||
*
|
|
||||||
* If the counter reaches 0, destroys the owned object.
|
|
||||||
*/
|
|
||||||
~this()
|
|
||||||
{
|
|
||||||
if (this.storage !is null && !(this.storage.counter && --this.storage))
|
|
||||||
{
|
|
||||||
deleter(storage, allocator);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Takes ownership over $(D_PARAM rhs). Initializes this
|
|
||||||
* $(D_PSYMBOL RefCounted) if needed.
|
|
||||||
*
|
|
||||||
* If it is the last reference of the previously owned object,
|
|
||||||
* it will be destroyed.
|
|
||||||
*
|
|
||||||
* To reset the $(D_PSYMBOL RefCounted) assign $(D_KEYWORD null).
|
|
||||||
*
|
|
||||||
* If the allocator wasn't set before, $(D_PSYMBOL defaultAllocator) will
|
|
||||||
* be used. If you need a different allocator, create a new
|
|
||||||
* $(D_PSYMBOL RefCounted) and assign it.
|
|
||||||
*
|
|
||||||
* Params:
|
|
||||||
* rhs = $(D_KEYWORD this).
|
|
||||||
*/
|
|
||||||
ref typeof(this) opAssign()(auto ref Payload rhs)
|
|
||||||
{
|
|
||||||
if (this.storage is null)
|
|
||||||
{
|
|
||||||
this.storage = allocator.make!Storage();
|
|
||||||
this.deleter = &separateDeleter!Payload;
|
|
||||||
}
|
|
||||||
else if (this.storage > 1)
|
|
||||||
{
|
|
||||||
--this.storage;
|
|
||||||
this.storage = allocator.make!Storage();
|
|
||||||
this.deleter = &separateDeleter!Payload;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
// Created with refCounted. Always destroyed togethter with the pointer.
|
|
||||||
assert(this.storage.counter != 0);
|
|
||||||
finalize(this.storage.payload);
|
|
||||||
this.storage.payload = Payload.init;
|
|
||||||
}
|
|
||||||
move(rhs, this.storage.payload);
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Ditto.
|
|
||||||
ref typeof(this) opAssign(typeof(null))
|
|
||||||
{
|
|
||||||
if (this.storage is null)
|
|
||||||
{
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
else if (this.storage > 1)
|
|
||||||
{
|
|
||||||
--this.storage;
|
|
||||||
this.storage = null;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
// Created with refCounted. Always destroyed togethter with the pointer.
|
|
||||||
assert(this.storage.counter != 0);
|
|
||||||
finalize(this.storage.payload);
|
|
||||||
this.storage.payload = Payload.init;
|
|
||||||
}
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Ditto.
|
|
||||||
ref typeof(this) opAssign(typeof(this) rhs)
|
|
||||||
{
|
|
||||||
swap(this.allocator_, rhs.allocator_);
|
|
||||||
swap(this.storage, rhs.storage);
|
|
||||||
swap(this.deleter, rhs.deleter);
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Returns: Reference to the owned object.
|
|
||||||
*/
|
|
||||||
inout(Payload) get() inout pure nothrow @safe @nogc
|
|
||||||
in
|
|
||||||
{
|
|
||||||
assert(count > 0, "Attempted to access an uninitialized reference.");
|
|
||||||
}
|
|
||||||
body
|
|
||||||
{
|
|
||||||
return storage.payload;
|
|
||||||
}
|
|
||||||
|
|
||||||
static if (isPointer!Payload)
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Params:
|
|
||||||
* op = Operation.
|
|
||||||
*
|
|
||||||
* Dereferences the pointer. It is defined only for pointers, not for
|
|
||||||
* reference types like classes, that can be accessed directly.
|
|
||||||
*
|
|
||||||
* Returns: Reference to the pointed value.
|
|
||||||
*/
|
|
||||||
ref T opUnary(string op)()
|
|
||||||
if (op == "*")
|
|
||||||
{
|
|
||||||
return *storage.payload;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Returns: Whether this $(D_PSYMBOL RefCounted) already has an internal
|
|
||||||
* storage.
|
|
||||||
*/
|
|
||||||
@property bool isInitialized() const
|
|
||||||
{
|
|
||||||
return storage !is null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Returns: The number of $(D_PSYMBOL RefCounted) instances that share
|
|
||||||
* ownership over the same pointer (including $(D_KEYWORD this)).
|
|
||||||
* If this $(D_PSYMBOL RefCounted) isn't initialized, returns `0`.
|
|
||||||
*/
|
|
||||||
@property size_t count() const
|
|
||||||
{
|
|
||||||
return storage is null ? 0 : storage.counter;
|
|
||||||
}
|
|
||||||
|
|
||||||
mixin DefaultAllocator;
|
|
||||||
alias get this;
|
|
||||||
}
|
|
||||||
|
|
||||||
///
|
|
||||||
unittest
|
|
||||||
{
|
|
||||||
auto rc = RefCounted!int(defaultAllocator.make!int(5), defaultAllocator);
|
|
||||||
auto val = rc.get;
|
|
||||||
|
|
||||||
*val = 8;
|
|
||||||
assert(*rc.storage.payload == 8);
|
|
||||||
|
|
||||||
val = null;
|
|
||||||
assert(rc.storage.payload !is null);
|
|
||||||
assert(*rc.storage.payload == 8);
|
|
||||||
|
|
||||||
*rc = 9;
|
|
||||||
assert(*rc.storage.payload == 9);
|
|
||||||
}
|
|
||||||
|
|
||||||
version (unittest)
|
|
||||||
{
|
|
||||||
private class A
|
|
||||||
{
|
|
||||||
uint *destroyed;
|
|
||||||
|
|
||||||
this(ref uint destroyed) @nogc
|
|
||||||
{
|
|
||||||
this.destroyed = &destroyed;
|
|
||||||
}
|
|
||||||
|
|
||||||
~this() @nogc
|
|
||||||
{
|
|
||||||
++(*destroyed);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private struct B
|
|
||||||
{
|
|
||||||
int prop;
|
|
||||||
@disable this();
|
|
||||||
this(int param1) @nogc
|
|
||||||
{
|
|
||||||
prop = param1;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private unittest
|
|
||||||
{
|
|
||||||
uint destroyed;
|
|
||||||
auto a = defaultAllocator.make!A(destroyed);
|
|
||||||
|
|
||||||
assert(destroyed == 0);
|
|
||||||
{
|
|
||||||
auto rc = RefCounted!A(a, defaultAllocator);
|
|
||||||
assert(rc.count == 1);
|
|
||||||
|
|
||||||
void func(RefCounted!A rc)
|
|
||||||
{
|
|
||||||
assert(rc.count == 2);
|
|
||||||
}
|
|
||||||
func(rc);
|
|
||||||
|
|
||||||
assert(rc.count == 1);
|
|
||||||
}
|
|
||||||
assert(destroyed == 1);
|
|
||||||
|
|
||||||
RefCounted!int rc;
|
|
||||||
assert(rc.count == 0);
|
|
||||||
rc = defaultAllocator.make!int(8);
|
|
||||||
assert(rc.count == 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
private unittest
|
|
||||||
{
|
|
||||||
static assert(is(typeof(RefCounted!int.storage.payload) == int*));
|
|
||||||
static assert(is(typeof(RefCounted!A.storage.payload) == A));
|
|
||||||
|
|
||||||
static assert(is(RefCounted!B));
|
|
||||||
static assert(is(RefCounted!A));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Constructs a new object of type $(D_PARAM T) and wraps it in a
|
|
||||||
* $(D_PSYMBOL RefCounted) using $(D_PARAM args) as the parameter list for
|
|
||||||
* the constructor of $(D_PARAM T).
|
|
||||||
*
|
|
||||||
* This function is more efficient than the using of $(D_PSYMBOL RefCounted)
|
|
||||||
* directly, since it allocates only ones (the internal storage and the
|
|
||||||
* object).
|
|
||||||
*
|
|
||||||
* Params:
|
|
||||||
* T = Type of the constructed object.
|
|
||||||
* A = Types of the arguments to the constructor of $(D_PARAM T).
|
|
||||||
* allocator = Allocator.
|
|
||||||
* args = Constructor arguments of $(D_PARAM T).
|
|
||||||
*
|
|
||||||
* Returns: Newly created $(D_PSYMBOL RefCounted!T).
|
|
||||||
*
|
|
||||||
* Precondition: $(D_INLINECODE allocator !is null)
|
|
||||||
*/
|
|
||||||
RefCounted!T refCounted(T, A...)(shared Allocator allocator, auto ref A args)
|
|
||||||
if (!is(T == interface) && !isAbstractClass!T
|
|
||||||
&& !isAssociativeArray!T && !isArray!T)
|
|
||||||
in
|
|
||||||
{
|
|
||||||
assert(allocator !is null);
|
|
||||||
}
|
|
||||||
body
|
|
||||||
{
|
|
||||||
auto rc = typeof(return)(allocator);
|
|
||||||
|
|
||||||
const storageSize = alignedSize(stateSize!(RefCounted!T.Storage));
|
|
||||||
const size = alignedSize(stateSize!T + storageSize);
|
|
||||||
|
|
||||||
auto mem = (() @trusted => allocator.allocate(size))();
|
|
||||||
if (mem is null)
|
|
||||||
{
|
|
||||||
onOutOfMemoryError();
|
|
||||||
}
|
|
||||||
scope (failure)
|
|
||||||
{
|
|
||||||
() @trusted { allocator.deallocate(mem); }();
|
|
||||||
}
|
|
||||||
rc.storage = emplace!((RefCounted!T.Storage))(mem[0 .. storageSize]);
|
|
||||||
|
|
||||||
static if (is(T == class))
|
|
||||||
{
|
|
||||||
rc.storage.payload = emplace!T(mem[storageSize .. $], args);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
auto ptr = (() @trusted => (cast(T*) mem[storageSize .. $].ptr))();
|
|
||||||
rc.storage.payload = emplace!T(ptr, args);
|
|
||||||
}
|
|
||||||
rc.deleter = &unifiedDeleter!(RefCounted!T.Payload);
|
|
||||||
return rc;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Constructs a new array with $(D_PARAM size) elements and wraps it in a
|
|
||||||
* $(D_PSYMBOL RefCounted) using.
|
|
||||||
*
|
|
||||||
* Params:
|
|
||||||
* T = Array type.
|
|
||||||
* size = Array size.
|
|
||||||
* allocator = Allocator.
|
|
||||||
*
|
|
||||||
* Returns: Newly created $(D_PSYMBOL RefCounted!T).
|
|
||||||
*
|
|
||||||
* Precondition: $(D_INLINECODE allocator !is null
|
|
||||||
* && size <= size_t.max / ElementType!T.sizeof)
|
|
||||||
*/
|
|
||||||
RefCounted!T refCounted(T)(shared Allocator allocator, const size_t size)
|
|
||||||
if (isArray!T)
|
|
||||||
in
|
|
||||||
{
|
|
||||||
assert(allocator !is null);
|
|
||||||
assert(size <= size_t.max / ElementType!T.sizeof);
|
|
||||||
}
|
|
||||||
body
|
|
||||||
{
|
|
||||||
auto payload = cast(T) allocator.allocate(ElementType!T.sizeof * size);
|
|
||||||
initializeAll(payload);
|
|
||||||
return RefCounted!T(payload, allocator);
|
|
||||||
}
|
|
||||||
|
|
||||||
///
|
|
||||||
unittest
|
|
||||||
{
|
|
||||||
auto rc = defaultAllocator.refCounted!int(5);
|
|
||||||
assert(rc.count == 1);
|
|
||||||
|
|
||||||
void func(RefCounted!int param)
|
|
||||||
{
|
|
||||||
if (param.count == 2)
|
|
||||||
{
|
|
||||||
func(param);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
assert(param.count == 3);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
func(rc);
|
|
||||||
|
|
||||||
assert(rc.count == 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
private @nogc unittest
|
|
||||||
{
|
|
||||||
struct E
|
|
||||||
{
|
|
||||||
}
|
|
||||||
auto b = defaultAllocator.refCounted!B(15);
|
|
||||||
static assert(is(typeof(b.storage.payload) == B*));
|
|
||||||
static assert(is(typeof(b.prop) == int));
|
|
||||||
static assert(!is(typeof(defaultAllocator.refCounted!B())));
|
|
||||||
|
|
||||||
static assert(is(typeof(defaultAllocator.refCounted!E())));
|
|
||||||
static assert(!is(typeof(defaultAllocator.refCounted!E(5))));
|
|
||||||
{
|
|
||||||
auto rc = defaultAllocator.refCounted!B(3);
|
|
||||||
assert(rc.get.prop == 3);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
auto rc = defaultAllocator.refCounted!E();
|
|
||||||
assert(rc.count);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private @nogc unittest
|
|
||||||
{
|
|
||||||
auto rc = defaultAllocator.refCounted!(int[])(5);
|
|
||||||
assert(rc.length == 5);
|
|
||||||
}
|
|
1777
source/tanya/meta/metafunction.d
Normal file
1777
source/tanya/meta/metafunction.d
Normal file
File diff suppressed because it is too large
Load Diff
23
source/tanya/meta/package.d
Normal file
23
source/tanya/meta/package.d
Normal file
@ -0,0 +1,23 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Template metaprogramming.
|
||||||
|
*
|
||||||
|
* This package contains utilities to acquire type information at compile-time,
|
||||||
|
* to transform from one type to another. It has also different algorithms for
|
||||||
|
* iterating, searching and modifying template arguments.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/meta/package.d,
|
||||||
|
* tanya/meta/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.meta;
|
||||||
|
|
||||||
|
public import tanya.meta.metafunction;
|
||||||
|
public import tanya.meta.trait;
|
||||||
|
public import tanya.meta.transform;
|
3148
source/tanya/meta/trait.d
Normal file
3148
source/tanya/meta/trait.d
Normal file
File diff suppressed because it is too large
Load Diff
719
source/tanya/meta/transform.d
Normal file
719
source/tanya/meta/transform.d
Normal file
@ -0,0 +1,719 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Type transformations.
|
||||||
|
*
|
||||||
|
* Templates in this module can be used to modify type qualifiers or transform
|
||||||
|
* types. They take some type as argument and return a different type after
|
||||||
|
* perfoming the specified transformation.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/meta/transform.d,
|
||||||
|
* tanya/meta/transform.d)
|
||||||
|
*/
|
||||||
|
module tanya.meta.transform;
|
||||||
|
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Removes any type qualifiers from $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Removed qualifiers are:
|
||||||
|
* $(UL
|
||||||
|
* $(LI const)
|
||||||
|
* $(LI immutable)
|
||||||
|
* $(LI inout)
|
||||||
|
* $(LI shared)
|
||||||
|
* )
|
||||||
|
* and combinations of these.
|
||||||
|
*
|
||||||
|
* If the type $(D_PARAM T) doesn't have any qualifieres,
|
||||||
|
* $(D_INLINECODE Unqual!T) becomes an alias for $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM T) without any type qualifiers.
|
||||||
|
*/
|
||||||
|
template Unqual(T)
|
||||||
|
{
|
||||||
|
static if (is(T U == const U)
|
||||||
|
|| is(T U == immutable U)
|
||||||
|
|| is(T U == inout U)
|
||||||
|
|| is(T U == inout const U)
|
||||||
|
|| is(T U == shared U)
|
||||||
|
|| is(T U == shared const U)
|
||||||
|
|| is(T U == shared inout U)
|
||||||
|
|| is(T U == shared inout const U))
|
||||||
|
{
|
||||||
|
alias Unqual = U;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias Unqual = T;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(Unqual!bool == bool));
|
||||||
|
static assert(is(Unqual!(immutable bool) == bool));
|
||||||
|
static assert(is(Unqual!(inout bool) == bool));
|
||||||
|
static assert(is(Unqual!(inout const bool) == bool));
|
||||||
|
static assert(is(Unqual!(shared bool) == bool));
|
||||||
|
static assert(is(Unqual!(shared const bool) == bool));
|
||||||
|
static assert(is(Unqual!(shared inout const bool) == bool));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If $(D_PARAM T) is an $(D_KEYWORD enum), $(D_INLINECODE OriginalType!T)
|
||||||
|
* evaluates to the most base type of that $(D_KEYWORD enum) and to
|
||||||
|
* $(D_PARAM T) otherwise.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: Base type of the $(D_KEYWORD enum) $(D_PARAM T) or $(D_PARAM T)
|
||||||
|
* itself.
|
||||||
|
*/
|
||||||
|
template OriginalType(T)
|
||||||
|
{
|
||||||
|
static if (is(T U == enum))
|
||||||
|
{
|
||||||
|
alias OriginalType = OriginalType!U;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias OriginalType = T;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
enum E1 : const(int)
|
||||||
|
{
|
||||||
|
n = 0,
|
||||||
|
}
|
||||||
|
enum E2 : bool
|
||||||
|
{
|
||||||
|
t = true,
|
||||||
|
}
|
||||||
|
enum E3 : E2
|
||||||
|
{
|
||||||
|
t = E2.t,
|
||||||
|
}
|
||||||
|
enum E4 : const(E2)
|
||||||
|
{
|
||||||
|
t = E2.t,
|
||||||
|
}
|
||||||
|
|
||||||
|
static assert(is(OriginalType!E1 == const int));
|
||||||
|
static assert(is(OriginalType!E2 == bool));
|
||||||
|
static assert(is(OriginalType!E3 == bool));
|
||||||
|
static assert(is(OriginalType!E4 == bool));
|
||||||
|
static assert(is(OriginalType!(const E4) == bool));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copies constness of $(D_PARAM From) to $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* The following type qualifiers affect the constness and hence are copied:
|
||||||
|
* $(UL
|
||||||
|
* $(LI const)
|
||||||
|
* $(LI immutable)
|
||||||
|
* $(LI inout)
|
||||||
|
* $(LI inout const)
|
||||||
|
* )
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM To) with the constness of $(D_PARAM From).
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL CopyTypeQualifiers).
|
||||||
|
*/
|
||||||
|
template CopyConstness(From, To)
|
||||||
|
{
|
||||||
|
static if (is(From T == immutable T))
|
||||||
|
{
|
||||||
|
alias CopyConstness = immutable To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == const T) || is(From T == shared const T))
|
||||||
|
{
|
||||||
|
alias CopyConstness = const To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == inout T) || is(From T == shared inout T))
|
||||||
|
{
|
||||||
|
alias CopyConstness = inout To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == inout const T)
|
||||||
|
|| is(From T == shared inout const T))
|
||||||
|
{
|
||||||
|
alias CopyConstness = inout const To;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias CopyConstness = To;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(CopyConstness!(int, char) == char));
|
||||||
|
static assert(is(CopyConstness!(const int, char) == const char));
|
||||||
|
static assert(is(CopyConstness!(immutable int, char) == immutable char));
|
||||||
|
static assert(is(CopyConstness!(inout int, char) == inout char));
|
||||||
|
static assert(is(CopyConstness!(inout const int, char) == inout const char));
|
||||||
|
|
||||||
|
static assert(is(CopyConstness!(shared int, char) == char));
|
||||||
|
static assert(is(CopyConstness!(shared const int, char) == const char));
|
||||||
|
static assert(is(CopyConstness!(shared inout int, char) == inout char));
|
||||||
|
static assert(is(CopyConstness!(shared inout const int, char) == inout const char));
|
||||||
|
|
||||||
|
static assert(is(CopyConstness!(const int, shared char) == shared const char));
|
||||||
|
static assert(is(CopyConstness!(const int, immutable char) == immutable char));
|
||||||
|
static assert(is(CopyConstness!(immutable int, const char) == immutable char));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copies type qualifiers of $(D_PARAM From) to $(D_PARAM To).
|
||||||
|
*
|
||||||
|
* Type qualifiers copied are:
|
||||||
|
* $(UL
|
||||||
|
* $(LI const)
|
||||||
|
* $(LI immutable)
|
||||||
|
* $(LI inout)
|
||||||
|
* $(LI shared)
|
||||||
|
* )
|
||||||
|
* and combinations of these.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* From = Source type.
|
||||||
|
* To = Target type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_PARAM To) with the type qualifiers of $(D_PARAM From).
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL CopyConstness).
|
||||||
|
*/
|
||||||
|
template CopyTypeQualifiers(From, To)
|
||||||
|
{
|
||||||
|
static if (is(From T == immutable T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = immutable To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == const T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = const To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == shared T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = shared To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == shared const T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = shared const To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == inout T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = inout To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == shared inout T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = shared inout To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == inout const T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = inout const To;
|
||||||
|
}
|
||||||
|
else static if (is(From T == shared inout const T))
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = shared inout const To;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias CopyTypeQualifiers = To;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(CopyTypeQualifiers!(int, char) == char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(const int, char) == const char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(immutable int, char) == immutable char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(inout int, char) == inout char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(inout const int, char) == inout const char));
|
||||||
|
|
||||||
|
static assert(is(CopyTypeQualifiers!(shared int, char) == shared char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(shared const int, char) == shared const char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(shared inout int, char) == shared inout char));
|
||||||
|
static assert(is(CopyTypeQualifiers!(shared inout const int, char) == shared inout const char));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Evaluates to the unsigned counterpart of the integral type $(D_PARAM T) preserving all type qualifiers.
|
||||||
|
* If $(D_PARAM T) is already unsigned, $(D_INLINECODE Unsigned!T) aliases $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: Unsigned counterpart of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isSigned).
|
||||||
|
*/
|
||||||
|
template Unsigned(T)
|
||||||
|
if (isIntegral!T)
|
||||||
|
{
|
||||||
|
alias UnqualedType = Unqual!(OriginalType!T);
|
||||||
|
static if (is(UnqualedType == byte))
|
||||||
|
{
|
||||||
|
alias Unsigned = CopyTypeQualifiers!(T, ubyte);
|
||||||
|
}
|
||||||
|
else static if (is(UnqualedType == short))
|
||||||
|
{
|
||||||
|
alias Unsigned = CopyTypeQualifiers!(T, ushort);
|
||||||
|
}
|
||||||
|
else static if (is(UnqualedType == int))
|
||||||
|
{
|
||||||
|
alias Unsigned = CopyTypeQualifiers!(T, uint);
|
||||||
|
}
|
||||||
|
else static if (is(UnqualedType == long))
|
||||||
|
{
|
||||||
|
alias Unsigned = CopyTypeQualifiers!(T, ulong);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias Unsigned = T;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(Unsigned!byte == ubyte));
|
||||||
|
static assert(is(Unsigned!short == ushort));
|
||||||
|
static assert(is(Unsigned!int == uint));
|
||||||
|
static assert(is(Unsigned!long == ulong));
|
||||||
|
|
||||||
|
static assert(is(Unsigned!(const byte) == const ubyte));
|
||||||
|
static assert(is(Unsigned!(shared byte) == shared ubyte));
|
||||||
|
static assert(is(Unsigned!(shared const byte) == shared const ubyte));
|
||||||
|
|
||||||
|
static assert(!is(Unsigned!float));
|
||||||
|
static assert(is(Unsigned!ubyte == ubyte));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Evaluates to the signed counterpart of the integral type $(D_PARAM T) preserving all type qualifiers.
|
||||||
|
* If $(D_PARAM T) is already signed, $(D_INLINECODE Signed!T) aliases $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: Signed counterpart of $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL isUnsigned).
|
||||||
|
*/
|
||||||
|
template Signed(T)
|
||||||
|
if (isIntegral!T)
|
||||||
|
{
|
||||||
|
alias UnqualedType = Unqual!(OriginalType!T);
|
||||||
|
static if (is(UnqualedType == ubyte))
|
||||||
|
{
|
||||||
|
alias Signed = CopyTypeQualifiers!(T, byte);
|
||||||
|
}
|
||||||
|
else static if (is(UnqualedType == ushort))
|
||||||
|
{
|
||||||
|
alias Signed = CopyTypeQualifiers!(T, short);
|
||||||
|
}
|
||||||
|
else static if (is(UnqualedType == uint))
|
||||||
|
{
|
||||||
|
alias Signed = CopyTypeQualifiers!(T, int);
|
||||||
|
}
|
||||||
|
else static if (is(UnqualedType == ulong))
|
||||||
|
{
|
||||||
|
alias Signed = CopyTypeQualifiers!(T, long);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias Signed = T;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(Signed!ubyte == byte));
|
||||||
|
static assert(is(Signed!ushort == short));
|
||||||
|
static assert(is(Signed!uint == int));
|
||||||
|
static assert(is(Signed!ulong == long));
|
||||||
|
|
||||||
|
static assert(is(Signed!(const ubyte) == const byte));
|
||||||
|
static assert(is(Signed!(shared ubyte) == shared byte));
|
||||||
|
static assert(is(Signed!(shared const ubyte) == shared const byte));
|
||||||
|
|
||||||
|
static assert(!is(Signed!float));
|
||||||
|
static assert(is(Signed!byte == byte));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Retrieves the target type `U` of a pointer `U*`.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Pointer type.
|
||||||
|
*
|
||||||
|
* Returns: Pointer target type.
|
||||||
|
*/
|
||||||
|
template PointerTarget(T)
|
||||||
|
{
|
||||||
|
static if (is(T U : U*))
|
||||||
|
{
|
||||||
|
alias PointerTarget = U;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(T.stringof ~ " isn't a pointer type");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(PointerTarget!(bool*) == bool));
|
||||||
|
static assert(is(PointerTarget!(const bool*) == const bool));
|
||||||
|
static assert(is(PointerTarget!(const shared bool*) == const shared bool));
|
||||||
|
static assert(!is(PointerTarget!bool));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* T = The type of the associative array.
|
||||||
|
*
|
||||||
|
* Returns: The key type of the associative array $(D_PARAM T).
|
||||||
|
*/
|
||||||
|
template KeyType(T)
|
||||||
|
{
|
||||||
|
static if (is(T V : V[K], K))
|
||||||
|
{
|
||||||
|
alias KeyType = K;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false, T.stringof ~ " isn't an associative array");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(KeyType!(int[string]) == string));
|
||||||
|
static assert(!is(KeyType!(int[15])));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* T = The type of the associative array.
|
||||||
|
*
|
||||||
|
* Returns: The value type of the associative array $(D_PARAM T).
|
||||||
|
*/
|
||||||
|
template ValueType(T)
|
||||||
|
{
|
||||||
|
static if (is(T V : V[K], K))
|
||||||
|
{
|
||||||
|
alias ValueType = V;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false, T.stringof ~ " isn't an associative array");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(ValueType!(int[string]) == int));
|
||||||
|
static assert(!is(ValueType!(int[15])));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* T = Scalar type.
|
||||||
|
*
|
||||||
|
* Returns: The type $(D_PARAM T) will promote to.
|
||||||
|
*
|
||||||
|
* See_Also: $(LINK2 https://dlang.org/spec/type.html#integer-promotions,
|
||||||
|
* Integer Promotions).
|
||||||
|
*/
|
||||||
|
template Promoted(T)
|
||||||
|
if (isScalarType!T)
|
||||||
|
{
|
||||||
|
alias Promoted = CopyTypeQualifiers!(T, typeof(T.init + T.init));
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(Promoted!bool == int));
|
||||||
|
static assert(is(Promoted!byte == int));
|
||||||
|
static assert(is(Promoted!ubyte == int));
|
||||||
|
static assert(is(Promoted!short == int));
|
||||||
|
static assert(is(Promoted!ushort == int));
|
||||||
|
static assert(is(Promoted!char == int));
|
||||||
|
static assert(is(Promoted!wchar == int));
|
||||||
|
static assert(is(Promoted!dchar == uint));
|
||||||
|
|
||||||
|
static assert(is(Promoted!(const bool) == const int));
|
||||||
|
static assert(is(Promoted!(shared bool) == shared int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD inout) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE inout(T)).
|
||||||
|
*/
|
||||||
|
alias InoutOf(T) = inout(T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(InoutOf!int == inout int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD inout) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE inout(T)).
|
||||||
|
*/
|
||||||
|
alias ConstOf(T) = const(T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(ConstOf!int == const int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD inout) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE inout(T)).
|
||||||
|
*/
|
||||||
|
alias SharedOf(T) = shared(T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(SharedOf!int == shared int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD inout) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE inout(T)).
|
||||||
|
*/
|
||||||
|
alias SharedInoutOf(T) = shared(inout T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(SharedInoutOf!int == shared inout int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD shared const) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE shared(const T)).
|
||||||
|
*/
|
||||||
|
alias SharedConstOf(T) = shared(const T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(SharedConstOf!int == shared const int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD immutable) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE immutable(T)).
|
||||||
|
*/
|
||||||
|
alias ImmutableOf(T) = immutable(T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(ImmutableOf!int == immutable int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD inout const) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE inout(const T)).
|
||||||
|
*/
|
||||||
|
alias InoutConstOf(T) = inout(const T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(InoutConstOf!int == inout const int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Adds $(D_KEYWORD shared inout const) qualifier to the type $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE shared(inout const T)).
|
||||||
|
*/
|
||||||
|
alias SharedInoutConstOf(T) = shared(inout const T);
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
static assert(is(SharedInoutConstOf!int == shared inout const int));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a template with one argument which applies all qualifiers of
|
||||||
|
* $(D_PARAM T) on its argument if instantiated.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = A type.
|
||||||
|
*
|
||||||
|
* Returns: $(D_INLINECODE shared(inout const T)).
|
||||||
|
*/
|
||||||
|
template QualifierOf(T)
|
||||||
|
{
|
||||||
|
static if (is(T U == const U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = ConstOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == immutable U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = ImmutableOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == inout U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = InoutOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == inout const U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = InoutConstOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == shared U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = SharedOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == shared const U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = SharedConstOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == shared inout U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = SharedInoutOf;
|
||||||
|
}
|
||||||
|
else static if (is(T U == shared inout const U))
|
||||||
|
{
|
||||||
|
alias QualifierOf = SharedInoutConstOf;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias QualifierOf(T) = T;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
alias MutableOf = QualifierOf!int;
|
||||||
|
static assert(is(MutableOf!uint == uint));
|
||||||
|
|
||||||
|
alias ConstOf = QualifierOf!(const int);
|
||||||
|
static assert(is(ConstOf!uint == const uint));
|
||||||
|
|
||||||
|
alias InoutOf = QualifierOf!(inout int);
|
||||||
|
static assert(is(InoutOf!uint == inout uint));
|
||||||
|
|
||||||
|
alias InoutConstOf = QualifierOf!(inout const int);
|
||||||
|
static assert(is(InoutConstOf!uint == inout const uint));
|
||||||
|
|
||||||
|
alias ImmutableOf = QualifierOf!(immutable int);
|
||||||
|
static assert(is(ImmutableOf!uint == immutable uint));
|
||||||
|
|
||||||
|
alias SharedOf = QualifierOf!(shared int);
|
||||||
|
static assert(is(SharedOf!uint == shared uint));
|
||||||
|
|
||||||
|
alias SharedConstOf = QualifierOf!(shared const int);
|
||||||
|
static assert(is(SharedConstOf!uint == shared const uint));
|
||||||
|
|
||||||
|
alias SharedInoutOf = QualifierOf!(shared inout int);
|
||||||
|
static assert(is(SharedInoutOf!uint == shared inout uint));
|
||||||
|
|
||||||
|
alias SharedInoutConstOf = QualifierOf!(shared inout const int);
|
||||||
|
static assert(is(SharedInoutConstOf!uint == shared inout const uint));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determines the type of $(D_PARAM T). If $(D_PARAM T) is already a type,
|
||||||
|
* $(D_PSYMBOL TypeOf) aliases itself to $(D_PARAM T).
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL TypeOf) evaluates to $(D_KEYWORD void) for template arguments.
|
||||||
|
*
|
||||||
|
* The symbols that don't have a type and aren't types cannot be used as
|
||||||
|
* arguments to $(D_PSYMBOL TypeOf).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Expression, type or template.
|
||||||
|
*
|
||||||
|
* Returns: The type of $(D_PARAM T).
|
||||||
|
*/
|
||||||
|
alias TypeOf(T) = T;
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
template TypeOf(alias T)
|
||||||
|
if (isExpressions!T || isTemplate!T)
|
||||||
|
{
|
||||||
|
alias TypeOf = typeof(T);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
struct S(T)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
static assert(is(TypeOf!S == void));
|
||||||
|
static assert(is(TypeOf!int == int));
|
||||||
|
static assert(is(TypeOf!true == bool));
|
||||||
|
static assert(!is(TypeOf!(tanya.meta)));
|
||||||
|
}
|
@ -9,26 +9,15 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/net/inet.d,
|
||||||
|
* tanya/net/inet.d)
|
||||||
*/
|
*/
|
||||||
module tanya.network.inet;
|
module tanya.net.inet;
|
||||||
|
|
||||||
import std.math;
|
import std.math;
|
||||||
import std.range.primitives;
|
import tanya.meta.trait;
|
||||||
import std.traits;
|
import tanya.meta.transform;
|
||||||
|
import tanya.range.primitive;
|
||||||
version (unittest)
|
|
||||||
{
|
|
||||||
version (Windows)
|
|
||||||
{
|
|
||||||
import core.sys.windows.winsock2;
|
|
||||||
version = PlattformUnittest;
|
|
||||||
}
|
|
||||||
else version (Posix)
|
|
||||||
{
|
|
||||||
import core.sys.posix.arpa.inet;
|
|
||||||
version = PlattformUnittest;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Represents an unsigned integer as an $(D_KEYWORD ubyte) range.
|
* Represents an unsigned integer as an $(D_KEYWORD ubyte) range.
|
||||||
@ -210,79 +199,6 @@ private unittest
|
|||||||
static assert(!is(NetworkOrder!1));
|
static assert(!is(NetworkOrder!1));
|
||||||
}
|
}
|
||||||
|
|
||||||
// Tests against the system's htonl, htons.
|
|
||||||
version (PlattformUnittest)
|
|
||||||
{
|
|
||||||
private unittest
|
|
||||||
{
|
|
||||||
for (uint counter; counter <= 8 * uint.sizeof; ++counter)
|
|
||||||
{
|
|
||||||
const value = pow(2, counter) - 1;
|
|
||||||
const inNetworkOrder = htonl(value);
|
|
||||||
const p = cast(ubyte*) &inNetworkOrder;
|
|
||||||
auto networkOrder = NetworkOrder!4(value);
|
|
||||||
|
|
||||||
assert(networkOrder.length == 4);
|
|
||||||
assert(!networkOrder.empty);
|
|
||||||
assert(networkOrder.front == *p);
|
|
||||||
assert(networkOrder.back == *(p + 3));
|
|
||||||
|
|
||||||
networkOrder.popBack();
|
|
||||||
assert(networkOrder.length == 3);
|
|
||||||
assert(networkOrder.front == *p);
|
|
||||||
assert(networkOrder.back == *(p + 2));
|
|
||||||
|
|
||||||
networkOrder.popFront();
|
|
||||||
assert(networkOrder.length == 2);
|
|
||||||
assert(networkOrder.front == *(p + 1));
|
|
||||||
assert(networkOrder.back == *(p + 2));
|
|
||||||
|
|
||||||
networkOrder.popFront();
|
|
||||||
assert(networkOrder.length == 1);
|
|
||||||
assert(networkOrder.front == *(p + 2));
|
|
||||||
assert(networkOrder.back == *(p + 2));
|
|
||||||
|
|
||||||
networkOrder.popBack();
|
|
||||||
assert(networkOrder.length == 0);
|
|
||||||
assert(networkOrder.empty);
|
|
||||||
}
|
|
||||||
|
|
||||||
for (ushort counter; counter <= 8 * ushort.sizeof; ++counter)
|
|
||||||
{
|
|
||||||
const value = cast(ushort) (pow(2, counter) - 1);
|
|
||||||
const inNetworkOrder = htons(value);
|
|
||||||
const p = cast(ubyte*) &inNetworkOrder;
|
|
||||||
|
|
||||||
auto networkOrder = NetworkOrder!2(value);
|
|
||||||
|
|
||||||
assert(networkOrder.length == 2);
|
|
||||||
assert(!networkOrder.empty);
|
|
||||||
assert(networkOrder.front == *p);
|
|
||||||
assert(networkOrder.back == *(p + 1));
|
|
||||||
|
|
||||||
networkOrder.popBack();
|
|
||||||
assert(networkOrder.length == 1);
|
|
||||||
assert(networkOrder.front == *p);
|
|
||||||
assert(networkOrder.back == *p);
|
|
||||||
|
|
||||||
networkOrder.popBack();
|
|
||||||
assert(networkOrder.length == 0);
|
|
||||||
assert(networkOrder.empty);
|
|
||||||
|
|
||||||
networkOrder = NetworkOrder!2(value);
|
|
||||||
|
|
||||||
networkOrder.popFront();
|
|
||||||
assert(networkOrder.length == 1);
|
|
||||||
assert(networkOrder.front == *(p + 1));
|
|
||||||
assert(networkOrder.back == *(p + 1));
|
|
||||||
|
|
||||||
networkOrder.popFront();
|
|
||||||
assert(networkOrder.length == 0);
|
|
||||||
assert(networkOrder.empty);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Converts the $(D_KEYWORD ubyte) input range $(D_PARAM range) to
|
* Converts the $(D_KEYWORD ubyte) input range $(D_PARAM range) to
|
||||||
* $(D_PARAM T).
|
* $(D_PARAM T).
|
||||||
@ -328,29 +244,3 @@ pure nothrow @safe @nogc unittest
|
|||||||
auto networkOrder = NetworkOrder!4(value);
|
auto networkOrder = NetworkOrder!4(value);
|
||||||
assert(networkOrder.toHostOrder() == value);
|
assert(networkOrder.toHostOrder() == value);
|
||||||
}
|
}
|
||||||
|
|
||||||
// Tests against the system's htonl, htons.
|
|
||||||
version (PlattformUnittest)
|
|
||||||
{
|
|
||||||
private unittest
|
|
||||||
{
|
|
||||||
for (uint counter; counter <= 8 * uint.sizeof; ++counter)
|
|
||||||
{
|
|
||||||
const value = pow(2, counter) - 1;
|
|
||||||
const inNetworkOrder = htonl(value);
|
|
||||||
const p = cast(ubyte*) &inNetworkOrder;
|
|
||||||
auto networkOrder = NetworkOrder!4(value);
|
|
||||||
|
|
||||||
assert(p[0 .. uint.sizeof].toHostOrder() == value);
|
|
||||||
}
|
|
||||||
for (ushort counter; counter <= 8 * ushort.sizeof; ++counter)
|
|
||||||
{
|
|
||||||
const value = cast(ushort) (pow(2, counter) - 1);
|
|
||||||
const inNetworkOrder = htons(value);
|
|
||||||
const p = cast(ubyte*) &inNetworkOrder;
|
|
||||||
auto networkOrder = NetworkOrder!2(value);
|
|
||||||
|
|
||||||
assert(p[0 .. ushort.sizeof].toHostOrder() == value);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
18
source/tanya/net/package.d
Normal file
18
source/tanya/net/package.d
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Network programming.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/net/package.d,
|
||||||
|
* tanya/net/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.net;
|
||||||
|
|
||||||
|
public import tanya.net.inet;
|
||||||
|
public import tanya.net.uri;
|
513
source/tanya/net/uri.d
Normal file
513
source/tanya/net/uri.d
Normal file
@ -0,0 +1,513 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* URL parser.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/net/uri.d,
|
||||||
|
* tanya/net/uri.d)
|
||||||
|
*/
|
||||||
|
module tanya.net.uri;
|
||||||
|
|
||||||
|
import tanya.encoding.ascii;
|
||||||
|
import tanya.memory;
|
||||||
|
|
||||||
|
version (unittest)
|
||||||
|
{
|
||||||
|
import tanya.test.assertion;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Thrown if an invalid URI was specified.
|
||||||
|
*/
|
||||||
|
final class URIException : Exception
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* msg = The message for the exception.
|
||||||
|
* file = The file where the exception occurred.
|
||||||
|
* line = The line number where the exception occurred.
|
||||||
|
* next = The previous exception in the chain of exceptions, if any.
|
||||||
|
*/
|
||||||
|
this(string msg,
|
||||||
|
string file = __FILE__,
|
||||||
|
size_t line = __LINE__,
|
||||||
|
Throwable next = null) @nogc @safe pure nothrow
|
||||||
|
{
|
||||||
|
super(msg, file, line, next);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A Unique Resource Locator.
|
||||||
|
*/
|
||||||
|
struct URL
|
||||||
|
{
|
||||||
|
/// The URL scheme.
|
||||||
|
const(char)[] scheme;
|
||||||
|
|
||||||
|
/// The username.
|
||||||
|
const(char)[] user;
|
||||||
|
|
||||||
|
/// The password.
|
||||||
|
const(char)[] pass;
|
||||||
|
|
||||||
|
/// The hostname.
|
||||||
|
const(char)[] host;
|
||||||
|
|
||||||
|
/// The port number.
|
||||||
|
ushort port;
|
||||||
|
|
||||||
|
/// The path.
|
||||||
|
const(char)[] path;
|
||||||
|
|
||||||
|
/// The query string.
|
||||||
|
const(char)[] query;
|
||||||
|
|
||||||
|
/// The anchor.
|
||||||
|
const(char)[] fragment;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Attempts to parse an URL from a string.
|
||||||
|
* Output string data (scheme, user, etc.) are just slices of input string
|
||||||
|
* (i.e., no memory allocation and copying).
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* source = The string containing the URL.
|
||||||
|
*
|
||||||
|
* Throws: $(D_PSYMBOL URIException) if the URL is malformed.
|
||||||
|
*/
|
||||||
|
this(const char[] source) pure @nogc
|
||||||
|
{
|
||||||
|
ptrdiff_t pos = -1, endPos = source.length, start;
|
||||||
|
|
||||||
|
foreach (i, ref c; source)
|
||||||
|
{
|
||||||
|
if (pos == -1 && c == ':')
|
||||||
|
{
|
||||||
|
pos = i;
|
||||||
|
}
|
||||||
|
if (endPos == source.length && (c == '?' || c == '#'))
|
||||||
|
{
|
||||||
|
endPos = i;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check if the colon is a part of the scheme or the port and parse
|
||||||
|
// the appropriate part.
|
||||||
|
if (source.length > 1 && source[0] == '/' && source[1] == '/')
|
||||||
|
{
|
||||||
|
// Relative scheme.
|
||||||
|
start = 2;
|
||||||
|
}
|
||||||
|
else if (pos > 0)
|
||||||
|
{
|
||||||
|
// Validate scheme:
|
||||||
|
// [ toLower(alpha) | digit | "+" | "-" | "." ]
|
||||||
|
foreach (ref c; source[0 .. pos])
|
||||||
|
{
|
||||||
|
if (!c.isAlphaNum && c != '+' && c != '-' && c != '.')
|
||||||
|
{
|
||||||
|
goto ParsePath;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (source.length == pos + 1) // only "scheme:" is available.
|
||||||
|
{
|
||||||
|
this.scheme = source[0 .. $ - 1];
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
else if (source.length > pos + 1 && source[pos + 1] == '/')
|
||||||
|
{
|
||||||
|
this.scheme = source[0 .. pos];
|
||||||
|
|
||||||
|
if (source.length > pos + 2 && source[pos + 2] == '/')
|
||||||
|
{
|
||||||
|
start = pos + 3;
|
||||||
|
|
||||||
|
if (source.length <= start)
|
||||||
|
{
|
||||||
|
// Only "scheme://" is available.
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
if (this.scheme == "file" && source[start] == '/')
|
||||||
|
{
|
||||||
|
// Windows drive letters.
|
||||||
|
if (source.length - start > 2
|
||||||
|
&& source[start + 2] == ':')
|
||||||
|
{
|
||||||
|
++start;
|
||||||
|
}
|
||||||
|
goto ParsePath;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
start = pos + 1;
|
||||||
|
goto ParsePath;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
// Schemas like mailto: and zlib: may not have any slash after
|
||||||
|
// them.
|
||||||
|
if (!parsePort(source[pos .. $]))
|
||||||
|
{
|
||||||
|
this.scheme = source[0 .. pos];
|
||||||
|
start = pos + 1;
|
||||||
|
goto ParsePath;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (pos == 0 && parsePort(source[pos .. $]))
|
||||||
|
{
|
||||||
|
// An URL shouldn't begin with a port number.
|
||||||
|
throw defaultAllocator.make!URIException("URL begins with port");
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
goto ParsePath;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Parse host.
|
||||||
|
pos = -1;
|
||||||
|
for (ptrdiff_t i = start; i < source.length; ++i)
|
||||||
|
{
|
||||||
|
if (source[i] == '@')
|
||||||
|
{
|
||||||
|
pos = i;
|
||||||
|
}
|
||||||
|
else if (source[i] == '/')
|
||||||
|
{
|
||||||
|
endPos = i;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check for login and password.
|
||||||
|
if (pos != -1)
|
||||||
|
{
|
||||||
|
// *( unreserved / pct-encoded / sub-delims / ":" )
|
||||||
|
foreach (i, c; source[start .. pos])
|
||||||
|
{
|
||||||
|
if (c == ':')
|
||||||
|
{
|
||||||
|
if (this.user is null)
|
||||||
|
{
|
||||||
|
this.user = source[start .. start + i];
|
||||||
|
this.pass = source[start + i + 1 .. pos];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (!c.isAlpha() &&
|
||||||
|
!c.isDigit() &&
|
||||||
|
c != '!' &&
|
||||||
|
c != ';' &&
|
||||||
|
c != '=' &&
|
||||||
|
c != '_' &&
|
||||||
|
c != '~' &&
|
||||||
|
!(c >= '$' && c <= '.'))
|
||||||
|
{
|
||||||
|
this.scheme = this.user = this.pass = null;
|
||||||
|
throw make!URIException(defaultAllocator,
|
||||||
|
"Restricted characters in user information");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (this.user is null)
|
||||||
|
{
|
||||||
|
this.user = source[start .. pos];
|
||||||
|
}
|
||||||
|
|
||||||
|
start = ++pos;
|
||||||
|
}
|
||||||
|
|
||||||
|
pos = endPos;
|
||||||
|
if (endPos <= 1 || source[start] != '[' || source[endPos - 1] != ']')
|
||||||
|
{
|
||||||
|
// Short circuit portscan.
|
||||||
|
// IPv6 embedded address.
|
||||||
|
for (ptrdiff_t i = endPos - 1; i >= start; --i)
|
||||||
|
{
|
||||||
|
if (source[i] == ':')
|
||||||
|
{
|
||||||
|
pos = i;
|
||||||
|
if (this.port == 0 && !parsePort(source[i .. endPos]))
|
||||||
|
{
|
||||||
|
this.scheme = this.user = this.pass = null;
|
||||||
|
throw defaultAllocator.make!URIException("Invalid port");
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check if we have a valid host, if we don't reject the string as URL.
|
||||||
|
if (pos <= start)
|
||||||
|
{
|
||||||
|
this.scheme = this.user = this.pass = null;
|
||||||
|
throw defaultAllocator.make!URIException("Invalid host");
|
||||||
|
}
|
||||||
|
|
||||||
|
this.host = source[start .. pos];
|
||||||
|
|
||||||
|
if (endPos == source.length)
|
||||||
|
{
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
start = endPos;
|
||||||
|
|
||||||
|
ParsePath:
|
||||||
|
endPos = source.length;
|
||||||
|
pos = -1;
|
||||||
|
foreach (i, ref c; source[start .. $])
|
||||||
|
{
|
||||||
|
if (c == '?' && pos == -1)
|
||||||
|
{
|
||||||
|
pos = start + i;
|
||||||
|
}
|
||||||
|
else if (c == '#')
|
||||||
|
{
|
||||||
|
endPos = start + i;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (pos == -1)
|
||||||
|
{
|
||||||
|
pos = endPos;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (pos > start)
|
||||||
|
{
|
||||||
|
this.path = source[start .. pos];
|
||||||
|
}
|
||||||
|
if (endPos >= ++pos)
|
||||||
|
{
|
||||||
|
this.query = source[pos .. endPos];
|
||||||
|
}
|
||||||
|
if (++endPos <= source.length)
|
||||||
|
{
|
||||||
|
this.fragment = source[endPos .. $];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Attempts to parse and set the port.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* port = String beginning with a colon followed by the port number and
|
||||||
|
* an optional path (query string and/or fragment), like:
|
||||||
|
* `:12345/some_path` or `:12345`.
|
||||||
|
*
|
||||||
|
* Returns: Whether the port could be found.
|
||||||
|
*/
|
||||||
|
private bool parsePort(const char[] port) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
ptrdiff_t i = 1;
|
||||||
|
float lPort = 0;
|
||||||
|
|
||||||
|
for (; i < port.length && port[i].isDigit() && i <= 6; ++i)
|
||||||
|
{
|
||||||
|
lPort += (port[i] - '0') / cast(float) (10 ^^ (i - 1));
|
||||||
|
}
|
||||||
|
if (i != 1 && (i == port.length || port[i] == '/'))
|
||||||
|
{
|
||||||
|
lPort *= 10 ^^ (i - 2);
|
||||||
|
if (lPort > ushort.max)
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
this.port = cast(ushort) lPort;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc pure @system unittest
|
||||||
|
{
|
||||||
|
auto u = URL("example.org");
|
||||||
|
assert(u.path == "example.org");
|
||||||
|
|
||||||
|
u = URL("relative/path");
|
||||||
|
assert(u.path == "relative/path");
|
||||||
|
|
||||||
|
// Host and scheme
|
||||||
|
u = URL("https://example.org");
|
||||||
|
assert(u.scheme == "https");
|
||||||
|
assert(u.host == "example.org");
|
||||||
|
assert(u.path is null);
|
||||||
|
assert(u.port == 0);
|
||||||
|
assert(u.fragment is null);
|
||||||
|
|
||||||
|
// With user and port and path
|
||||||
|
u = URL("https://hilary:putnam@example.org:443/foo/bar");
|
||||||
|
assert(u.scheme == "https");
|
||||||
|
assert(u.host == "example.org");
|
||||||
|
assert(u.path == "/foo/bar");
|
||||||
|
assert(u.port == 443);
|
||||||
|
assert(u.user == "hilary");
|
||||||
|
assert(u.pass == "putnam");
|
||||||
|
assert(u.fragment is null);
|
||||||
|
|
||||||
|
// With query string
|
||||||
|
u = URL("https://example.org/?login=true");
|
||||||
|
assert(u.scheme == "https");
|
||||||
|
assert(u.host == "example.org");
|
||||||
|
assert(u.path == "/");
|
||||||
|
assert(u.query == "login=true");
|
||||||
|
assert(u.fragment is null);
|
||||||
|
|
||||||
|
// With query string and fragment
|
||||||
|
u = URL("https://example.org/?login=false#label");
|
||||||
|
assert(u.scheme == "https");
|
||||||
|
assert(u.host == "example.org");
|
||||||
|
assert(u.path == "/");
|
||||||
|
assert(u.query == "login=false");
|
||||||
|
assert(u.fragment == "label");
|
||||||
|
|
||||||
|
u = URL("redis://root:password@localhost:2201/path?query=value#fragment");
|
||||||
|
assert(u.scheme == "redis");
|
||||||
|
assert(u.user == "root");
|
||||||
|
assert(u.pass == "password");
|
||||||
|
assert(u.host == "localhost");
|
||||||
|
assert(u.port == 2201);
|
||||||
|
assert(u.path == "/path");
|
||||||
|
assert(u.query == "query=value");
|
||||||
|
assert(u.fragment == "fragment");
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @system unittest
|
||||||
|
{
|
||||||
|
auto u = URL("127.0.0.1");
|
||||||
|
assert(u.path == "127.0.0.1");
|
||||||
|
|
||||||
|
u = URL("http://127.0.0.1");
|
||||||
|
assert(u.scheme == "http");
|
||||||
|
assert(u.host == "127.0.0.1");
|
||||||
|
|
||||||
|
u = URL("http://127.0.0.1:9000");
|
||||||
|
assert(u.scheme == "http");
|
||||||
|
assert(u.host == "127.0.0.1");
|
||||||
|
assert(u.port == 9000);
|
||||||
|
|
||||||
|
u = URL("127.0.0.1:80");
|
||||||
|
assert(u.host == "127.0.0.1");
|
||||||
|
assert(u.port == 80);
|
||||||
|
assert(u.path is null);
|
||||||
|
|
||||||
|
u = URL("//example.net");
|
||||||
|
assert(u.host == "example.net");
|
||||||
|
assert(u.scheme is null);
|
||||||
|
|
||||||
|
u = URL("//example.net?q=before:after");
|
||||||
|
assert(u.host == "example.net");
|
||||||
|
assert(u.query == "q=before:after");
|
||||||
|
|
||||||
|
u = URL("localhost:8080");
|
||||||
|
assert(u.host == "localhost");
|
||||||
|
assert(u.port == 8080);
|
||||||
|
assert(u.path is null);
|
||||||
|
|
||||||
|
u = URL("ftp:");
|
||||||
|
assert(u.scheme == "ftp");
|
||||||
|
|
||||||
|
u = URL("file:///C:\\Users");
|
||||||
|
assert(u.scheme == "file");
|
||||||
|
assert(u.path == "C:\\Users");
|
||||||
|
|
||||||
|
u = URL("localhost:66000");
|
||||||
|
assert(u.scheme == "localhost");
|
||||||
|
assert(u.path == "66000");
|
||||||
|
|
||||||
|
u = URL("file:///home/");
|
||||||
|
assert(u.scheme == "file");
|
||||||
|
assert(u.path == "/home/");
|
||||||
|
|
||||||
|
u = URL("file:///home/?q=asdf");
|
||||||
|
assert(u.scheme == "file");
|
||||||
|
assert(u.path == "/home/");
|
||||||
|
assert(u.query == "q=asdf");
|
||||||
|
|
||||||
|
u = URL("http://secret@example.org");
|
||||||
|
assert(u.scheme == "http");
|
||||||
|
assert(u.host == "example.org");
|
||||||
|
assert(u.user == "secret");
|
||||||
|
|
||||||
|
u = URL("h_tp://:80");
|
||||||
|
assert(u.path == "h_tp://:80");
|
||||||
|
assert(u.port == 0);
|
||||||
|
|
||||||
|
u = URL("zlib:/home/user/file.gz");
|
||||||
|
assert(u.scheme == "zlib");
|
||||||
|
assert(u.path == "/home/user/file.gz");
|
||||||
|
|
||||||
|
u = URL("h_tp:asdf");
|
||||||
|
assert(u.path == "h_tp:asdf");
|
||||||
|
}
|
||||||
|
|
||||||
|
@nogc pure @system unittest
|
||||||
|
{
|
||||||
|
assertThrown!URIException(() => URL("http://:80"));
|
||||||
|
assertThrown!URIException(() => URL(":80"));
|
||||||
|
assertThrown!URIException(() => URL("http://u1:p1@u2:p2@example.org"));
|
||||||
|
assertThrown!URIException(() => URL("http://blah.com:port"));
|
||||||
|
assertThrown!URIException(() => URL("http://blah.com:66000"));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Issue 254: https://issues.caraus.io/issues/254.
|
||||||
|
@nogc pure @system unittest
|
||||||
|
{
|
||||||
|
auto u = URL("ftp://");
|
||||||
|
assert(u.scheme == "ftp");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Attempts to parse an URL from a string and returns the specified component
|
||||||
|
* of the URL or $(D_PSYMBOL URL) if no component is specified.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = "scheme", "host", "port", "user", "pass", "path", "query",
|
||||||
|
* "fragment".
|
||||||
|
* source = The string containing the URL.
|
||||||
|
*
|
||||||
|
* Returns: Requested URL component.
|
||||||
|
*/
|
||||||
|
auto parseURL(string T)(const char[] source)
|
||||||
|
if (T == "scheme"
|
||||||
|
|| T == "host"
|
||||||
|
|| T == "user"
|
||||||
|
|| T == "pass"
|
||||||
|
|| T == "path"
|
||||||
|
|| T == "query"
|
||||||
|
|| T == "fragment"
|
||||||
|
|| T == "port")
|
||||||
|
{
|
||||||
|
auto ret = URL(source);
|
||||||
|
return mixin("ret." ~ T);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
URL parseURL(const char[] source) @nogc pure
|
||||||
|
{
|
||||||
|
return URL(source);
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc pure @system unittest
|
||||||
|
{
|
||||||
|
auto u = parseURL("http://example.org:5326");
|
||||||
|
assert(u.scheme == parseURL!"scheme"("http://example.org:5326"));
|
||||||
|
assert(u.host == parseURL!"host"("http://example.org:5326"));
|
||||||
|
assert(u.user == parseURL!"user"("http://example.org:5326"));
|
||||||
|
assert(u.pass == parseURL!"pass"("http://example.org:5326"));
|
||||||
|
assert(u.path == parseURL!"path"("http://example.org:5326"));
|
||||||
|
assert(u.query == parseURL!"query"("http://example.org:5326"));
|
||||||
|
assert(u.fragment == parseURL!"fragment"("http://example.org:5326"));
|
||||||
|
assert(u.port == parseURL!"port"("http://example.org:5326"));
|
||||||
|
}
|
@ -9,9 +9,9 @@
|
|||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/network/package.d,
|
||||||
|
* tanya/network/package.d)
|
||||||
*/
|
*/
|
||||||
module tanya.network;
|
module tanya.network;
|
||||||
|
|
||||||
public import tanya.network.inet;
|
|
||||||
public import tanya.network.socket;
|
public import tanya.network.socket;
|
||||||
public import tanya.network.url;
|
|
||||||
|
@ -3,24 +3,27 @@
|
|||||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Socket programming.
|
* Low-level socket programming.
|
||||||
*
|
*
|
||||||
* Copyright: Eugene Wissner 2016-2017.
|
* Copyright: Eugene Wissner 2016-2017.
|
||||||
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
* Mozilla Public License, v. 2.0).
|
* Mozilla Public License, v. 2.0).
|
||||||
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/network/socket.d,
|
||||||
|
* tanya/network/socket.d)
|
||||||
*/
|
*/
|
||||||
module tanya.network.socket;
|
module tanya.network.socket;
|
||||||
|
|
||||||
import tanya.memory;
|
|
||||||
import core.stdc.errno;
|
import core.stdc.errno;
|
||||||
import core.time;
|
import core.time;
|
||||||
import std.algorithm.comparison;
|
import std.algorithm.comparison;
|
||||||
import std.algorithm.searching;
|
public import std.socket : SocketOption, SocketOptionLevel;
|
||||||
public import std.socket : socket_t, Linger, SocketOptionLevel, SocketOption,
|
|
||||||
SocketType, AddressFamily, AddressInfo;
|
|
||||||
import std.traits;
|
import std.traits;
|
||||||
import std.typecons;
|
import std.typecons;
|
||||||
|
import tanya.memory;
|
||||||
|
|
||||||
|
/// Value returned by socket operations on error.
|
||||||
|
enum int socketError = -1;
|
||||||
|
|
||||||
version (Posix)
|
version (Posix)
|
||||||
{
|
{
|
||||||
@ -32,180 +35,68 @@ version (Posix)
|
|||||||
import core.sys.posix.sys.time;
|
import core.sys.posix.sys.time;
|
||||||
import core.sys.posix.unistd;
|
import core.sys.posix.unistd;
|
||||||
|
|
||||||
private enum SOCKET_ERROR = -1;
|
enum SocketType : int
|
||||||
|
{
|
||||||
|
init = -1,
|
||||||
|
}
|
||||||
|
|
||||||
|
private alias LingerField = int;
|
||||||
}
|
}
|
||||||
else version (Windows)
|
else version (Windows)
|
||||||
{
|
{
|
||||||
|
import core.sys.windows.winbase : ERROR_IO_INCOMPLETE,
|
||||||
|
ERROR_IO_PENDING,
|
||||||
|
GetModuleHandle,
|
||||||
|
GetProcAddress;
|
||||||
|
import core.sys.windows.winsock2 : accept,
|
||||||
|
addrinfo,
|
||||||
|
bind,
|
||||||
|
closesocket,
|
||||||
|
FIONBIO,
|
||||||
|
freeaddrinfo,
|
||||||
|
getaddrinfo,
|
||||||
|
getsockopt,
|
||||||
|
ioctlsocket,
|
||||||
|
listen,
|
||||||
|
MSG_DONTROUTE,
|
||||||
|
MSG_OOB,
|
||||||
|
MSG_PEEK,
|
||||||
|
recv,
|
||||||
|
SD_BOTH,
|
||||||
|
SD_RECEIVE,
|
||||||
|
SD_SEND,
|
||||||
|
send,
|
||||||
|
setsockopt,
|
||||||
|
shutdown,
|
||||||
|
SOCKADDR,
|
||||||
|
sockaddr,
|
||||||
|
sockaddr_in,
|
||||||
|
sockaddr_in6,
|
||||||
|
SOCKADDR_STORAGE,
|
||||||
|
socket,
|
||||||
|
socklen_t,
|
||||||
|
SOL_SOCKET,
|
||||||
|
SO_TYPE,
|
||||||
|
WSAGetLastError;
|
||||||
import tanya.async.iocp;
|
import tanya.async.iocp;
|
||||||
import core.sys.windows.basetyps;
|
import tanya.sys.windows.def;
|
||||||
import core.sys.windows.mswsock;
|
import tanya.sys.windows.error : ECONNABORTED = WSAECONNABORTED,
|
||||||
import core.sys.windows.winbase;
|
ENOBUFS = WSAENOBUFS,
|
||||||
import core.sys.windows.windef;
|
EOPNOTSUPP = WSAEOPNOTSUPP,
|
||||||
import core.sys.windows.winsock2;
|
EPROTONOSUPPORT = WSAEPROTONOSUPPORT,
|
||||||
|
EPROTOTYPE = WSAEPROTOTYPE,
|
||||||
|
ESOCKTNOSUPPORT = WSAESOCKTNOSUPPORT,
|
||||||
|
ETIMEDOUT = WSAETIMEDOUT,
|
||||||
|
EWOULDBLOCK = WSAEWOULDBLOCK;
|
||||||
|
public import tanya.sys.windows.winbase;
|
||||||
|
public import tanya.sys.windows.winsock2;
|
||||||
|
|
||||||
enum : uint
|
enum SocketType : size_t
|
||||||
{
|
{
|
||||||
IOC_UNIX = 0x00000000,
|
init = ~0,
|
||||||
IOC_WS2 = 0x08000000,
|
|
||||||
IOC_PROTOCOL = 0x10000000,
|
|
||||||
IOC_VOID = 0x20000000, /// No parameters.
|
|
||||||
IOC_OUT = 0x40000000, /// Copy parameters back.
|
|
||||||
IOC_IN = 0x80000000, /// Copy parameters into.
|
|
||||||
IOC_VENDOR = 0x18000000,
|
|
||||||
IOC_INOUT = (IOC_IN | IOC_OUT), /// Copy parameter into and get back.
|
|
||||||
}
|
}
|
||||||
|
|
||||||
template _WSAIO(int x, int y)
|
private alias LingerField = ushort;
|
||||||
{
|
|
||||||
enum _WSAIO = IOC_VOID | x | y;
|
|
||||||
}
|
|
||||||
template _WSAIOR(int x, int y)
|
|
||||||
{
|
|
||||||
enum _WSAIOR = IOC_OUT | x | y;
|
|
||||||
}
|
|
||||||
template _WSAIOW(int x, int y)
|
|
||||||
{
|
|
||||||
enum _WSAIOW = IOC_IN | x | y;
|
|
||||||
}
|
|
||||||
template _WSAIORW(int x, int y)
|
|
||||||
{
|
|
||||||
enum _WSAIORW = IOC_INOUT | x | y;
|
|
||||||
}
|
|
||||||
|
|
||||||
alias SIO_ASSOCIATE_HANDLE = _WSAIOW!(IOC_WS2, 1);
|
|
||||||
alias SIO_ENABLE_CIRCULAR_QUEUEING = _WSAIO!(IOC_WS2, 2);
|
|
||||||
alias SIO_FIND_ROUTE = _WSAIOR!(IOC_WS2, 3);
|
|
||||||
alias SIO_FLUSH = _WSAIO!(IOC_WS2, 4);
|
|
||||||
alias SIO_GET_BROADCAST_ADDRESS = _WSAIOR!(IOC_WS2, 5);
|
|
||||||
alias SIO_GET_EXTENSION_FUNCTION_POINTER = _WSAIORW!(IOC_WS2, 6);
|
|
||||||
alias SIO_GET_QOS = _WSAIORW!(IOC_WS2, 7);
|
|
||||||
alias SIO_GET_GROUP_QOS = _WSAIORW!(IOC_WS2, 8);
|
|
||||||
alias SIO_MULTIPOINT_LOOPBACK = _WSAIOW!(IOC_WS2, 9);
|
|
||||||
alias SIO_MULTICAST_SCOPE = _WSAIOW!(IOC_WS2, 10);
|
|
||||||
alias SIO_SET_QOS = _WSAIOW!(IOC_WS2, 11);
|
|
||||||
alias SIO_SET_GROUP_QOS = _WSAIOW!(IOC_WS2, 12);
|
|
||||||
alias SIO_TRANSLATE_HANDLE = _WSAIORW!(IOC_WS2, 13);
|
|
||||||
alias SIO_ROUTING_INTERFACE_QUERY = _WSAIORW!(IOC_WS2, 20);
|
|
||||||
alias SIO_ROUTING_INTERFACE_CHANGE = _WSAIOW!(IOC_WS2, 21);
|
|
||||||
alias SIO_ADDRESS_LIST_QUERY = _WSAIOR!(IOC_WS2, 22);
|
|
||||||
alias SIO_ADDRESS_LIST_CHANGE = _WSAIO!(IOC_WS2, 23);
|
|
||||||
alias SIO_QUERY_TARGET_PNP_HANDLE = _WSAIOR!(IOC_WS2, 24);
|
|
||||||
alias SIO_NSP_NOTIFY_CHANGE = _WSAIOW!(IOC_WS2, 25);
|
|
||||||
|
|
||||||
private alias GROUP = uint;
|
|
||||||
|
|
||||||
enum
|
|
||||||
{
|
|
||||||
WSA_FLAG_OVERLAPPED = 0x01,
|
|
||||||
MAX_PROTOCOL_CHAIN = 7,
|
|
||||||
WSAPROTOCOL_LEN = 255,
|
|
||||||
}
|
|
||||||
|
|
||||||
struct WSAPROTOCOLCHAIN
|
|
||||||
{
|
|
||||||
int ChainLen;
|
|
||||||
DWORD[MAX_PROTOCOL_CHAIN] ChainEntries;
|
|
||||||
}
|
|
||||||
alias LPWSAPROTOCOLCHAIN = WSAPROTOCOLCHAIN*;
|
|
||||||
|
|
||||||
struct WSAPROTOCOL_INFO
|
|
||||||
{
|
|
||||||
DWORD dwServiceFlags1;
|
|
||||||
DWORD dwServiceFlags2;
|
|
||||||
DWORD dwServiceFlags3;
|
|
||||||
DWORD dwServiceFlags4;
|
|
||||||
DWORD dwProviderFlags;
|
|
||||||
GUID ProviderId;
|
|
||||||
DWORD dwCatalogEntryId;
|
|
||||||
WSAPROTOCOLCHAIN ProtocolChain;
|
|
||||||
int iVersion;
|
|
||||||
int iAddressFamily;
|
|
||||||
int iMaxSockAddr;
|
|
||||||
int iMinSockAddr;
|
|
||||||
int iSocketType;
|
|
||||||
int iProtocol;
|
|
||||||
int iProtocolMaxOffset;
|
|
||||||
int iNetworkByteOrder;
|
|
||||||
int iSecurityScheme;
|
|
||||||
DWORD dwMessageSize;
|
|
||||||
DWORD dwProviderReserved;
|
|
||||||
TCHAR[WSAPROTOCOL_LEN + 1] szProtocol;
|
|
||||||
}
|
|
||||||
alias LPWSAPROTOCOL_INFO = WSAPROTOCOL_INFO*;
|
|
||||||
|
|
||||||
extern (Windows) @nogc nothrow
|
|
||||||
{
|
|
||||||
private SOCKET WSASocketW(int af,
|
|
||||||
int type,
|
|
||||||
int protocol,
|
|
||||||
LPWSAPROTOCOL_INFO lpProtocolInfo,
|
|
||||||
GROUP g,
|
|
||||||
DWORD dwFlags);
|
|
||||||
int WSARecv(SOCKET s,
|
|
||||||
LPWSABUF lpBuffers,
|
|
||||||
DWORD dwBufferCount,
|
|
||||||
LPDWORD lpNumberOfBytesRecvd,
|
|
||||||
LPDWORD lpFlags,
|
|
||||||
LPOVERLAPPED lpOverlapped,
|
|
||||||
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
|
|
||||||
int WSASend(SOCKET s,
|
|
||||||
LPWSABUF lpBuffers,
|
|
||||||
DWORD dwBufferCount,
|
|
||||||
LPDWORD lpNumberOfBytesRecvd,
|
|
||||||
DWORD lpFlags,
|
|
||||||
LPOVERLAPPED lpOverlapped,
|
|
||||||
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
|
|
||||||
int WSAIoctl(SOCKET s,
|
|
||||||
uint dwIoControlCode,
|
|
||||||
void* lpvInBuffer,
|
|
||||||
uint cbInBuffer,
|
|
||||||
void* lpvOutBuffer,
|
|
||||||
uint cbOutBuffer,
|
|
||||||
uint* lpcbBytesReturned,
|
|
||||||
LPWSAOVERLAPPED lpOverlapped,
|
|
||||||
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine);
|
|
||||||
alias LPFN_ACCEPTEX = BOOL function(SOCKET,
|
|
||||||
SOCKET,
|
|
||||||
PVOID,
|
|
||||||
DWORD,
|
|
||||||
DWORD,
|
|
||||||
DWORD,
|
|
||||||
LPDWORD,
|
|
||||||
LPOVERLAPPED);
|
|
||||||
}
|
|
||||||
alias WSASocket = WSASocketW;
|
|
||||||
|
|
||||||
alias LPFN_GETACCEPTEXSOCKADDRS = VOID function(PVOID,
|
|
||||||
DWORD,
|
|
||||||
DWORD,
|
|
||||||
DWORD,
|
|
||||||
SOCKADDR**,
|
|
||||||
LPINT,
|
|
||||||
SOCKADDR**,
|
|
||||||
LPINT);
|
|
||||||
const GUID WSAID_GETACCEPTEXSOCKADDRS = {0xb5367df2,0xcbac,0x11cf,[0x95,0xca,0x00,0x80,0x5f,0x48,0xa1,0x92]};
|
|
||||||
|
|
||||||
struct WSABUF {
|
|
||||||
ULONG len;
|
|
||||||
CHAR* buf;
|
|
||||||
}
|
|
||||||
alias WSABUF* LPWSABUF;
|
|
||||||
|
|
||||||
struct WSAOVERLAPPED {
|
|
||||||
ULONG_PTR Internal;
|
|
||||||
ULONG_PTR InternalHigh;
|
|
||||||
union {
|
|
||||||
struct {
|
|
||||||
DWORD Offset;
|
|
||||||
DWORD OffsetHigh;
|
|
||||||
}
|
|
||||||
PVOID Pointer;
|
|
||||||
}
|
|
||||||
HANDLE hEvent;
|
|
||||||
}
|
|
||||||
alias LPWSAOVERLAPPED = WSAOVERLAPPED*;
|
|
||||||
|
|
||||||
enum SO_UPDATE_ACCEPT_CONTEXT = 0x700B;
|
|
||||||
|
|
||||||
enum OverlappedSocketEvent
|
enum OverlappedSocketEvent
|
||||||
{
|
{
|
||||||
@ -221,6 +112,8 @@ else version (Windows)
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Socket returned if a connection has been established.
|
* Socket returned if a connection has been established.
|
||||||
|
*
|
||||||
|
* Note: Available only on Windows.
|
||||||
*/
|
*/
|
||||||
class OverlappedConnectedSocket : ConnectedSocket
|
class OverlappedConnectedSocket : ConnectedSocket
|
||||||
{
|
{
|
||||||
@ -231,7 +124,7 @@ else version (Windows)
|
|||||||
* handle = Socket handle.
|
* handle = Socket handle.
|
||||||
* af = Address family.
|
* af = Address family.
|
||||||
*/
|
*/
|
||||||
this(socket_t handle, AddressFamily af) @nogc
|
this(SocketType handle, AddressFamily af) @nogc
|
||||||
{
|
{
|
||||||
super(handle, af);
|
super(handle, af);
|
||||||
}
|
}
|
||||||
@ -261,14 +154,14 @@ else version (Windows)
|
|||||||
overlapped.buffer.buf = cast(char*) buffer.ptr;
|
overlapped.buffer.buf = cast(char*) buffer.ptr;
|
||||||
|
|
||||||
auto result = WSARecv(handle_,
|
auto result = WSARecv(handle_,
|
||||||
&overlapped.buffer,
|
cast(WSABUF*) &overlapped.buffer,
|
||||||
1u,
|
1u,
|
||||||
NULL,
|
null,
|
||||||
&receiveFlags,
|
&receiveFlags,
|
||||||
&overlapped.overlapped,
|
&overlapped.overlapped,
|
||||||
NULL);
|
null);
|
||||||
|
|
||||||
if (result == SOCKET_ERROR && !wouldHaveBlocked)
|
if (result == socketError && !wouldHaveBlocked)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to receive");
|
throw defaultAllocator.make!SocketException("Unable to receive");
|
||||||
}
|
}
|
||||||
@ -278,12 +171,14 @@ else version (Windows)
|
|||||||
/**
|
/**
|
||||||
* Ends a pending asynchronous read.
|
* Ends a pending asynchronous read.
|
||||||
*
|
*
|
||||||
* Params
|
* Params:
|
||||||
* overlapped = Unique operation identifier.
|
* overlapped = Unique operation identifier.
|
||||||
*
|
*
|
||||||
* Returns: Number of bytes received.
|
* Returns: Number of bytes received.
|
||||||
*
|
*
|
||||||
* Throws: $(D_PSYMBOL SocketException) if unable to receive.
|
* Throws: $(D_PSYMBOL SocketException) if unable to receive.
|
||||||
|
*
|
||||||
|
* Postcondition: $(D_INLINECODE result >= 0).
|
||||||
*/
|
*/
|
||||||
int endReceive(SocketState overlapped) @nogc @trusted
|
int endReceive(SocketState overlapped) @nogc @trusted
|
||||||
out (count)
|
out (count)
|
||||||
@ -334,12 +229,12 @@ else version (Windows)
|
|||||||
auto result = WSASend(handle_,
|
auto result = WSASend(handle_,
|
||||||
&overlapped.buffer,
|
&overlapped.buffer,
|
||||||
1u,
|
1u,
|
||||||
NULL,
|
null,
|
||||||
cast(DWORD) flags,
|
cast(DWORD) flags,
|
||||||
&overlapped.overlapped,
|
&overlapped.overlapped,
|
||||||
NULL);
|
null);
|
||||||
|
|
||||||
if (result == SOCKET_ERROR && !wouldHaveBlocked)
|
if (result == socketError && !wouldHaveBlocked)
|
||||||
{
|
{
|
||||||
disconnected_ = true;
|
disconnected_ = true;
|
||||||
throw defaultAllocator.make!SocketException("Unable to send");
|
throw defaultAllocator.make!SocketException("Unable to send");
|
||||||
@ -350,12 +245,14 @@ else version (Windows)
|
|||||||
/**
|
/**
|
||||||
* Ends a pending asynchronous send.
|
* Ends a pending asynchronous send.
|
||||||
*
|
*
|
||||||
* Params
|
* Params:
|
||||||
* overlapped = Unique operation identifier.
|
* overlapped = Unique operation identifier.
|
||||||
*
|
*
|
||||||
* Returns: Number of bytes sent.
|
* Returns: Number of bytes sent.
|
||||||
*
|
*
|
||||||
* Throws: $(D_PSYMBOL SocketException) if unable to receive.
|
* Throws: $(D_PSYMBOL SocketException) if unable to receive.
|
||||||
|
*
|
||||||
|
* Postcondition: $(D_INLINECODE result >= 0).
|
||||||
*/
|
*/
|
||||||
int endSend(SocketState overlapped) @nogc @trusted
|
int endSend(SocketState overlapped) @nogc @trusted
|
||||||
out (count)
|
out (count)
|
||||||
@ -378,9 +275,12 @@ else version (Windows)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Windows stream socket overlapped I/O.
|
||||||
|
*/
|
||||||
class OverlappedStreamSocket : StreamSocket
|
class OverlappedStreamSocket : StreamSocket
|
||||||
{
|
{
|
||||||
/// Accept extension function pointer.
|
// Accept extension function pointer.
|
||||||
package LPFN_ACCEPTEX acceptExtension;
|
package LPFN_ACCEPTEX acceptExtension;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -410,9 +310,9 @@ else version (Windows)
|
|||||||
&acceptExtension,
|
&acceptExtension,
|
||||||
acceptExtension.sizeof,
|
acceptExtension.sizeof,
|
||||||
&dwBytes,
|
&dwBytes,
|
||||||
NULL,
|
null,
|
||||||
NULL);
|
null);
|
||||||
if (!result == SOCKET_ERROR)
|
if (!result == socketError)
|
||||||
{
|
{
|
||||||
throw make!SocketException(defaultAllocator,
|
throw make!SocketException(defaultAllocator,
|
||||||
"Unable to retrieve an accept extension function pointer");
|
"Unable to retrieve an accept extension function pointer");
|
||||||
@ -432,8 +332,8 @@ else version (Windows)
|
|||||||
*/
|
*/
|
||||||
bool beginAccept(SocketState overlapped) @nogc @trusted
|
bool beginAccept(SocketState overlapped) @nogc @trusted
|
||||||
{
|
{
|
||||||
auto socket = cast(socket_t) socket(addressFamily, SOCK_STREAM, 0);
|
auto socket = cast(SocketType) socket(addressFamily, 1, 0);
|
||||||
if (socket == socket_t.init)
|
if (socket == SocketType.init)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to create socket");
|
throw defaultAllocator.make!SocketException("Unable to create socket");
|
||||||
}
|
}
|
||||||
@ -445,7 +345,7 @@ else version (Windows)
|
|||||||
overlapped.handle = cast(HANDLE) socket;
|
overlapped.handle = cast(HANDLE) socket;
|
||||||
overlapped.event = OverlappedSocketEvent.accept;
|
overlapped.event = OverlappedSocketEvent.accept;
|
||||||
|
|
||||||
immutable len = (sockaddr_in.sizeof + 16) * 2;
|
const len = (sockaddr_in.sizeof + 16) * 2;
|
||||||
overlapped.buffer.len = len;
|
overlapped.buffer.len = len;
|
||||||
overlapped.buffer.buf = cast(char*) defaultAllocator.allocate(len).ptr;
|
overlapped.buffer.buf = cast(char*) defaultAllocator.allocate(len).ptr;
|
||||||
|
|
||||||
@ -476,14 +376,15 @@ else version (Windows)
|
|||||||
*
|
*
|
||||||
* Throws: $(D_PSYMBOL SocketException) if unable to accept.
|
* Throws: $(D_PSYMBOL SocketException) if unable to accept.
|
||||||
*/
|
*/
|
||||||
OverlappedConnectedSocket endAccept(SocketState overlapped) @nogc @trusted
|
OverlappedConnectedSocket endAccept(SocketState overlapped)
|
||||||
|
@nogc @trusted
|
||||||
{
|
{
|
||||||
scope (exit)
|
scope (exit)
|
||||||
{
|
{
|
||||||
defaultAllocator.dispose(overlapped.buffer.buf[0 .. overlapped.buffer.len]);
|
defaultAllocator.dispose(overlapped.buffer.buf[0 .. overlapped.buffer.len]);
|
||||||
}
|
}
|
||||||
auto socket = make!OverlappedConnectedSocket(defaultAllocator,
|
auto socket = make!OverlappedConnectedSocket(defaultAllocator,
|
||||||
cast(socket_t) overlapped.handle,
|
cast(SocketType) overlapped.handle,
|
||||||
addressFamily);
|
addressFamily);
|
||||||
scope (failure)
|
scope (failure)
|
||||||
{
|
{
|
||||||
@ -497,6 +398,114 @@ else version (Windows)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Socket option that specifies what should happen when the socket that
|
||||||
|
* promises reliable delivery still has untransmitted messages when
|
||||||
|
* it is closed.
|
||||||
|
*/
|
||||||
|
struct Linger
|
||||||
|
{
|
||||||
|
/// If nonzero, $(D_PSYMBOL close) and $(D_PSYMBOL shutdown) block until
|
||||||
|
/// the data are transmitted or the timeout period has expired.
|
||||||
|
LingerField l_onoff;
|
||||||
|
|
||||||
|
/// Time, in seconds to wait before any buffered data to be sent is
|
||||||
|
/// discarded.
|
||||||
|
LingerField l_linger;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If $(D_PARAM timeout) is `0`, linger is disabled, otherwise enables the
|
||||||
|
* linger and sets the timeout.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* timeout = Timeout, in seconds.
|
||||||
|
*/
|
||||||
|
this(const ushort timeout)
|
||||||
|
{
|
||||||
|
time = timeout;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
auto linger = Linger(5);
|
||||||
|
assert(linger.enabled);
|
||||||
|
assert(linger.time == 5);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto linger = Linger(0);
|
||||||
|
assert(!linger.enabled);
|
||||||
|
}
|
||||||
|
{ // Default constructor.
|
||||||
|
Linger linger;
|
||||||
|
assert(!linger.enabled);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* System dependent constructor.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* l_onoff = $(D_PSYMBOL l_onoff) value.
|
||||||
|
* l_linger = $(D_PSYMBOL l_linger) value.
|
||||||
|
*/
|
||||||
|
this(LingerField l_onoff, LingerField l_linger)
|
||||||
|
{
|
||||||
|
this.l_onoff = l_onoff;
|
||||||
|
this.l_linger = l_linger;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
auto linger = Linger(1, 5);
|
||||||
|
assert(linger.l_onoff == 1);
|
||||||
|
assert(linger.l_linger == 5);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Params:
|
||||||
|
* value = Whether to linger after the socket is closed.
|
||||||
|
*
|
||||||
|
* See_Also: $(D_PSYMBOL time).
|
||||||
|
*/
|
||||||
|
@property enabled(const bool value) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.l_onoff = value;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Whether to linger after the socket is closed.
|
||||||
|
*/
|
||||||
|
@property bool enabled() const pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return this.l_onoff != 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Timeout period, in seconds, to wait before closing the socket
|
||||||
|
* if the $(D_PSYMBOL Linger) is $(D_PSYMBOL enabled).
|
||||||
|
*/
|
||||||
|
@property ushort time() const pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return this.l_linger & ushort.max;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sets timeout period, to wait before closing the socket if the
|
||||||
|
* $(D_PSYMBOL Linger) is $(D_PSYMBOL enabled), ignored otherwise.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* timeout = Timeout period, in seconds.
|
||||||
|
*/
|
||||||
|
@property void time(const ushort timeout) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.l_onoff = timeout > 0;
|
||||||
|
this.l_linger = timeout;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
version (linux)
|
version (linux)
|
||||||
{
|
{
|
||||||
enum SOCK_NONBLOCK = O_NONBLOCK;
|
enum SOCK_NONBLOCK = O_NONBLOCK;
|
||||||
@ -525,7 +534,7 @@ else version (DragonFlyBSD)
|
|||||||
|
|
||||||
version (MacBSD)
|
version (MacBSD)
|
||||||
{
|
{
|
||||||
enum ESOCKTNOSUPPORT = 44; /// Socket type not suppoted.
|
enum ESOCKTNOSUPPORT = 44; // Socket type not suppoted.
|
||||||
}
|
}
|
||||||
|
|
||||||
private immutable
|
private immutable
|
||||||
@ -552,12 +561,32 @@ shared static this()
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_PSYMBOL AddressFamily) specifies a communication domain; this selects
|
||||||
|
* the protocol family which will be used for communication.
|
||||||
|
*/
|
||||||
|
enum AddressFamily : int
|
||||||
|
{
|
||||||
|
unspec = 0, /// Unspecified.
|
||||||
|
local = 1, /// Local to host (pipes and file-domain).
|
||||||
|
unix = local, /// POSIX name for PF_LOCAL.
|
||||||
|
inet = 2, /// IP protocol family.
|
||||||
|
ax25 = 3, /// Amateur Radio AX.25.
|
||||||
|
ipx = 4, /// Novell Internet Protocol.
|
||||||
|
appletalk = 5, /// Appletalk DDP.
|
||||||
|
netrom = 6, /// Amateur radio NetROM.
|
||||||
|
bridge = 7, /// Multiprotocol bridge.
|
||||||
|
atmpvc = 8, /// ATM PVCs.
|
||||||
|
x25 = 9, /// Reserved for X.25 project.
|
||||||
|
inet6 = 10, /// IP version 6.
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Error codes for $(D_PSYMBOL Socket).
|
* Error codes for $(D_PSYMBOL Socket).
|
||||||
*/
|
*/
|
||||||
enum SocketError : int
|
enum SocketError : int
|
||||||
{
|
{
|
||||||
/// Unknown error
|
/// Unknown error.
|
||||||
unknown = 0,
|
unknown = 0,
|
||||||
/// Firewall rules forbid connection.
|
/// Firewall rules forbid connection.
|
||||||
accessDenied = EPERM,
|
accessDenied = EPERM,
|
||||||
@ -587,12 +616,12 @@ enum SocketError : int
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* $(D_PSYMBOL SocketException) should be thrown only if one of the socket functions
|
* $(D_PSYMBOL SocketException) should be thrown only if one of the socket functions
|
||||||
* returns -1 or $(D_PSYMBOL SOCKET_ERROR) and sets $(D_PSYMBOL errno),
|
* $(D_PSYMBOL socketError) and sets $(D_PSYMBOL errno), because
|
||||||
* because $(D_PSYMBOL SocketException) relies on the $(D_PSYMBOL errno) value.
|
* $(D_PSYMBOL SocketException) relies on the $(D_PSYMBOL errno) value.
|
||||||
*/
|
*/
|
||||||
class SocketException : Exception
|
class SocketException : Exception
|
||||||
{
|
{
|
||||||
immutable SocketError error = SocketError.unknown;
|
const SocketError error = SocketError.unknown;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Params:
|
* Params:
|
||||||
@ -680,16 +709,16 @@ abstract class Socket
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// Socket handle.
|
/// Socket handle.
|
||||||
protected socket_t handle_;
|
protected SocketType handle_;
|
||||||
|
|
||||||
/// Address family.
|
/// Address family.
|
||||||
protected AddressFamily family;
|
protected AddressFamily family;
|
||||||
|
|
||||||
private @property void handle(socket_t handle) @nogc
|
private @property void handle(SocketType handle) @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(handle != socket_t.init);
|
assert(handle != SocketType.init);
|
||||||
assert(handle_ == socket_t.init, "Socket handle cannot be changed");
|
assert(handle_ == SocketType.init, "Socket handle cannot be changed");
|
||||||
}
|
}
|
||||||
body
|
body
|
||||||
{
|
{
|
||||||
@ -703,7 +732,7 @@ abstract class Socket
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@property inout(socket_t) handle() inout const pure nothrow @safe @nogc
|
@property inout(SocketType) handle() inout const pure nothrow @safe @nogc
|
||||||
{
|
{
|
||||||
return handle_;
|
return handle_;
|
||||||
}
|
}
|
||||||
@ -715,10 +744,10 @@ abstract class Socket
|
|||||||
* handle = Socket.
|
* handle = Socket.
|
||||||
* af = Address family.
|
* af = Address family.
|
||||||
*/
|
*/
|
||||||
this(socket_t handle, AddressFamily af) @nogc
|
this(SocketType handle, AddressFamily af) @nogc
|
||||||
in
|
in
|
||||||
{
|
{
|
||||||
assert(handle != socket_t.init);
|
assert(handle != SocketType.init);
|
||||||
}
|
}
|
||||||
body
|
body
|
||||||
{
|
{
|
||||||
@ -759,7 +788,7 @@ abstract class Socket
|
|||||||
cast(int) level,
|
cast(int) level,
|
||||||
cast(int) option,
|
cast(int) option,
|
||||||
result.ptr,
|
result.ptr,
|
||||||
&length) == SOCKET_ERROR)
|
&length) == socketError)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to get socket option");
|
throw defaultAllocator.make!SocketException("Unable to get socket option");
|
||||||
}
|
}
|
||||||
@ -779,7 +808,7 @@ abstract class Socket
|
|||||||
SocketOption option,
|
SocketOption option,
|
||||||
out Linger result) const @trusted @nogc
|
out Linger result) const @trusted @nogc
|
||||||
{
|
{
|
||||||
return getOption(level, option, (&result.clinger)[0..1]);
|
return getOption(level, option, (&result)[0 .. 1]);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// Ditto.
|
||||||
@ -826,7 +855,7 @@ abstract class Socket
|
|||||||
cast(int)level,
|
cast(int)level,
|
||||||
cast(int)option,
|
cast(int)option,
|
||||||
value.ptr,
|
value.ptr,
|
||||||
cast(uint) value.length) == SOCKET_ERROR)
|
cast(uint) value.length) == socketError)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to set socket option");
|
throw defaultAllocator.make!SocketException("Unable to set socket option");
|
||||||
}
|
}
|
||||||
@ -843,7 +872,7 @@ abstract class Socket
|
|||||||
void setOption(SocketOptionLevel level, SocketOption option, Linger value)
|
void setOption(SocketOptionLevel level, SocketOption option, Linger value)
|
||||||
const @trusted @nogc
|
const @trusted @nogc
|
||||||
{
|
{
|
||||||
setOption(level, option, (&value.clinger)[0..1]);
|
setOption(level, option, (&value)[0 .. 1]);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Ditto.
|
/// Ditto.
|
||||||
@ -878,7 +907,7 @@ abstract class Socket
|
|||||||
}
|
}
|
||||||
else version (Windows)
|
else version (Windows)
|
||||||
{
|
{
|
||||||
return blocking_;
|
return this.blocking_;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -892,12 +921,12 @@ abstract class Socket
|
|||||||
{
|
{
|
||||||
int fl = fcntl(handle_, F_GETFL, 0);
|
int fl = fcntl(handle_, F_GETFL, 0);
|
||||||
|
|
||||||
if (fl != SOCKET_ERROR)
|
if (fl != socketError)
|
||||||
{
|
{
|
||||||
fl = yes ? fl & ~O_NONBLOCK : fl | O_NONBLOCK;
|
fl = yes ? fl & ~O_NONBLOCK : fl | O_NONBLOCK;
|
||||||
fl = fcntl(handle_, F_SETFL, fl);
|
fl = fcntl(handle_, F_SETFL, fl);
|
||||||
}
|
}
|
||||||
if (fl == SOCKET_ERROR)
|
if (fl == socketError)
|
||||||
{
|
{
|
||||||
throw make!SocketException(defaultAllocator,
|
throw make!SocketException(defaultAllocator,
|
||||||
"Unable to set socket blocking");
|
"Unable to set socket blocking");
|
||||||
@ -906,12 +935,12 @@ abstract class Socket
|
|||||||
else version (Windows)
|
else version (Windows)
|
||||||
{
|
{
|
||||||
uint num = !yes;
|
uint num = !yes;
|
||||||
if (ioctlsocket(handle_, FIONBIO, &num) == SOCKET_ERROR)
|
if (ioctlsocket(handle_, FIONBIO, &num) == socketError)
|
||||||
{
|
{
|
||||||
throw make!SocketException(defaultAllocator,
|
throw make!SocketException(defaultAllocator,
|
||||||
"Unable to set socket blocking");
|
"Unable to set socket blocking");
|
||||||
}
|
}
|
||||||
blocking_ = yes;
|
this.blocking_ = yes;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -963,7 +992,7 @@ abstract class Socket
|
|||||||
{
|
{
|
||||||
.close(handle_);
|
.close(handle_);
|
||||||
}
|
}
|
||||||
handle_ = socket_t.init;
|
handle_ = SocketType.init;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -976,7 +1005,7 @@ abstract class Socket
|
|||||||
*/
|
*/
|
||||||
void listen(int backlog) const @trusted @nogc
|
void listen(int backlog) const @trusted @nogc
|
||||||
{
|
{
|
||||||
if (.listen(handle_, backlog) == SOCKET_ERROR)
|
if (.listen(handle_, backlog) == socketError)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to listen on socket");
|
throw defaultAllocator.make!SocketException("Unable to listen on socket");
|
||||||
}
|
}
|
||||||
@ -1029,8 +1058,8 @@ class StreamSocket : Socket, ConnectionOrientedSocket
|
|||||||
*/
|
*/
|
||||||
this(AddressFamily af) @trusted @nogc
|
this(AddressFamily af) @trusted @nogc
|
||||||
{
|
{
|
||||||
auto handle = cast(socket_t) socket(af, SOCK_STREAM, 0);
|
auto handle = cast(SocketType) socket(af, 1, 0);
|
||||||
if (handle == socket_t.init)
|
if (handle == SocketType.init)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to create socket");
|
throw defaultAllocator.make!SocketException("Unable to create socket");
|
||||||
}
|
}
|
||||||
@ -1047,7 +1076,7 @@ class StreamSocket : Socket, ConnectionOrientedSocket
|
|||||||
*/
|
*/
|
||||||
void bind(Address address) const @trusted @nogc
|
void bind(Address address) const @trusted @nogc
|
||||||
{
|
{
|
||||||
if (.bind(handle_, address.name, address.length) == SOCKET_ERROR)
|
if (.bind(handle_, address.name, address.length) == socketError)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Unable to bind socket");
|
throw defaultAllocator.make!SocketException("Unable to bind socket");
|
||||||
}
|
}
|
||||||
@ -1066,7 +1095,7 @@ class StreamSocket : Socket, ConnectionOrientedSocket
|
|||||||
*/
|
*/
|
||||||
ConnectedSocket accept() @trusted @nogc
|
ConnectedSocket accept() @trusted @nogc
|
||||||
{
|
{
|
||||||
socket_t sock;
|
SocketType sock;
|
||||||
|
|
||||||
version (linux)
|
version (linux)
|
||||||
{
|
{
|
||||||
@ -1075,14 +1104,14 @@ class StreamSocket : Socket, ConnectionOrientedSocket
|
|||||||
{
|
{
|
||||||
flags |= SOCK_NONBLOCK;
|
flags |= SOCK_NONBLOCK;
|
||||||
}
|
}
|
||||||
sock = cast(socket_t).accept4(handle_, null, null, flags);
|
sock = cast(SocketType).accept4(handle_, null, null, flags);
|
||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
sock = cast(socket_t).accept(handle_, null, null);
|
sock = cast(SocketType).accept(handle_, null, null);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (sock == socket_t.init)
|
if (sock == SocketType.init)
|
||||||
{
|
{
|
||||||
if (wouldHaveBlocked())
|
if (wouldHaveBlocked())
|
||||||
{
|
{
|
||||||
@ -1147,7 +1176,7 @@ class ConnectedSocket : Socket, ConnectionOrientedSocket
|
|||||||
* handle = Socket.
|
* handle = Socket.
|
||||||
* af = Address family.
|
* af = Address family.
|
||||||
*/
|
*/
|
||||||
this(socket_t handle, AddressFamily af) @nogc
|
this(SocketType handle, AddressFamily af) @nogc
|
||||||
{
|
{
|
||||||
super(handle, af);
|
super(handle, af);
|
||||||
}
|
}
|
||||||
@ -1196,7 +1225,7 @@ class ConnectedSocket : Socket, ConnectionOrientedSocket
|
|||||||
{
|
{
|
||||||
disconnected_ = true;
|
disconnected_ = true;
|
||||||
}
|
}
|
||||||
else if (ret == SOCKET_ERROR)
|
else if (ret == socketError)
|
||||||
{
|
{
|
||||||
if (wouldHaveBlocked())
|
if (wouldHaveBlocked())
|
||||||
{
|
{
|
||||||
@ -1233,7 +1262,7 @@ class ConnectedSocket : Socket, ConnectionOrientedSocket
|
|||||||
}
|
}
|
||||||
|
|
||||||
sent = .send(handle_, buf.ptr, capToMaxBuffer(buf.length), sendFlags);
|
sent = .send(handle_, buf.ptr, capToMaxBuffer(buf.length), sendFlags);
|
||||||
if (sent != SOCKET_ERROR)
|
if (sent != socketError)
|
||||||
{
|
{
|
||||||
return sent;
|
return sent;
|
||||||
}
|
}
|
||||||
@ -1273,14 +1302,11 @@ class InternetAddress : Address
|
|||||||
/// Internal internet address representation.
|
/// Internal internet address representation.
|
||||||
protected sockaddr_storage storage;
|
protected sockaddr_storage storage;
|
||||||
}
|
}
|
||||||
immutable ushort port_;
|
const ushort port_;
|
||||||
|
|
||||||
enum
|
enum ushort anyPort = 0;
|
||||||
{
|
|
||||||
anyPort = 0,
|
|
||||||
}
|
|
||||||
|
|
||||||
this(in string host, ushort port = anyPort) @nogc
|
this(string host, const ushort port = anyPort) @nogc
|
||||||
{
|
{
|
||||||
if (getaddrinfoPointer is null || freeaddrinfoPointer is null)
|
if (getaddrinfoPointer is null || freeaddrinfoPointer is null)
|
||||||
{
|
{
|
||||||
@ -1288,7 +1314,7 @@ class InternetAddress : Address
|
|||||||
"Address info lookup is not available on this system");
|
"Address info lookup is not available on this system");
|
||||||
}
|
}
|
||||||
addrinfo* ai_res;
|
addrinfo* ai_res;
|
||||||
port_ = port;
|
this.port_ = port;
|
||||||
|
|
||||||
// Make C-string from host.
|
// Make C-string from host.
|
||||||
auto node = cast(char[]) allocator.allocate(host.length + 1);
|
auto node = cast(char[]) allocator.allocate(host.length + 1);
|
||||||
@ -1304,16 +1330,17 @@ class InternetAddress : Address
|
|||||||
const(char)* servicePointer;
|
const(char)* servicePointer;
|
||||||
if (port)
|
if (port)
|
||||||
{
|
{
|
||||||
|
ushort originalPort = port;
|
||||||
ushort start;
|
ushort start;
|
||||||
for (ushort j = 10, i = 4; i > 0; j *= 10, --i)
|
for (ushort j = 10, i = 4; i > 0; j *= 10, --i)
|
||||||
{
|
{
|
||||||
ushort rest = port % 10;
|
ushort rest = originalPort % 10;
|
||||||
if (rest != 0)
|
if (rest != 0)
|
||||||
{
|
{
|
||||||
service[i] = cast(char) (rest + '0');
|
service[i] = cast(char) (rest + '0');
|
||||||
start = i;
|
start = i;
|
||||||
}
|
}
|
||||||
port /= 10;
|
originalPort /= 10;
|
||||||
}
|
}
|
||||||
servicePointer = service[start .. $].ptr;
|
servicePointer = service[start .. $].ptr;
|
||||||
}
|
}
|
||||||
@ -1333,12 +1360,23 @@ class InternetAddress : Address
|
|||||||
{
|
{
|
||||||
*dp = *sp;
|
*dp = *sp;
|
||||||
}
|
}
|
||||||
if (ai_res.ai_family != AddressFamily.INET && ai_res.ai_family != AddressFamily.INET6)
|
if (ai_res.ai_family != AddressFamily.inet && ai_res.ai_family != AddressFamily.inet6)
|
||||||
{
|
{
|
||||||
throw defaultAllocator.make!SocketException("Wrong address family");
|
throw defaultAllocator.make!SocketException("Wrong address family");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
auto address = defaultAllocator.make!InternetAddress("127.0.0.1");
|
||||||
|
assert(address.port == InternetAddress.anyPort);
|
||||||
|
assert(address.name !is null);
|
||||||
|
assert(address.family == AddressFamily.inet);
|
||||||
|
|
||||||
|
defaultAllocator.dispose(address);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns: Pointer to underlying $(D_PSYMBOL sockaddr) structure.
|
* Returns: Pointer to underlying $(D_PSYMBOL sockaddr) structure.
|
||||||
*/
|
*/
|
||||||
@ -1355,9 +1393,9 @@ class InternetAddress : Address
|
|||||||
// FreeBSD wants to know the exact length of the address on bind.
|
// FreeBSD wants to know the exact length of the address on bind.
|
||||||
switch (family)
|
switch (family)
|
||||||
{
|
{
|
||||||
case AddressFamily.INET:
|
case AddressFamily.inet:
|
||||||
return sockaddr_in.sizeof;
|
return sockaddr_in.sizeof;
|
||||||
case AddressFamily.INET6:
|
case AddressFamily.inet6:
|
||||||
return sockaddr_in6.sizeof;
|
return sockaddr_in6.sizeof;
|
||||||
default:
|
default:
|
||||||
assert(false);
|
assert(false);
|
||||||
@ -1376,6 +1414,15 @@ class InternetAddress : Address
|
|||||||
{
|
{
|
||||||
return port_;
|
return port_;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
auto address = defaultAllocator.make!InternetAddress("127.0.0.1",
|
||||||
|
cast(ushort) 1234);
|
||||||
|
assert(address.port == 1234);
|
||||||
|
defaultAllocator.dispose(address);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
File diff suppressed because it is too large
Load Diff
339
source/tanya/os/error.d
Normal file
339
source/tanya/os/error.d
Normal file
@ -0,0 +1,339 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This module provides a portable way of using operating system error codes.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/os/error.d,
|
||||||
|
* tanya/os/error.d)
|
||||||
|
*/
|
||||||
|
module tanya.os.error;
|
||||||
|
|
||||||
|
// Socket API error.
|
||||||
|
private template SAError(int posix, int wsa = posix)
|
||||||
|
{
|
||||||
|
version (Windows)
|
||||||
|
{
|
||||||
|
enum SAError = 10000 + wsa;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias SAError = posix;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Error for Windows and Posix separately.
|
||||||
|
private template NativeError(int posix, int win)
|
||||||
|
{
|
||||||
|
version (Windows)
|
||||||
|
{
|
||||||
|
alias NativeError = win;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias NativeError = posix;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
version (Windows)
|
||||||
|
{
|
||||||
|
private enum eProtocolError = -71;
|
||||||
|
}
|
||||||
|
else version (OpenBSD)
|
||||||
|
{
|
||||||
|
private enum eProtocolError = -71;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
private enum eProtocolError = 71;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* System error code.
|
||||||
|
*/
|
||||||
|
struct ErrorCode
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Error code numbers.
|
||||||
|
*/
|
||||||
|
enum ErrorNo : int
|
||||||
|
{
|
||||||
|
/// The operation completed successfully.
|
||||||
|
success = 0,
|
||||||
|
|
||||||
|
/// Operation not permitted.
|
||||||
|
noPermission = NativeError!(1, 5),
|
||||||
|
|
||||||
|
/// Interrupted system call.
|
||||||
|
interrupted = SAError!4,
|
||||||
|
|
||||||
|
/// Bad file descriptor.
|
||||||
|
badDescriptor = SAError!9,
|
||||||
|
|
||||||
|
/// An operation on a non-blocking socket would block.
|
||||||
|
wouldBlock = SAError!(11, 35),
|
||||||
|
|
||||||
|
/// Out of memory.
|
||||||
|
noMemory = NativeError!(12, 14),
|
||||||
|
|
||||||
|
/// Access denied.
|
||||||
|
accessDenied = SAError!13,
|
||||||
|
|
||||||
|
/// An invalid pointer address detected.
|
||||||
|
fault = SAError!14,
|
||||||
|
|
||||||
|
/// No such device.
|
||||||
|
noSuchDevice = NativeError!(19, 20),
|
||||||
|
|
||||||
|
/// An invalid argument was supplied.
|
||||||
|
invalidArgument = SAError!22,
|
||||||
|
|
||||||
|
/// The limit on the number of open file descriptors.
|
||||||
|
tooManyDescriptors = NativeError!(23, 331),
|
||||||
|
|
||||||
|
/// The limit on the number of open file descriptors.
|
||||||
|
noDescriptors = SAError!24,
|
||||||
|
|
||||||
|
/// Broken pipe.
|
||||||
|
brokenPipe = NativeError!(32, 109),
|
||||||
|
|
||||||
|
/// The name was too long.
|
||||||
|
nameTooLong = SAError!(36, 63),
|
||||||
|
|
||||||
|
/// A socket operation was attempted on a non-socket.
|
||||||
|
notSocket = SAError!(88, 38),
|
||||||
|
|
||||||
|
/// Protocol error.
|
||||||
|
protocolError = eProtocolError,
|
||||||
|
|
||||||
|
/// Message too long.
|
||||||
|
messageTooLong = SAError!(90, 40),
|
||||||
|
|
||||||
|
/// Wrong protocol type for socket.
|
||||||
|
wrongProtocolType = SAError!(91, 41),
|
||||||
|
|
||||||
|
/// Protocol not available.
|
||||||
|
noProtocolOption = SAError!(92, 42),
|
||||||
|
|
||||||
|
/// The protocol is not implemented orR has not been configured.
|
||||||
|
protocolNotSupported = SAError!(93, 43),
|
||||||
|
|
||||||
|
/// The support for the specified socket type does not exist in this
|
||||||
|
/// address family.
|
||||||
|
socketNotSupported = SAError!(94, 44),
|
||||||
|
|
||||||
|
/// The address family is no supported by the protocol family.
|
||||||
|
operationNotSupported = SAError!(95, 45),
|
||||||
|
|
||||||
|
/// Address family specified is not supported.
|
||||||
|
addressFamilyNotSupported = SAError!(97, 47),
|
||||||
|
|
||||||
|
/// Address already in use.
|
||||||
|
addressInUse = SAError!(98, 48),
|
||||||
|
|
||||||
|
/// The network is not available.
|
||||||
|
networkDown = SAError!(100, 50),
|
||||||
|
|
||||||
|
/// No route to host.
|
||||||
|
networkUnreachable = SAError!(101, 51),
|
||||||
|
|
||||||
|
/// Network dropped connection because of reset.
|
||||||
|
networkReset = SAError!(102, 52),
|
||||||
|
|
||||||
|
/// The connection has been aborted.
|
||||||
|
connectionAborted = SAError!(103, 53),
|
||||||
|
|
||||||
|
/// Connection reset by peer.
|
||||||
|
connectionReset = SAError!(104, 54),
|
||||||
|
|
||||||
|
/// No free buffer space is available for a socket operation.
|
||||||
|
noBufferSpace = SAError!(105, 55),
|
||||||
|
|
||||||
|
/// Transport endpoint is already connected.
|
||||||
|
alreadyConnected = SAError!(106, 56),
|
||||||
|
|
||||||
|
/// Transport endpoint is not connected.
|
||||||
|
notConnected = SAError!(107, 57),
|
||||||
|
|
||||||
|
/// Cannot send after transport endpoint shutdown.
|
||||||
|
shutdown = SAError!(108, 58),
|
||||||
|
|
||||||
|
/// The connection attempt timed out, or the connected host has failed
|
||||||
|
/// to respond.
|
||||||
|
timedOut = SAError!(110, 60),
|
||||||
|
|
||||||
|
/// Connection refused.
|
||||||
|
connectionRefused = SAError!(111, 61),
|
||||||
|
|
||||||
|
/// Host is down.
|
||||||
|
hostDown = SAError!(112, 64),
|
||||||
|
|
||||||
|
/// No route to host.
|
||||||
|
hostUnreachable = SAError!(113, 65),
|
||||||
|
|
||||||
|
/// Operation already in progress.
|
||||||
|
alreadyStarted = SAError!(114, 37),
|
||||||
|
|
||||||
|
/// Operation now in progress.
|
||||||
|
inProgress = SAError!(115, 36),
|
||||||
|
|
||||||
|
/// Operation cancelled.
|
||||||
|
cancelled = SAError!(125, 103),
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructor.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* value = Numeric error code.
|
||||||
|
*/
|
||||||
|
this(const ErrorNo value) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.value_ = value;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
ErrorCode ec;
|
||||||
|
assert(ec == ErrorCode.success);
|
||||||
|
|
||||||
|
ec = ErrorCode.fault;
|
||||||
|
assert(ec == ErrorCode.fault);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Resets this $(D_PSYMBOL ErrorCode) to default
|
||||||
|
* ($(D_PSYMBOL ErrorCode.success)).
|
||||||
|
*/
|
||||||
|
void reset() pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.value_ = ErrorNo.success;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
auto ec = ErrorCode(ErrorCode.fault);
|
||||||
|
assert(ec == ErrorCode.fault);
|
||||||
|
|
||||||
|
ec.reset();
|
||||||
|
assert(ec == ErrorCode.success);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns: Numeric error code.
|
||||||
|
*/
|
||||||
|
ErrorNo opCast(T : ErrorNo)() const
|
||||||
|
{
|
||||||
|
return this.value_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ErrorNo opCast(T : int)() const
|
||||||
|
{
|
||||||
|
return this.value_;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
ErrorCode ec = ErrorCode.fault;
|
||||||
|
auto errorNo = cast(ErrorCode.ErrorNo) ec;
|
||||||
|
|
||||||
|
assert(errorNo == ErrorCode.fault);
|
||||||
|
static assert(is(typeof(cast(int) ec)));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Assigns another error code or error code number.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* that = Numeric error code.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD this).
|
||||||
|
*/
|
||||||
|
ref ErrorCode opAssign(const ErrorNo that) pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.value_ = that;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
ref ErrorCode opAssign()(auto ref const ErrorCode that)
|
||||||
|
pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
this.value_ = that.value_;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
ErrorCode ec;
|
||||||
|
assert(ec == ErrorCode.success);
|
||||||
|
|
||||||
|
ec = ErrorCode.fault;
|
||||||
|
assert(ec == ErrorCode.fault);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
auto ec1 = ErrorCode(ErrorCode.fault);
|
||||||
|
ErrorCode ec2;
|
||||||
|
assert(ec2 == ErrorCode.success);
|
||||||
|
|
||||||
|
ec2 = ec1;
|
||||||
|
assert(ec1 == ec2);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Equality with another error code or error code number.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* that = Numeric error code.
|
||||||
|
*
|
||||||
|
* Returns: Whether $(D_KEYWORD this) and $(D_PARAM that) are equal.
|
||||||
|
*/
|
||||||
|
bool opEquals(const ErrorNo that) const pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return this.value_ == that;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
bool opEquals()(auto ref const ErrorCode that)
|
||||||
|
const pure nothrow @safe @nogc
|
||||||
|
{
|
||||||
|
return this.value_ == that.value_;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
pure nothrow @safe @nogc unittest
|
||||||
|
{
|
||||||
|
{
|
||||||
|
ErrorCode ec1 = ErrorCode.fault;
|
||||||
|
ErrorCode ec2 = ErrorCode.accessDenied;
|
||||||
|
|
||||||
|
assert(ec1 != ec2);
|
||||||
|
assert(ec1 != ErrorCode.accessDenied);
|
||||||
|
assert(ErrorCode.fault != ec2);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
ErrorCode ec1 = ErrorCode.fault;
|
||||||
|
ErrorCode ec2 = ErrorCode.fault;
|
||||||
|
|
||||||
|
assert(ec1 == ec2);
|
||||||
|
assert(ec1 == ErrorCode.fault);
|
||||||
|
assert(ErrorCode.fault == ec2);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private ErrorNo value_ = ErrorNo.success;
|
||||||
|
|
||||||
|
alias ErrorNo this;
|
||||||
|
}
|
18
source/tanya/os/package.d
Normal file
18
source/tanya/os/package.d
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This package provides platform-independent interfaces to operating system
|
||||||
|
* functionality.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/os/package.d,
|
||||||
|
* tanya/os/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.os;
|
||||||
|
|
||||||
|
public import tanya.os.error;
|
220
source/tanya/range/array.d
Normal file
220
source/tanya/range/array.d
Normal file
@ -0,0 +1,220 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_PSYMBOL tanya.range.array) implements range primitives for built-in arrays.
|
||||||
|
*
|
||||||
|
* This module is a submodule of
|
||||||
|
* $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/range/package.d, tanya.range).
|
||||||
|
*
|
||||||
|
* After importing of
|
||||||
|
* $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/range/array.d, tanya/range/array.d)
|
||||||
|
* built-in arrays can act as bidirectional ranges. For that to work the module
|
||||||
|
* defines a set of functions that accept a built-in array of any type as their
|
||||||
|
* first argument, so thanks to UFCS (Uniform Function Call Syntax) they can be
|
||||||
|
* called as if they were array member functions. For example the arrays the
|
||||||
|
* `.length`-property, but no `.empty` property. So here can be find the
|
||||||
|
* $(D_PSYMBOL empty) function. Since $(D_INLINECODE empty(array)) and
|
||||||
|
* $(D_INLINECODE array.empty) are equal for the arrays, arrays get a faked
|
||||||
|
* property `empty`.
|
||||||
|
*
|
||||||
|
* The functions in this module don't change array elements or its underlying
|
||||||
|
* storage, but some functions alter the slice. Each array maintains a pointer
|
||||||
|
* to its data and the length and there can be several pointers which point to
|
||||||
|
* the same data. Array pointer can be advanced and the length can be reduced
|
||||||
|
* without changing the underlying storage. So slices offer the possibility to
|
||||||
|
* have multiple views into the same array, point to different positions inside
|
||||||
|
* it.
|
||||||
|
*
|
||||||
|
* Strings ($(D_INLINECODE char[]), (D_INLINECODE wchar[]) and
|
||||||
|
* (D_INLINECODE dchar[])) are treated as any other normal array, they aren't
|
||||||
|
* auto-decoded.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/range/array.d,
|
||||||
|
* tanya/range/array.d)
|
||||||
|
*/
|
||||||
|
module tanya.range.array;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns the first element of the $(D_PARAM array).
|
||||||
|
*
|
||||||
|
* The element is returned by reference, so $(D_PSYMBOL front) can be also used
|
||||||
|
* to change the first element of $(D_PARAM array) if it is mutable.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Element type of $(D_PARAM array).
|
||||||
|
* array = Built-in array.
|
||||||
|
*
|
||||||
|
* Returns: First element.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE array.length > 0).
|
||||||
|
*/
|
||||||
|
@property ref T front(T)(T[] array)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(array.length > 0);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return array[0];
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
string s = "Wenn die Wunde nicht mehr wehtut, schmerzt die Narbe";
|
||||||
|
static assert(is(typeof(s.front) == immutable char));
|
||||||
|
assert(s.front == 'W');
|
||||||
|
|
||||||
|
wstring w = "Волны несутся, гремя и сверкая";
|
||||||
|
static assert(is(typeof(w.front) == immutable wchar));
|
||||||
|
assert(w.front == 'В');
|
||||||
|
|
||||||
|
dstring d = "Для писателя память - это почти все";
|
||||||
|
static assert(is(typeof(d.front) == immutable dchar));
|
||||||
|
assert(d.front == 'Д');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns the last element of the $(D_PARAM array).
|
||||||
|
*
|
||||||
|
* The element is returned by reference, so $(D_PSYMBOL back) can be also used
|
||||||
|
* to change the last element of $(D_PARAM array) if it is mutable.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Element type of $(D_PARAM array).
|
||||||
|
* array = Built-in array.
|
||||||
|
*
|
||||||
|
* Returns: Last element.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE array.length > 0).
|
||||||
|
*/
|
||||||
|
@property ref T back(T)(T[] array)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(array.length > 0);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
return array[$ - 1];
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
string s = "Brecht";
|
||||||
|
static assert(is(typeof(s.back) == immutable char));
|
||||||
|
assert(s.back == 't');
|
||||||
|
|
||||||
|
wstring w = "Тютчев";
|
||||||
|
static assert(is(typeof(w.back) == immutable wchar));
|
||||||
|
assert(w.back == 'в');
|
||||||
|
|
||||||
|
dstring d = "Паустовский";
|
||||||
|
static assert(is(typeof(d.back) == immutable dchar));
|
||||||
|
assert(d.back == 'й');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_PSYMBOL popFront) and $(D_PSYMBOL popBack) advance the $(D_PARAM array)
|
||||||
|
* and remove one element from its back, respectively.
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL popFront) and $(D_PSYMBOL popBack) don't alter the array
|
||||||
|
* storage, they only narrow the view into the array.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Element type of $(D_PARAM array).
|
||||||
|
* array = Built-in array.
|
||||||
|
*
|
||||||
|
* Precondition: $(D_INLINECODE array.length > 0).
|
||||||
|
*/
|
||||||
|
void popFront(T)(ref T[] array)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(array.length > 0);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
array = array[1 .. $];
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ditto
|
||||||
|
void popBack(T)(ref T[] array)
|
||||||
|
in
|
||||||
|
{
|
||||||
|
assert(array.length > 0);
|
||||||
|
}
|
||||||
|
body
|
||||||
|
{
|
||||||
|
array = array[0 .. $ - 1];
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
wstring array = "Der finstere Ozean der Metaphysik. Nietzsche";
|
||||||
|
|
||||||
|
array.popFront();
|
||||||
|
assert(array.length == 43);
|
||||||
|
assert(array.front == 'e');
|
||||||
|
|
||||||
|
array.popBack();
|
||||||
|
assert(array.length == 42);
|
||||||
|
assert(array.back == 'h');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tests whether $(D_PARAM array) is empty.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Element type of $(D_PARAM array).
|
||||||
|
* array = Built-in array.
|
||||||
|
*
|
||||||
|
* Returns: $(D_KEYWORD true) if $(D_PARAM array) has no elements,
|
||||||
|
* $(D_KEYWORD false) otherwise.
|
||||||
|
*/
|
||||||
|
@property bool empty(T)(const T[] array)
|
||||||
|
{
|
||||||
|
return array.length == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
int[1] array;
|
||||||
|
assert(!array.empty);
|
||||||
|
assert(array[1 .. 1].empty);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a copy of the slice $(D_PARAM array).
|
||||||
|
*
|
||||||
|
* $(D_PSYMBOL save) doesn't copy the array itself, but only the data pointer
|
||||||
|
* and the length.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Element type of $(D_PARAM array).
|
||||||
|
* array = Built-in array.
|
||||||
|
*
|
||||||
|
* Returns: A copy of the slice $(D_PARAM array).
|
||||||
|
*/
|
||||||
|
@property T[] save(T)(T[] array)
|
||||||
|
{
|
||||||
|
return array;
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
ubyte[8] array;
|
||||||
|
auto slice = array.save;
|
||||||
|
|
||||||
|
assert(slice.length == array.length);
|
||||||
|
slice.popFront();
|
||||||
|
assert(slice.length < array.length);
|
||||||
|
}
|
19
source/tanya/range/package.d
Normal file
19
source/tanya/range/package.d
Normal file
@ -0,0 +1,19 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This package contains generic functions and templates to be used with D
|
||||||
|
* ranges.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/range/package.d,
|
||||||
|
* tanya/range/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.range;
|
||||||
|
|
||||||
|
public import tanya.range.array;
|
||||||
|
public import tanya.range.primitive;
|
1355
source/tanya/range/primitive.d
Normal file
1355
source/tanya/range/primitive.d
Normal file
File diff suppressed because it is too large
Load Diff
61
source/tanya/sys/windows/def.d
Normal file
61
source/tanya/sys/windows/def.d
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base type definitions and aliases.
|
||||||
|
*
|
||||||
|
* This module doesn't provide aliases for all types used by Windows, but only
|
||||||
|
* for types that can vary on different platforms. For example there is no
|
||||||
|
* need to define `INT32` alias for D, since $(D_KEYWORD int) is always a
|
||||||
|
* 32-bit signed integer. But `int` and its Windows alias `INT` is not the
|
||||||
|
* same on all platforms in C, so its size can be something differen than
|
||||||
|
* 32 bit, therefore an $(D_PSYMBOL INT) alias is available in this module.
|
||||||
|
* $(D_PARAM TCHAR) can be a $(D_KEYWORD char) if Unicode isn't supported or
|
||||||
|
* $(D_KEYWORD wchar) if Unicode is supported, so $(D_PSYMBOL TCHAR) is
|
||||||
|
* defined here.
|
||||||
|
* Also aliases for specific types like $(D_PSYMBOL SOCKET) are defined here.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/sys/windows/def.d,
|
||||||
|
* tanya/sys/windows/def.d)
|
||||||
|
*/
|
||||||
|
module tanya.sys.windows.def;
|
||||||
|
|
||||||
|
version (Windows):
|
||||||
|
|
||||||
|
alias BYTE = ubyte;
|
||||||
|
alias TBYTE = wchar; // If Unicode, otherwise char.
|
||||||
|
alias CHAR = char; // Signed or unsigned char.
|
||||||
|
alias TCHAR = wchar; // If Unicode, otherwise char.
|
||||||
|
alias SHORT = short;
|
||||||
|
alias USHORT = ushort;
|
||||||
|
alias WORD = ushort;
|
||||||
|
alias INT = int;
|
||||||
|
alias UINT = uint;
|
||||||
|
alias LONG = int;
|
||||||
|
alias ULONG = uint;
|
||||||
|
alias DWORD = uint;
|
||||||
|
alias LONGLONG = long; // Or double.
|
||||||
|
alias ULONGLONG = ulong; // Or double.
|
||||||
|
alias DWORDLONG = ulong;
|
||||||
|
alias FLOAT = float;
|
||||||
|
alias BOOL = int;
|
||||||
|
alias BOOLEAN = BYTE;
|
||||||
|
|
||||||
|
alias HANDLE = void*;
|
||||||
|
enum HANDLE INVALID_HANDLE_VALUE = cast(HANDLE) -1;
|
||||||
|
|
||||||
|
enum TRUE = 1;
|
||||||
|
enum FALSE = 0;
|
||||||
|
|
||||||
|
align(1) struct GUID
|
||||||
|
{
|
||||||
|
uint Data1;
|
||||||
|
ushort Data2;
|
||||||
|
ushort Data3;
|
||||||
|
char[8] Data4;
|
||||||
|
}
|
114
source/tanya/sys/windows/error.d
Normal file
114
source/tanya/sys/windows/error.d
Normal file
@ -0,0 +1,114 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/sys/windows/error.d,
|
||||||
|
* tanya/sys/windows/error.d)
|
||||||
|
*/
|
||||||
|
module tanya.sys.windows.error;
|
||||||
|
|
||||||
|
version (Windows):
|
||||||
|
|
||||||
|
private enum WSABASEERR = 10000;
|
||||||
|
enum
|
||||||
|
{
|
||||||
|
WSAEINTR = WSABASEERR + 4,
|
||||||
|
WSAEBADF = WSABASEERR + 9,
|
||||||
|
WSAEACCES = WSABASEERR + 13,
|
||||||
|
WSAEFAULT = WSABASEERR + 14,
|
||||||
|
WSAEINVAL = WSABASEERR + 22,
|
||||||
|
WSAEMFILE = WSABASEERR + 24,
|
||||||
|
|
||||||
|
WSAEWOULDBLOCK = WSABASEERR + 35,
|
||||||
|
WSAEINPROGRESS = WSABASEERR + 36,
|
||||||
|
WSAEALREADY = WSABASEERR + 37,
|
||||||
|
WSAENOTSOCK = WSABASEERR + 38,
|
||||||
|
WSAEDESTADDRREQ = WSABASEERR + 39,
|
||||||
|
WSAEMSGSIZE = WSABASEERR + 40,
|
||||||
|
WSAEPROTOTYPE = WSABASEERR + 41,
|
||||||
|
WSAENOPROTOOPT = WSABASEERR + 42,
|
||||||
|
WSAEPROTONOSUPPORT = WSABASEERR + 43,
|
||||||
|
WSAESOCKTNOSUPPORT = WSABASEERR + 44,
|
||||||
|
WSAEOPNOTSUPP = WSABASEERR + 45,
|
||||||
|
WSAEPFNOSUPPORT = WSABASEERR + 46,
|
||||||
|
WSAEAFNOSUPPORT = WSABASEERR + 47,
|
||||||
|
WSAEADDRINUSE = WSABASEERR + 48,
|
||||||
|
WSAEADDRNOTAVAIL = WSABASEERR + 49,
|
||||||
|
WSAENETDOWN = WSABASEERR + 50,
|
||||||
|
WSAENETUNREACH = WSABASEERR + 51,
|
||||||
|
WSAENETRESET = WSABASEERR + 52,
|
||||||
|
WSAECONNABORTED = WSABASEERR + 53,
|
||||||
|
WSAECONNRESET = WSABASEERR + 54,
|
||||||
|
WSAENOBUFS = WSABASEERR + 55,
|
||||||
|
WSAEISCONN = WSABASEERR + 56,
|
||||||
|
WSAENOTCONN = WSABASEERR + 57,
|
||||||
|
WSAESHUTDOWN = WSABASEERR + 58,
|
||||||
|
WSAETOOMANYREFS = WSABASEERR + 59,
|
||||||
|
WSAETIMEDOUT = WSABASEERR + 60,
|
||||||
|
WSAECONNREFUSED = WSABASEERR + 61,
|
||||||
|
WSAELOOP = WSABASEERR + 62,
|
||||||
|
WSAENAMETOOLONG = WSABASEERR + 63,
|
||||||
|
WSAEHOSTDOWN = WSABASEERR + 64,
|
||||||
|
WSAEHOSTUNREACH = WSABASEERR + 65,
|
||||||
|
WSAENOTEMPTY = WSABASEERR + 66,
|
||||||
|
WSAEPROCLIM = WSABASEERR + 67,
|
||||||
|
WSAEUSERS = WSABASEERR + 68,
|
||||||
|
WSAEDQUOT = WSABASEERR + 69,
|
||||||
|
WSAESTALE = WSABASEERR + 70,
|
||||||
|
WSAEREMOTE = WSABASEERR + 71,
|
||||||
|
|
||||||
|
WSASYSNOTREADY = WSABASEERR + 91,
|
||||||
|
WSAVERNOTSUPPORTED = WSABASEERR + 92,
|
||||||
|
WSANOTINITIALISED = WSABASEERR + 93,
|
||||||
|
WSAEDISCON = WSABASEERR + 101,
|
||||||
|
WSAENOMORE = WSABASEERR + 102,
|
||||||
|
WSAECANCELLED = WSABASEERR + 103,
|
||||||
|
WSAEINVALIDPROCTABLE = WSABASEERR + 104,
|
||||||
|
WSAEINVALIDPROVIDER = WSABASEERR + 105,
|
||||||
|
WSAEPROVIDERFAILEDINIT = WSABASEERR + 106,
|
||||||
|
WSASYSCALLFAILURE = WSABASEERR + 107,
|
||||||
|
WSASERVICE_NOT_FOUND = WSABASEERR + 108,
|
||||||
|
WSATYPE_NOT_FOUND = WSABASEERR + 109,
|
||||||
|
WSA_E_NO_MORE = WSABASEERR + 110,
|
||||||
|
WSA_E_CANCELLED = WSABASEERR + 111,
|
||||||
|
WSAEREFUSED = WSABASEERR + 112,
|
||||||
|
|
||||||
|
WSAHOST_NOT_FOUND = WSABASEERR + 1001,
|
||||||
|
WSATRY_AGAIN = WSABASEERR + 1002,
|
||||||
|
WSANO_RECOVERY = WSABASEERR + 1003,
|
||||||
|
WSANO_DATA = WSABASEERR + 1004,
|
||||||
|
|
||||||
|
WSA_QOS_RECEIVERS = WSABASEERR + 1005,
|
||||||
|
WSA_QOS_SENDERS = WSABASEERR + 1006,
|
||||||
|
WSA_QOS_NO_SENDERS = WSABASEERR + 1007,
|
||||||
|
WSA_QOS_NO_RECEIVERS = WSABASEERR + 1008,
|
||||||
|
WSA_QOS_REQUEST_CONFIRMED = WSABASEERR + 1009,
|
||||||
|
WSA_QOS_ADMISSION_FAILURE = WSABASEERR + 1010,
|
||||||
|
WSA_QOS_POLICY_FAILURE = WSABASEERR + 1011,
|
||||||
|
WSA_QOS_BAD_STYLE = WSABASEERR + 1012,
|
||||||
|
WSA_QOS_BAD_OBJECT = WSABASEERR + 1013,
|
||||||
|
|
||||||
|
WSA_QOS_TRAFFIC_CTRL_ERROR = WSABASEERR + 1014,
|
||||||
|
WSA_QOS_GENERIC_ERROR = WSABASEERR + 1015,
|
||||||
|
WSA_QOS_ESERVICETYPE = WSABASEERR + 1016,
|
||||||
|
WSA_QOS_EFLOWSPEC = WSABASEERR + 1017,
|
||||||
|
WSA_QOS_EPROVSPECBUF = WSABASEERR + 1018,
|
||||||
|
WSA_QOS_EFILTERSTYLE = WSABASEERR + 1019,
|
||||||
|
WSA_QOS_EFILTERTYPE = WSABASEERR + 1020,
|
||||||
|
WSA_QOS_EFILTERCOUNT = WSABASEERR + 1021,
|
||||||
|
WSA_QOS_EOBJLENGTH = WSABASEERR + 1022,
|
||||||
|
WSA_QOS_EFLOWCOUNT = WSABASEERR + 1023,
|
||||||
|
WSA_QOS_EUNKOWNPSOBJ = WSABASEERR + 1024,
|
||||||
|
WSA_QOS_EPOLICYOBJ = WSABASEERR + 1025,
|
||||||
|
WSA_QOS_EFLOWDESC = WSABASEERR + 1026,
|
||||||
|
WSA_QOS_EPSFLOWSPEC = WSABASEERR + 1027,
|
||||||
|
WSA_QOS_EPSFILTERSPEC = WSABASEERR + 1028,
|
||||||
|
WSA_QOS_ESDMODEOBJ = WSABASEERR + 1029,
|
||||||
|
WSA_QOS_ESHAPERATEOBJ = WSABASEERR + 1030,
|
||||||
|
WSA_QOS_RESERVED_PETYPE = WSABASEERR + 1031,
|
||||||
|
}
|
20
source/tanya/sys/windows/package.d
Normal file
20
source/tanya/sys/windows/package.d
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/sys/windows/package.d,
|
||||||
|
* tanya/sys/windows/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.sys.windows;
|
||||||
|
|
||||||
|
version (Windows):
|
||||||
|
|
||||||
|
public import tanya.sys.windows.def;
|
||||||
|
public import tanya.sys.windows.error;
|
||||||
|
public import tanya.sys.windows.winbase;
|
||||||
|
public import tanya.sys.windows.winsock2;
|
55
source/tanya/sys/windows/winbase.d
Normal file
55
source/tanya/sys/windows/winbase.d
Normal file
@ -0,0 +1,55 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Definitions from winbase.h.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/sys/windows/winbase.d,
|
||||||
|
* tanya/sys/windows/winbase.d)
|
||||||
|
*/
|
||||||
|
module tanya.sys.windows.winbase;
|
||||||
|
|
||||||
|
version (Windows):
|
||||||
|
|
||||||
|
public import tanya.sys.windows.def;
|
||||||
|
|
||||||
|
struct OVERLAPPED
|
||||||
|
{
|
||||||
|
size_t Internal;
|
||||||
|
size_t InternalHigh;
|
||||||
|
union
|
||||||
|
{
|
||||||
|
struct
|
||||||
|
{
|
||||||
|
DWORD Offset;
|
||||||
|
DWORD OffsetHigh;
|
||||||
|
}
|
||||||
|
void* Pointer;
|
||||||
|
}
|
||||||
|
HANDLE hEvent;
|
||||||
|
}
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
HANDLE CreateIoCompletionPort(HANDLE FileHandle,
|
||||||
|
HANDLE ExistingCompletionPort,
|
||||||
|
size_t CompletionKey,
|
||||||
|
DWORD NumberOfConcurrentThreads)
|
||||||
|
nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
BOOL GetQueuedCompletionStatus(HANDLE CompletionPort,
|
||||||
|
DWORD* lpNumberOfBytes,
|
||||||
|
size_t* lpCompletionKey,
|
||||||
|
OVERLAPPED** lpOverlapped,
|
||||||
|
DWORD dwMilliseconds) nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
BOOL GetOverlappedResult(HANDLE hFile,
|
||||||
|
OVERLAPPED* lpOverlapped,
|
||||||
|
DWORD* lpNumberOfBytesTransferred,
|
||||||
|
BOOL bWait) nothrow @system @nogc;
|
219
source/tanya/sys/windows/winsock2.d
Normal file
219
source/tanya/sys/windows/winsock2.d
Normal file
@ -0,0 +1,219 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Definitions from winsock2.h, ws2def.h and MSWSock.h.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/sys/windows/winsock2.d,
|
||||||
|
* tanya/sys/windows/winsock2.d)
|
||||||
|
*/
|
||||||
|
module tanya.sys.windows.winsock2;
|
||||||
|
|
||||||
|
version (Windows):
|
||||||
|
|
||||||
|
public import tanya.sys.windows.def;
|
||||||
|
public import tanya.sys.windows.winbase;
|
||||||
|
|
||||||
|
alias SOCKET = size_t;
|
||||||
|
enum SOCKET INVALID_SOCKET = ~0;
|
||||||
|
enum SOCKET_ERROR = -1;
|
||||||
|
|
||||||
|
enum
|
||||||
|
{
|
||||||
|
IOC_UNIX = 0x00000000,
|
||||||
|
IOC_WS2 = 0x08000000,
|
||||||
|
IOC_PROTOCOL = 0x10000000,
|
||||||
|
IOC_VOID = 0x20000000, // No parameters.
|
||||||
|
IOC_OUT = 0x40000000, // Copy parameters back.
|
||||||
|
IOC_IN = 0x80000000, // Copy parameters into.
|
||||||
|
IOC_VENDOR = 0x18000000,
|
||||||
|
IOC_WSK = (IOC_WS2 | 0x07000000), // _WIN32_WINNT >= 0x0600.
|
||||||
|
IOC_INOUT = (IOC_IN | IOC_OUT), // Copy parameter into and get back.
|
||||||
|
}
|
||||||
|
|
||||||
|
template _WSAIO(int x, int y)
|
||||||
|
{
|
||||||
|
enum _WSAIO = IOC_VOID | x | y;
|
||||||
|
}
|
||||||
|
template _WSAIOR(int x, int y)
|
||||||
|
{
|
||||||
|
enum _WSAIOR = IOC_OUT | x | y;
|
||||||
|
}
|
||||||
|
template _WSAIOW(int x, int y)
|
||||||
|
{
|
||||||
|
enum _WSAIOW = IOC_IN | x | y;
|
||||||
|
}
|
||||||
|
template _WSAIORW(int x, int y)
|
||||||
|
{
|
||||||
|
enum _WSAIORW = IOC_INOUT | x | y;
|
||||||
|
}
|
||||||
|
|
||||||
|
alias SIO_ASSOCIATE_HANDLE = _WSAIOW!(IOC_WS2, 1);
|
||||||
|
alias SIO_ENABLE_CIRCULAR_QUEUEING = _WSAIO!(IOC_WS2, 2);
|
||||||
|
alias SIO_FIND_ROUTE = _WSAIOR!(IOC_WS2, 3);
|
||||||
|
alias SIO_FLUSH = _WSAIO!(IOC_WS2, 4);
|
||||||
|
alias SIO_GET_BROADCAST_ADDRESS = _WSAIOR!(IOC_WS2, 5);
|
||||||
|
alias SIO_GET_EXTENSION_FUNCTION_POINTER = _WSAIORW!(IOC_WS2, 6);
|
||||||
|
alias SIO_GET_QOS = _WSAIORW!(IOC_WS2, 7);
|
||||||
|
alias SIO_GET_GROUP_QOS = _WSAIORW!(IOC_WS2, 8);
|
||||||
|
alias SIO_MULTIPOINT_LOOPBACK = _WSAIOW!(IOC_WS2, 9);
|
||||||
|
alias SIO_MULTICAST_SCOPE = _WSAIOW!(IOC_WS2, 10);
|
||||||
|
alias SIO_SET_QOS = _WSAIOW!(IOC_WS2, 11);
|
||||||
|
alias SIO_SET_GROUP_QOS = _WSAIOW!(IOC_WS2, 12);
|
||||||
|
alias SIO_TRANSLATE_HANDLE = _WSAIORW!(IOC_WS2, 13);
|
||||||
|
alias SIO_ROUTING_INTERFACE_QUERY = _WSAIORW!(IOC_WS2, 20);
|
||||||
|
alias SIO_ROUTING_INTERFACE_CHANGE = _WSAIOW!(IOC_WS2, 21);
|
||||||
|
alias SIO_ADDRESS_LIST_QUERY = _WSAIOR!(IOC_WS2, 22);
|
||||||
|
alias SIO_ADDRESS_LIST_CHANGE = _WSAIO!(IOC_WS2, 23);
|
||||||
|
alias SIO_QUERY_TARGET_PNP_HANDLE = _WSAIOR!(IOC_WS2, 24);
|
||||||
|
alias SIO_NSP_NOTIFY_CHANGE = _WSAIOW!(IOC_WS2, 25);
|
||||||
|
|
||||||
|
alias GROUP = uint;
|
||||||
|
|
||||||
|
enum
|
||||||
|
{
|
||||||
|
WSA_FLAG_OVERLAPPED = 0x01,
|
||||||
|
WSA_FLAG_MULTIPOINT_C_ROOT = 0x02,
|
||||||
|
WSA_FLAG_MULTIPOINT_C_LEAF = 0x04,
|
||||||
|
WSA_FLAG_MULTIPOINT_D_ROOT = 0x08,
|
||||||
|
WSA_FLAG_MULTIPOINT_D_LEAF = 0x10,
|
||||||
|
WSA_FLAG_ACCESS_SYSTEM_SECURITY = 0x40,
|
||||||
|
WSA_FLAG_NO_HANDLE_INHERIT = 0x80,
|
||||||
|
WSA_FLAG_REGISTERED_IO = 0x100,
|
||||||
|
}
|
||||||
|
|
||||||
|
enum MAX_PROTOCOL_CHAIN = 7;
|
||||||
|
enum BASE_PROTOCOL = 1;
|
||||||
|
enum LAYERED_PROTOCOL = 0;
|
||||||
|
enum WSAPROTOCOL_LEN = 255;
|
||||||
|
|
||||||
|
struct WSAPROTOCOLCHAIN
|
||||||
|
{
|
||||||
|
int ChainLen;
|
||||||
|
DWORD[MAX_PROTOCOL_CHAIN] ChainEntries;
|
||||||
|
}
|
||||||
|
|
||||||
|
struct WSABUF
|
||||||
|
{
|
||||||
|
ULONG len;
|
||||||
|
CHAR* buf;
|
||||||
|
}
|
||||||
|
|
||||||
|
struct WSAPROTOCOL_INFO
|
||||||
|
{
|
||||||
|
DWORD dwServiceFlags1;
|
||||||
|
DWORD dwServiceFlags2;
|
||||||
|
DWORD dwServiceFlags3;
|
||||||
|
DWORD dwServiceFlags4;
|
||||||
|
DWORD dwProviderFlags;
|
||||||
|
GUID ProviderId;
|
||||||
|
DWORD dwCatalogEntryId;
|
||||||
|
WSAPROTOCOLCHAIN ProtocolChain;
|
||||||
|
int iVersion;
|
||||||
|
int iAddressFamily;
|
||||||
|
int iMaxSockAddr;
|
||||||
|
int iMinSockAddr;
|
||||||
|
int iSocketType;
|
||||||
|
int iProtocol;
|
||||||
|
int iProtocolMaxOffset;
|
||||||
|
int iNetworkByteOrder;
|
||||||
|
int iSecurityScheme;
|
||||||
|
DWORD dwMessageSize;
|
||||||
|
DWORD dwProviderReserved;
|
||||||
|
TCHAR[WSAPROTOCOL_LEN + 1] szProtocol;
|
||||||
|
}
|
||||||
|
|
||||||
|
const GUID WSAID_GETACCEPTEXSOCKADDRS = {
|
||||||
|
0xb5367df2, 0xcbac, 0x11cf,
|
||||||
|
[0x95, 0xca, 0x00, 0x80, 0x5f, 0x48, 0xa1, 0x92],
|
||||||
|
};
|
||||||
|
|
||||||
|
const GUID WSAID_ACCEPTEX = {
|
||||||
|
0xb5367df1, 0xcbac, 0x11cf,
|
||||||
|
[0x95, 0xca, 0x00, 0x80, 0x5f, 0x48, 0xa1, 0x92],
|
||||||
|
};
|
||||||
|
|
||||||
|
alias LPWSAOVERLAPPED_COMPLETION_ROUTINE = void function(DWORD dwError,
|
||||||
|
DWORD cbTransferred,
|
||||||
|
OVERLAPPED* lpOverlapped,
|
||||||
|
DWORD dwFlags) nothrow @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
SOCKET WSASocket(int af,
|
||||||
|
int type,
|
||||||
|
int protocol,
|
||||||
|
WSAPROTOCOL_INFO* lpProtocolInfo,
|
||||||
|
GROUP g,
|
||||||
|
DWORD dwFlags) nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
int WSARecv(SOCKET s,
|
||||||
|
WSABUF* lpBuffers,
|
||||||
|
DWORD dwBufferCount,
|
||||||
|
DWORD* lpNumberOfBytesRecvd,
|
||||||
|
DWORD* lpFlags,
|
||||||
|
OVERLAPPED* lpOverlapped,
|
||||||
|
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine)
|
||||||
|
nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
int WSASend(SOCKET s,
|
||||||
|
WSABUF* lpBuffers,
|
||||||
|
DWORD dwBufferCount,
|
||||||
|
DWORD* lpNumberOfBytesRecvd,
|
||||||
|
DWORD lpFlags,
|
||||||
|
OVERLAPPED* lpOverlapped,
|
||||||
|
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine)
|
||||||
|
nothrow @system @nogc;
|
||||||
|
|
||||||
|
extern(Windows)
|
||||||
|
int WSAIoctl(SOCKET s,
|
||||||
|
uint dwIoControlCode,
|
||||||
|
void* lpvInBuffer,
|
||||||
|
uint cbInBuffer,
|
||||||
|
void* lpvOutBuffer,
|
||||||
|
uint cbOutBuffer,
|
||||||
|
uint* lpcbBytesReturned,
|
||||||
|
OVERLAPPED* lpOverlapped,
|
||||||
|
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine)
|
||||||
|
nothrow @system @nogc;
|
||||||
|
|
||||||
|
alias ADDRESS_FAMILY = USHORT;
|
||||||
|
|
||||||
|
struct SOCKADDR
|
||||||
|
{
|
||||||
|
ADDRESS_FAMILY sa_family; // Address family.
|
||||||
|
CHAR[14] sa_data; // Up to 14 bytes of direct address.
|
||||||
|
}
|
||||||
|
|
||||||
|
alias LPFN_GETACCEPTEXSOCKADDRS = void function(void*,
|
||||||
|
DWORD,
|
||||||
|
DWORD,
|
||||||
|
DWORD,
|
||||||
|
SOCKADDR**,
|
||||||
|
INT*,
|
||||||
|
SOCKADDR**,
|
||||||
|
INT*) nothrow @nogc;
|
||||||
|
|
||||||
|
alias LPFN_ACCEPTEX = extern(Windows) BOOL function(SOCKET,
|
||||||
|
SOCKET,
|
||||||
|
void*,
|
||||||
|
DWORD,
|
||||||
|
DWORD,
|
||||||
|
DWORD,
|
||||||
|
DWORD*,
|
||||||
|
OVERLAPPED*) @nogc nothrow;
|
||||||
|
|
||||||
|
enum
|
||||||
|
{
|
||||||
|
SO_MAXDG = 0x7009,
|
||||||
|
SO_MAXPATHDG = 0x700A,
|
||||||
|
SO_UPDATE_ACCEPT_CONTEXT = 0x700B,
|
||||||
|
SO_CONNECT_TIME = 0x700C,
|
||||||
|
SO_UPDATE_CONNECT_CONTEXT = 0x7010,
|
||||||
|
}
|
105
source/tanya/test/assertion.d
Normal file
105
source/tanya/test/assertion.d
Normal file
@ -0,0 +1,105 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Additional assertions.
|
||||||
|
*
|
||||||
|
* This module provides functions that assert whether a given expression
|
||||||
|
* satisfies some complex condition, that can't be tested with
|
||||||
|
* $(D_KEYWORD assert) in a single line. Internally all the functions
|
||||||
|
* just evaluate the expression and call $(D_KEYWORD assert).
|
||||||
|
*
|
||||||
|
* The functions can cause segmentation fault if the module is compiled
|
||||||
|
* in production mode and the condition fails.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/test/assertion.d,
|
||||||
|
* tanya/test/assertion.d)
|
||||||
|
*/
|
||||||
|
module tanya.test.assertion;
|
||||||
|
|
||||||
|
import tanya.memory;
|
||||||
|
import tanya.meta.trait;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Asserts whether the function $(D_PARAM expr) throws an exception of type
|
||||||
|
* $(D_PARAM E). If it does, the exception is catched and properly destroyed.
|
||||||
|
* If it doesn't, an assertion error is thrown. If the exception doesn't match
|
||||||
|
* $(D_PARAM E) type, it isn't catched and escapes.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* E = Expected exception type.
|
||||||
|
* T = Throwing function type.
|
||||||
|
* Args = Argument types of the throwing function.
|
||||||
|
* expr = Throwing function.
|
||||||
|
* args = Arguments for $(D_PARAM expr).
|
||||||
|
*/
|
||||||
|
void assertThrown(E : Exception, T, Args...)(T expr, auto ref Args args)
|
||||||
|
if (isSomeFunction!T)
|
||||||
|
{
|
||||||
|
try
|
||||||
|
{
|
||||||
|
cast(void) expr(args);
|
||||||
|
assert(false, "Expected exception not thrown");
|
||||||
|
}
|
||||||
|
catch (E exception)
|
||||||
|
{
|
||||||
|
defaultAllocator.dispose(exception);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
// If you want to test that an expression throws, you can wrap it into an
|
||||||
|
// arrow function.
|
||||||
|
static struct CtorThrows
|
||||||
|
{
|
||||||
|
this(int i) @nogc pure @safe
|
||||||
|
{
|
||||||
|
throw defaultAllocator.make!Exception();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
assertThrown!Exception(() => CtorThrows(8));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Asserts that the function $(D_PARAM expr) doesn't throw.
|
||||||
|
*
|
||||||
|
* If it does, the thrown exception is catched, properly destroyed and an
|
||||||
|
* assertion error is thrown instead.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* T = Tested function type.
|
||||||
|
* Args = Argument types of $(D_PARAM expr).
|
||||||
|
* expr = Tested function.
|
||||||
|
* args = Arguments for $(D_PARAM expr).
|
||||||
|
*/
|
||||||
|
void assertNotThrown(T, Args...)(T expr, auto ref Args args)
|
||||||
|
if (isSomeFunction!T)
|
||||||
|
{
|
||||||
|
try
|
||||||
|
{
|
||||||
|
cast(void) expr(args);
|
||||||
|
}
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
defaultAllocator.dispose(exception);
|
||||||
|
assert(false, "Unexpected exception thrown");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
@nogc nothrow pure @safe unittest
|
||||||
|
{
|
||||||
|
// If you want to test that an expression doesn't throw, you can wrap it
|
||||||
|
// into an arrow function.
|
||||||
|
static struct S
|
||||||
|
{
|
||||||
|
}
|
||||||
|
assertNotThrown(() => S());
|
||||||
|
}
|
17
source/tanya/test/package.d
Normal file
17
source/tanya/test/package.d
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test suite for $(D_KEYWORD unittest)-blocks.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/test/package.d,
|
||||||
|
* tanya/test/package.d)
|
||||||
|
*/
|
||||||
|
module tanya.test;
|
||||||
|
|
||||||
|
public import tanya.test.assertion;
|
109
source/tanya/typecons.d
Normal file
109
source/tanya/typecons.d
Normal file
@ -0,0 +1,109 @@
|
|||||||
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||||
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||||
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Type constructors.
|
||||||
|
*
|
||||||
|
* This module contains templates that allow to build new types from the
|
||||||
|
* available ones.
|
||||||
|
*
|
||||||
|
* Copyright: Eugene Wissner 2017.
|
||||||
|
* License: $(LINK2 https://www.mozilla.org/en-US/MPL/2.0/,
|
||||||
|
* Mozilla Public License, v. 2.0).
|
||||||
|
* Authors: $(LINK2 mailto:info@caraus.de, Eugene Wissner)
|
||||||
|
* Source: $(LINK2 https://github.com/caraus-ecms/tanya/blob/master/source/tanya/typecons.d,
|
||||||
|
* tanya/typecons.d)
|
||||||
|
*/
|
||||||
|
module tanya.typecons;
|
||||||
|
|
||||||
|
import tanya.meta.metafunction;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* $(D_PSYMBOL Pair) can store two heterogeneous objects.
|
||||||
|
*
|
||||||
|
* The objects can by accessed by index as $(D_INLINECODE obj[0]) and
|
||||||
|
* $(D_INLINECODE obj[1]) or by optional names (e.g.
|
||||||
|
* $(D_INLINECODE obj.first)).
|
||||||
|
*
|
||||||
|
* $(D_PARAM Specs) contains a list of object types and names. First
|
||||||
|
* comes the object type, then an optional string containing the name.
|
||||||
|
* If you want the object be accessible only by its index (`0` or `1`),
|
||||||
|
* just skip the name.
|
||||||
|
*
|
||||||
|
* Params:
|
||||||
|
* Specs = Field types and names.
|
||||||
|
*/
|
||||||
|
template Pair(Specs...)
|
||||||
|
{
|
||||||
|
template parseSpecs(int fieldCount, Specs...)
|
||||||
|
{
|
||||||
|
static if (Specs.length == 0)
|
||||||
|
{
|
||||||
|
alias parseSpecs = AliasSeq!();
|
||||||
|
}
|
||||||
|
else static if (is(Specs[0]) && fieldCount < 2)
|
||||||
|
{
|
||||||
|
static if (is(typeof(Specs[1]) == string))
|
||||||
|
{
|
||||||
|
alias parseSpecs
|
||||||
|
= AliasSeq!(Specs[0],
|
||||||
|
parseSpecs!(fieldCount + 1, Specs[2 .. $]));
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
alias parseSpecs
|
||||||
|
= AliasSeq!(Specs[0],
|
||||||
|
parseSpecs!(fieldCount + 1, Specs[1 .. $]));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
static assert(false, "Invalid argument: " ~ Specs[0].stringof);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
struct Pair
|
||||||
|
{
|
||||||
|
/// Field types.
|
||||||
|
alias Types = parseSpecs!(0, Specs);
|
||||||
|
|
||||||
|
static assert(Types.length == 2, "Invalid argument count.");
|
||||||
|
|
||||||
|
// Create field aliases.
|
||||||
|
static if (is(typeof(Specs[1]) == string))
|
||||||
|
{
|
||||||
|
mixin("alias " ~ Specs[1] ~ " = expand[0];");
|
||||||
|
}
|
||||||
|
static if (is(typeof(Specs[2]) == string))
|
||||||
|
{
|
||||||
|
mixin("alias " ~ Specs[2] ~ " = expand[1];");
|
||||||
|
}
|
||||||
|
else static if (is(typeof(Specs[3]) == string))
|
||||||
|
{
|
||||||
|
mixin("alias " ~ Specs[3] ~ " = expand[1];");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents the values of the $(D_PSYMBOL Pair) as a list of values.
|
||||||
|
Types expand;
|
||||||
|
|
||||||
|
alias expand this;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
///
|
||||||
|
unittest
|
||||||
|
{
|
||||||
|
static assert(is(Pair!(int, int)));
|
||||||
|
static assert(!is(Pair!(int, 5)));
|
||||||
|
|
||||||
|
static assert(is(Pair!(int, "first", int)));
|
||||||
|
static assert(is(Pair!(int, "first", int, "second")));
|
||||||
|
static assert(is(Pair!(int, "first", int)));
|
||||||
|
|
||||||
|
static assert(is(Pair!(int, int, "second")));
|
||||||
|
static assert(!is(Pair!("first", int, "second", int)));
|
||||||
|
static assert(!is(Pair!(int, int, int)));
|
||||||
|
|
||||||
|
static assert(!is(Pair!(int, "first")));
|
||||||
|
}
|
Reference in New Issue
Block a user