std.conv

A one-stop shop for converting values from one type to another.


Category	Functions
Generic	asOriginalType castFrom parse to toChars
Strings	text wtext dtext hexString
Numeric	octal roundTo signed unsigned
Exceptions	ConvException ConvOverflowException

Members

Classes

ConvException class ConvException: Thrown on conversion errors.
ConvOverflowException class ConvOverflowException: Thrown on conversion overflow errors.

Enums

LetterCase (from std.ascii) enum LetterCase via public import std.ascii : LetterCase;: Letter case specifier.

Functions

asOriginalType OriginalType!E asOriginalType(E value)

Returns the representation of an enumerated value, i.e. the value converted to the base type of the enumeration.

dtext dstring dtext(T args)

Convenience functions for converting one or more arguments of any type into text (the three character widths).

parse auto parse(Source source)

The parse family of functions works quite like the to family, except that:

It only works with character ranges as input.
It takes the input by reference. (This means that rvalues - such as string literals - are not accepted: use to instead.)
It advances the input to the position following the conversion.
It does not throw if it could not convert the entire input.

parse auto parse(Source s)

auto parse(Source source, uint radix)

Parses a character input range to an integral value.

parse auto parse(Source s)

Takes a string representing an enum type and returns that type.

parse auto parse(Source source)

Parses a character range to a floating point number.

parse auto parse(Source s)

Parsing one character off a range returns the first element and calls popFront.

parse auto parse(Source s)

Parsing a character range to typeof(null) returns null if the range spells "null". This function is case insensitive.

parse auto parse(Source s, dchar lbracket, dchar rbracket, dchar comma)

Parses an array from a string given the left bracket (default '['), right bracket (default ']'), and element separator (by default ','). A trailing separator is allowed.

parse auto parse(Source s, dchar lbracket, dchar rbracket, dchar keyval, dchar comma)

Parses an associative array from a string given the left bracket (default '['), right bracket (default ']'), key-value separator (default ':'), and element seprator (by default ',').

signed auto signed(T x)

Returns the corresponding signed value for x (e.g. if x has type uint, it returns cast(int) x). The advantage compared to the cast is that you do not need to rewrite the cast if x later changes type (e.g from uint to ulong).

text string text(T args)

Convenience functions for converting one or more arguments of any type into text (the three character widths).

toChars auto toChars(T value)

Convert integer to a range of characters. Intended to be lightweight and fast.

unsigned auto unsigned(T x)

Returns the corresponding unsigned value for x (e.g. if x has type int, it returns cast(uint) x). The advantage compared to the cast is that you do not need to rewrite the cast if x later changes type (e.g from int to long).

wtext wstring wtext(T args)

Convenience functions for converting one or more arguments of any type into text (the three character widths).

Imports

emplace (from core.lifetime) public import core.lifetime : emplace;: Undocumented in source.

Templates

castFrom template castFrom(From): A wrapper on top of the built-in cast operator that allows one to restrict casting of the original type of the value.
hexString template hexString(wstring hexData): Converts a hex literal to a string at compile time.
hexString template hexString(string hexData)
template hexString(dstring hexData): Converts a hex literal to a string at compile time.
octal template octal(string num)
template octal(alias decimalInteger): The octal facility provides a means to declare a number in base 8. Using octal!177 or octal!"177" for 127 represented in octal (same as 0177 in C).
roundTo template roundTo(Target): Rounded conversion from floating point to integral.
to template to(T): The to template converts a value from one type to another. The source type is deduced and the target type must be specified, for example the expression to!int(42.0) converts the number 42 from double to int. The conversion is "safe", i.e., it checks for overflow; to!int(4.2e10) would throw the ConvOverflowException exception. Overflow checks are only inserted when necessary, e.g., to!double(42) does not do any checking because any int fits in a double.

std.conv

Members

Classes

Enums

Functions

Imports

Templates

Meta

Source

License

Copyright

Authors