Function encoding_c::encoding_new_encoder
[−]
[src]
#[no_mangle]pub unsafe extern "C" fn encoding_new_encoder(
encoding: *const Encoding
) -> *mut Encoder
Allocates a new Encoder
for the given Encoding
on the heap and returns a
pointer to the newly-allocated Encoder
. (Exception, if the Encoding
is
replacement
, a new Decoder
for UTF-8 is instantiated (and that
Decoder
reports UTF_8
as its Encoding
).
Once the allocated Encoder
is no longer needed, the caller MUST
deallocate it by passing the pointer returned by this function to
encoder_free()
.
Undefined behavior
UB ensues if the argument is NULL
.