Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.1 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Elementary Functions > Integers > iconvert

iconvert

conversion to 1 to 8 byte integer representation

Syntax

y = iconvert(X, itype)

Arguments

X

a matrix of decimal numbers, encoded integers, or booleans. Complex numbers are not supported.

itype

an integer: conversion code

y

matrix of integers encoded on 1, 2, 4 or 8 bytes, with the sizes of X : y(i) is X(i) converted into the chosen encoding.

Description

The iconvert function converts and stores data to 1, 2, 4 or 8 bytes integers. Please refer to the int8() page for a detailled description.

itypey typeof range
0 (reals)
1 int8 [-128, 127]
2 int16 [-32768, 32767]
4 int32 [-2147483648, 2147483647]
8 int64 [-9223372036854775808, 9223372036854775807]
11 uint8 [0, 255]
12 uint16 [0, 65535]
14 uint32 [0, 4294967295]
18 uint64 [0, 18446744073709551615]

Converting [] always keeps it as is, of type 1 == inttype 0 (decimal type).

Examples

b=int32([1 -120 127 312])
y=iconvert(b,1)

typeof(b)
typeof(y)

iconvert([-3.6 -2.5 -1.2 1.2 2.5 3.6], 1)
iconvert([-%inf %inf %nan], 1)
iconvert([-%inf %inf %nan], 11)
iconvert(-1, 11)
iconvert(-1, 12)
iconvert(-1, 14)
iconvert(-1, 18)
--> iconvert([-3.6 -2.5 -1.2 1.2 2.5 3.6], 1)
 ans  =
 -3 -2 -1  1  2  3

--> iconvert([-%inf %inf %nan], 1)
 ans  =
 -128  127  0

--> iconvert([-%inf %inf %nan], 11)
 ans  =
  0  255  0

--> iconvert(-1, 11)
 ans  =
  255

--> iconvert(-1, 12)
 ans  =
  65535

--> iconvert(-1, 14)
 ans  =
  4294967295

--> iconvert(-1, 18)
 ans  =
  18446744073709551615

See also

  • int8 — conversion to one byte integer representation
  • inttype — type integers used in integer data types
  • double — converts inttype integers or booleans into decimal encoding
  • dec2bin — convert from decimal to binary
  • dec2base — Convert decimal to base N number in string

History

VersionDescription
6.0
  • Support to int64 and uint64 encodings added.
  • This is now instead of
    iconvert([-%inf,%inf], 1)[-128, 127][0, 0]
    iconvert([-%inf,%inf], 2)[-32768, 32767][0, 0]
    iconvert(%inf, 4) 2147483647 -2147483648
    iconvert(%inf, 11) 255 0
    iconvert(%inf, 12) 65535 0
    iconvert(%inf, 14) 4294967295 0
Report an issue
<< Integers Integers int8 >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jan 03 14:23:23 CET 2022