reverse

Reverses a UTF-8 string.

str must be valid UTF-8 encoded text. (Use [func@GLib.utf8_validate] on all text before trying to use UTF-8 utility functions with it.)

This function is intended for programmatic uses of reversed strings. It pays no attention to decomposed characters, combining marks, byte order marks, directional indicators (LRM, LRO, etc) and similar characters which might need special handling when reversing a string for display purposes.

Note that unlike [func@GLib.strreverse], this function returns newly-allocated memory, which should be freed with [func@GLib.free] when no longer needed.

Example: Reverse a string:

public static int main (string[] args) {
	// Output: ``I ain't afraid of no dalek!``
	string my_secret = "!kelad on fo diarfa t'nia I".reverse ();
	print ("%s\n", my_secret);
	return 0;
}

valac --pkg glib-2.0 string.reverse.vala

Parameters:

len	the maximum length of str to use, in bytes. If len is negative, then the string is nul-terminated.
str	a UTF-8 encoded string

Returns:

a newly-allocated string which is the reverse of str