.\" Generated by the Allegro makedoc utility
.TH uconvert_size 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
uconvert_size \- Number of bytes needed to store a string after conversion. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int uconvert_size(const char *s, int type, int newtype);
.SH 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:

.nf
   length = uconvert_size(old_string, U_CURRENT, U_UNICODE);
   new_string = malloc(length);
   ustrcpy(new_string, old_string);
.fi
.SH "RETURN VALUE"
Returns the number of bytes required to store the string after conversion.

.SH SEE ALSO
.BR need_uconvert (3alleg4),
.BR do_uconvert (3alleg4)