Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function
int8
conversion to one byte integer representation
int16
conversion to 2 bytes integer representation
int32
conversion to 4 bytes integer representation
int64
conversion to 8 bytes integer representation
uint8
conversion to one byte unsigned integer representation
uint16
conversion to 2 bytes unsigned integer representation
uint32
conversion to 4 bytes unsigned integer representation
uint64
conversion to 8 bytes unsigned integer representation
Syntax
y = int8(X) y = int16(X) y = int32(X) y = int64(X) y = uint8(X) y = uint16(X) y = uint32(X) y = uint64(X)
Arguments
- X
matrix of booleans, of encoded integers, or of decimal real or complex numbers.
- y
matrix of integers encoded on 1, 2, 4 or 8 bytes. Its sizes are X ones.
Description
These functions convert and store data to one, two, four, or eight bytes integers. These data types are especially useful to store big objects such as images, long signals,...
 | If some int8([-3.6, -2.5, -1.4, 1.3, 3.5, 6.7]) // = [-3, -2, -1, 1, 3, 6].
Values of
-%inf is always converted into the lower bound of the interval (see below). %inf is always converted into the upper bound of the interval (see below). %nan is always converted into 0. If [%f %t] is always converted into [0 1]. Converting big int64 or uint64 integers into decimal numbers may change them and downgrade their relative accuracy. Indeed, int64|uint64 integers are encoded over 63|64 bits, while the mantissa of decimal numbers is encoded over 53 bits only. For more details, please refer to the double() page. |
| Converting [] always keeps it as is, of type 1 (decimal type). |
| Function | y in | = |
|---|---|---|
| int8(X) | [- 27, 27-1] | [-128, 127] |
| int16(X) | [- 215, 215-1] | [-32768, 32767] |
| int32(X) | [- 231, 231-1] | [-2147483648, 2147483647] |
| int64(X) | [- 263, 263-1] | [-9223372036854775808, 9223372036854775807] |
| uint8(X) | [0, 28-1] | [0, 255] |
| uint16(X) | [0, 216-1] | [0, 65535] |
| uint32(X) | [0, 232-1] | [0, 4294967295] |
| uint64(X) | [0, 264-1] | [0, 18446744073709551615] |
Examples
Rounding to 0 and wrapping, and special values:
int8([-11.7 -8.5 -6.4 6.4 8.5 11.7]) int8([-130 -129 -128 -127 126 127 128 129]) a = -129 + 256*(-3:3) int8(a) int8([-%inf %inf %nan])
--> int8([-11.7 -8.5 -6.4 6.4 8.5 11.7]) ans = -11 -8 -6 6 8 11 --> int8([-130 -129 -128 -127 126 127 128 129]) ans = 126 127 -128 -127 126 127 -128 -127 --> a = -129 + 256*(-3:3) a = -897. -641. -385. -129. 127. 383. 639. --> int8(a) ans = 127 127 127 127 127 127 127 --> int8([-%inf %inf %nan]) ans = -128 127 0
About wrapping and upper bounds of unsigned integers:
--> uint8([-1 %inf]) ans = 255 255 --> uint16([-1 %inf]) ans = 65535 65535 --> uint32([-1 %inf]) ans = 4294967295 4294967295 --> uint64([-1 %inf]) ans = 18446744073709551615 18446744073709551615
Converting 64-bits integers into decimal numbers downgrades their accuracy:
i = uint64(2)^63 - 600 i - uint64(double(i))
--> i = uint64(2)^63 - 600 i = 9223372036854775208 --> i - uint64(double(i)) ans = 424
Converting booleans and complex numbers:
--> int8([%f %t]) ans = 0 1 --> int8(-10.2 + 3.4*%i) ans = -10 --> uint8(-10.2 + 3.4*%i) ans = 246
[] is not convertible:
--> i = uint16(3);
--> i(1,2) = 5.6
i =
3 5
--> typeof(i)
ans =
uint16
--> i = uint16([])
i =
[]
--> i(1,2) = 2.3
i =
0. 2.3
--> typeof(i)
ans =
constant
See also
History
| Version | Description | |||||||||||||||||||||
| 6.0 |
|
| Report an issue | ||
| << iconvert | Integers | inttype >> |