easy-cast 0.1.0

Type conversions which are expected to succeed
Documentation

Easy-cast

Test Status Docs

Type conversion, success expected

Use the Conv and Cast traits when:

  • From and Into are not enough
  • it is expected that the value can be represented exactly by the target type
  • you could use as, but want some assurance it's doing the right thing
  • you are converting numbers (future versions might consider supporting other conversions)

Use the ConvFloat and CastFloat traits when:

  • You are converting from f32 or f64
  • You specifically want the nearest or ceiling or floor, but don't need detailed control over rounding (e.g. round-to-even)

Assertions

All type conversions which are potentially fallible assert on failure in debug builds. In release builds assertions are omitted, except where the source type is floating-point. It is thus possible that incorrect values may be produced.

Copyright and Licence

The COPYRIGHT file includes a list of contributors who claim copyright on this project. This list may be incomplete; new contributors may optionally add themselves to this list.

The easy-cast library is published under the terms of the Apache License, Version 2.0. You may obtain a copy of this licence from the LICENSE file or on the following webpage: https://www.apache.org/licenses/LICENSE-2.0