stri_numbytes: Count the Number of Bytes

Description Usage Arguments Details Value See Also Examples

Description

Counts the number of bytes needed to store all the characters of each string in computer's memory.

Usage

1

Arguments

str

character vector

Details

This is often not the function you would normally use in your string processing activities. See rather stri_length.

For 8-bit encoded strings, this is the same as stri_length. For UTF-8 strings, the returned values may be greater than the number of code points, as UTF-8 is not a fixed-byte encoding: one code point may be represented with 1-4 bytes (according to the current Unicode standard).

Missing values are handled properly, as opposed to the built-in nchar(str, "bytes") function call.

The strings do not need to be re-encoded to perform this operation.

The returned values does not of course include the trailing NUL bytes, which are used internally to mark the end of string data (in C).

Value

Returns an integer vector of the same length as str.

See Also

Other length: stri_isempty; stri_length

Examples

1
2
3
4
5
6
7
8
stri_numbytes(letters)
stri_numbytes(c('abc','123','\u0105\u0104'))
## Not run: 
# this may fail on Windows, as there is no native support for 4-bytes
# Unicode characters; see, however, stri_escape_unicode():
stri_numbytes('\U7fffffff') # compare stri_length('\U7fffffff')

## End(Not run)

stringi documentation built on May 2, 2019, 4:54 p.m.