set_integer_promotion: Tag a connection with the preferred integer promotion method...

In ctypesio: Read and Write Standard 'C' Types from Files, Connections and Raw Vectors

Tag a connection with the preferred integer promotion method for types larger that R's integer type i.e. uint32, uint64, int64

Description

Tag a connection with the preferred integer promotion method for types larger that R's integer type i.e. uint32, uint64, int64

Usage

set_integer_promotion(con, uint32 = "dbl", int64 = "dbl", uint64 = "dbl")

Arguments

con

Connection object or raw vector. Connection objects can be created with file(), url(), rawConnection() or any of the other many connection creation functions.

uint32, int64, uint64

specifiy separate promotion methods for these types One of: 'dbl', 'hex', 'raw' and 'bit64' (for 64-bit types only) Default: 'dbl'. This default may be over-ridden by specifying the promote argument when calling individual functions. dbl Read in integers as doubles. Integer values above 2^53 will lose precision. hex Each integer is returned as a hexadecimal string raw A single raw vector containing all the integers in their original form bit64 Return an integer64 vector compatible with the bit64 package. Note. integer64 is a signed 64-bit integer

Value

Modified connection object

See Also

Other connection configuration functions: set_bounds_check(), set_endian(), set_eof_check(), set_na_check()

Examples

# Open a connection and configure it so all 'uint32' values are 
# read as floating point and all all 'uint64' values are read as hexadecimal strings
con <- rawConnection(as.raw(c(1:7, 0, 1:7, 0, 1:7, 0, 1:7, 0)), "rb")
con <- set_integer_promotion(con, uint32 = "dbl", uint64 = "hex")

# Future reads of uint64 will return hex strings
read_uint64(con, n = 2)

# Unless over-ridden during the read
read_uint64(con, n = 1, promote = "dbl")

close(con)

ctypesio documentation built on April 3, 2025, 7:28 p.m.