uconvert_size - Man Page

Number of bytes needed to store a string after conversion. Allegro game programming library.

Synopsis

#include <allegro.h>

int uconvert_size(const char *s, int type, int newtype);

Description

Finds out how many bytes are required to store the specified string `s' after a conversion from `type' to `newtype', including the mandatory zero terminator of the string. You can use U_CURRENT for either `type' or `newtype' as a shortcut to represent whatever text encoding format is currently selected. Example:

   length = uconvert_size(old_string, U_CURRENT, U_UNICODE);
   new_string = malloc(length);
   ustrcpy(new_string, old_string);

Return Value

Returns the number of bytes required to store the string after conversion.

See Also

need_uconvert(3), do_uconvert(3)

Info

version 4.4.3 Allegro manual