STR_TO_BYTES(3)
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.