A biblioteca padrão
Slide 49 de 85
49convA biblioteca padrão

Conversões

hive.conv é pura, então funciona tanto em um func quanto em um proc, e é o único lugar onde um número muda de tipo — nada converte um implicitamente.

  • ceil(v), floor(v) e round(v) transformam um Float em um Int: para cima, para baixo, e para o mais próximo com uma metade arredondada para longe do zero. Então ceil(-0.5) é 0, floor(-0.5) é -1 e round(-0.5) é -1.
  • itf(v) amplia um Int para um Float.
  • its(v) e fts(v) escrevem um número como Str, do jeito que o echo faz: fts(3.0) é "3".
  • sti(text) e stf(text) leem um número de volta, e respondem com um Result cujo ConversionError carrega a input e uma message. sti aceita um sinal opcional e dígitos decimais, nada mais — nem " 42", 1_000, 0x1F, 1.0, ou um número grande demais para um Int. stf aceita o que o parser do Go aceita, expoentes e Inf incluídos, mas sem espaços e sem vírgula no lugar do ponto.
Interpretando texto
proc main(): void {
	if hive.conv.sti("42") is Result.Ok(n) {
		echo n + 1
	}
}
Arredondando e ampliando
proc main(): void {
	half := hive.conv.itf(5) / 2.0   // amplia primeiro — Int e Float nunca se misturam
	echo hive.conv.round(half)
	echo hive.conv.fts(half)
	echo hive.conv.its(hive.conv.ceil(half))
}
O que sti recusa
proc main(): void {
	for each text in ["+5", " 42", "1_000", "1.0"] {
		if hive.conv.sti(text) is Result.Ok(n) {
			echo "{text} -> {n}"
		} else if hive.conv.sti(text) is Result.Error(why) {
			echo "{why.input}: {why.message}"
		}
	}
	echo hive.conv.floor(-0.5)    // -1
	echo hive.conv.ceil(-0.5)     // 0
}