man str_to_bytes (Fonctions bibliothèques) - convert a string to a int byte count str_to_lbytes - convert a string to a long byte count str_to_llbytes - convert a string to a long long byte count
NAME
str_to_bytes - convert a string to a int byte count str_to_lbytes - convert a string to a long byte count str_to_llbytes - convert a string to a long long byte count
SYNOPSIS
int str_to_byte(char *str);
long str_to_lbyte(char *str);
long long str_to_llbyte(char *str);
DESCRIPTION
str_to_bytes(), str_to_lbytes(), and str_to_llbytes() converts str to an integer, long, or long long byte count. str is an floating point number optionally followed by a single character multiplier. Currently the following multipliers are supported:
Char Meaning Multiplier
---- --------- --------------------------------
b Blocks BSIZE or UBSIZE
k Kilobytes 2^10 (1024)
K Kilowords 2^10 (1024) * sizeof(long)
m Megabytes 2^20 (1048576)
M Megawords 2^20 (1048576) * sizeof(long)
g Gigabytes 2^30 (1073741824)
G Gigawords 2^30 (1073741824) * sizeof(long)
str is interpreted as floating point number (base 10).
When using str_to_llbytes(), the uppercase suffix will result
in multiplying by the size of a (long long) or 8.
RETURNS
-1 if the integer portion of str is invalid, if an unsupported multiplier is supplied, or if str has extra leading or trailing characters. If str contains a negative number, the return value will be negative.
EXAMPLES
str_to_bytes("1000")
Returns 1000
str_to_bytes("5b")
Returns 5 * BSIZE.
str_to_bytes("1.5m")
Returns 1.5 * 1048576 or 1572864
LIMITATIONS
str_to_bytes() and str_to_lbytes() when compiled as a 32 bit IRIX binary can only return a max number of 2g (2147483647). However, str_to_lbytes() is not limited by the 2g limit when compiled as 64 bit binary, where str_to_bytes() still is limited.
Note that the size of long will vary depending how if compiled as a 32 or 64 bit binary. The size of a long long is always 8.
Also note that on a traditional CRAY system, a block is 4096 bytes, where on most IRIX systems a block is 1024 bytes.