uconvert_size(3alleg)

uconvert_size3alleg

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

Usage

#include <allegro.h>

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

Overview

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.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0

From liballegro-doc 2:4.2.2-2.2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.