phobos ~master (2023-10-10T16:11:09Z)

toChars

std conv

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

pure nothrow @nogc @safe
auto
toChars
(
ubyte radix = 10
Char = char
LetterCase letterCase = LetterCase.lower
T
)
(
T value
)
if (
(
radix == 2 ||
radix == 8
||
radix == 10
||
radix == 16
) &&
(
is(immutable T == immutable uint) ||
is(immutable T == immutable ulong)
||
radix == 10 &&
(
is(immutable T == immutable int) ||
is(immutable T == immutable long)
)
)
)

Parameters

radix

2, 8, 10, 16

Char

character type for output

letterCase

lower for deadbeef, upper for DEADBEEF

value T

integer to convert. Can be uint or ulong. If radix is 10, can also be int or long.

Return Value

Type: auto

Random access range with slicing and everything

Examples

import std.algorithm.comparison : equal;

assert(toChars(1).equal("1"));
assert(toChars(1_000_000).equal("1000000"));

assert(toChars!(2)(2U).equal("10"));
assert(toChars!(16)(255U).equal("ff"));
assert(toChars!(16, char, LetterCase.upper)(255U).equal("FF"));

Meta

Source

See Implementation

std conv classesfunctionstemplates

Page generated by adrdox