Commit e309ad884a5d2fc8b78325199cd6e81d2efa220d | zig

author	Andrew Kelley <andrew@ziglang.org> 2019-04-10 22:58:42-04:00
committer	Andrew Kelley <andrew@ziglang.org> 2019-04-10 23:00:53-04:00
log	e309ad884a5d2fc8b78325199cd6e81d2efa220d
tree	3a421862bdef192c0f823feafbea0315bf5d9bf3
parent	a4c7e4c4eb7b1000252fab3f98f6204edb48a4bd
signature	Commit is signed but in an unrecognized format.

closes #2234

1 files changed, 18 insertions(+), 8 deletions(-)

doc/langref.html.in+18-8

 @@ -7360,20 +7360,30 @@ fn List(comptime T: type) type {
       <pre>{#syntax#}@truncate(comptime T: type, integer: var) T{#endsyntax#}</pre>
       <p>
       This function truncates bits from an integer type, resulting in a smaller
-      integer type.
+      or same-sized integer type.
       </p>
       <p>
-      The following produces a crash in {#link|Debug#} mode and {#link|Undefined Behavior#} in
+      The following produces safety-checked {#link|Undefined Behavior#}:
-      {#link|ReleaseFast#} mode:
       </p>
-      <pre>{#syntax#}const a: u16 = 0xabcd;
+      {#code_begin|test_err|cast truncated bits#}
-const b: u8 = u8(a);{#endsyntax#}</pre>
+test "integer cast panic" {
+    var a: u16 = 0xabcd;
+    var b: u8 = @intCast(u8, a);
+}
+      {#code_end#}
       <p>
       However this is well defined and working code:
       </p>
-      <pre>{#syntax#}const a: u16 = 0xabcd;
+      {#code_begin|test|truncate#}
-const b: u8 = @truncate(u8, a);
+const std = @import("std");
-// b is now 0xcd{#endsyntax#}</pre>
+const assert = std.debug.assert;
+test "integer truncation" {
+    var a: u16 = 0xabcd;
+    var b: u8 = @truncate(u8, a);
+    assert(b == 0xcd);
+}
+      {#code_end#}
       <p>
       This function always truncates the significant bits of the integer, regardless
       of endianness on the target platform.