| ... | @@ -7366,18 +7366,20 @@ pub const CallOptions = struct { | ... | @@ -7366,18 +7366,20 @@ pub const CallOptions = struct { |
| 7366 | {#header_close#} | 7366 | {#header_close#} |
| 7367 | | 7367 | |
| 7368 | {#header_open|@clz#} | 7368 | {#header_open|@clz#} |
| 7369 | <pre>{#syntax#}@clz(comptime T: type, integer: T){#endsyntax#}</pre> | 7369 | <pre>{#syntax#}@clz(comptime T: type, operand: T){#endsyntax#}</pre> |
| | 7370 | <p>{#syntax#}T{#endsyntax#} must be an integer type.</p> |
| | 7371 | <p>{#syntax#}operand{#endsyntax#} may be an {#link|integer|Integers#} or {#link|vector|Vectors#}.</p> |
| 7370 | <p> | 7372 | <p> |
| 7371 | This function counts the number of most-significant (leading in a big-Endian sense) zeroes in {#syntax#}integer{#endsyntax#}. | 7373 | This function counts the number of most-significant (leading in a big-Endian sense) zeroes in an integer. |
| 7372 | </p> | 7374 | </p> |
| 7373 | <p> | 7375 | <p> |
| 7374 | If {#syntax#}integer{#endsyntax#} is known at {#link|comptime#}, | 7376 | If {#syntax#}operand{#endsyntax#} is a {#link|comptime#}-known integer, |
| 7375 | the return type is {#syntax#}comptime_int{#endsyntax#}. | 7377 | the return type is {#syntax#}comptime_int{#endsyntax#}. |
| 7376 | Otherwise, the return type is an unsigned integer with the minimum number | 7378 | Otherwise, the return type is an unsigned integer or vector of unsigned integers with the minimum number |
| 7377 | of bits that can represent the bit count of the integer type. | 7379 | of bits that can represent the bit count of the integer type. |
| 7378 | </p> | 7380 | </p> |
| 7379 | <p> | 7381 | <p> |
| 7380 | If {#syntax#}integer{#endsyntax#} is zero, {#syntax#}@clz{#endsyntax#} returns the bit width | 7382 | If {#syntax#}operand{#endsyntax#} is zero, {#syntax#}@clz{#endsyntax#} returns the bit width |
| 7381 | of integer type {#syntax#}T{#endsyntax#}. | 7383 | of integer type {#syntax#}T{#endsyntax#}. |
| 7382 | </p> | 7384 | </p> |
| 7383 | {#see_also|@ctz|@popCount#} | 7385 | {#see_also|@ctz|@popCount#} |
| ... | @@ -7509,18 +7511,20 @@ test "main" { | ... | @@ -7509,18 +7511,20 @@ test "main" { |
| 7509 | {#header_close#} | 7511 | {#header_close#} |
| 7510 | | 7512 | |
| 7511 | {#header_open|@ctz#} | 7513 | {#header_open|@ctz#} |
| 7512 | <pre>{#syntax#}@ctz(comptime T: type, integer: T){#endsyntax#}</pre> | 7514 | <pre>{#syntax#}@ctz(comptime T: type, operand: T){#endsyntax#}</pre> |
| | 7515 | <p>{#syntax#}T{#endsyntax#} must be an integer type.</p> |
| | 7516 | <p>{#syntax#}operand{#endsyntax#} may be an {#link|integer|Integers#} or {#link|vector|Vectors#}.</p> |
| 7513 | <p> | 7517 | <p> |
| 7514 | This function counts the number of least-significant (trailing in a big-Endian sense) zeroes in {#syntax#}integer{#endsyntax#}. | 7518 | This function counts the number of least-significant (trailing in a big-Endian sense) zeroes in an integer. |
| 7515 | </p> | 7519 | </p> |
| 7516 | <p> | 7520 | <p> |
| 7517 | If {#syntax#}integer{#endsyntax#} is known at {#link|comptime#}, | 7521 | If {#syntax#}operand{#endsyntax#} is a {#link|comptime#}-known integer, |
| 7518 | the return type is {#syntax#}comptime_int{#endsyntax#}. | 7522 | the return type is {#syntax#}comptime_int{#endsyntax#}. |
| 7519 | Otherwise, the return type is an unsigned integer with the minimum number | 7523 | Otherwise, the return type is an unsigned integer or vector of unsigned integers with the minimum number |
| 7520 | of bits that can represent the bit count of the integer type. | 7524 | of bits that can represent the bit count of the integer type. |
| 7521 | </p> | 7525 | </p> |
| 7522 | <p> | 7526 | <p> |
| 7523 | If {#syntax#}integer{#endsyntax#} is zero, {#syntax#}@ctz{#endsyntax#} returns | 7527 | If {#syntax#}operand{#endsyntax#} is zero, {#syntax#}@ctz{#endsyntax#} returns |
| 7524 | the bit width of integer type {#syntax#}T{#endsyntax#}. | 7528 | the bit width of integer type {#syntax#}T{#endsyntax#}. |
| 7525 | </p> | 7529 | </p> |
| 7526 | {#see_also|@clz|@popCount#} | 7530 | {#see_also|@clz|@popCount#} |
Auguste Rame <auguste.rame@gmail.com> 2021-07-25 22:58:58-04:00