unescape_segment

Unescapes a segment of an escaped string.

If any of the characters in illegal_characters or the NUL character appears as an escaped character in escaped_string , then that is an error and null will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling.

Note: `NUL` byte is not accepted in the output, in contrast to unescape_bytes.

Example: Unescape segments:

public static int main (string[] args) {
	string ressource = "foo/my%2F1.%20ressource.txt";
	//					    ^-----------------^
	//                   start             end

	unowned string start = (string) ((char*)ressource + 4);
	unowned string end = (string) ((char*)ressource + 27);

	// Output:
	//  ``start: "my%2F1.%20ressource.txt"``
	//  ``end: ""``
	print ("start: \"%s\"\n", start);
	print ("end: \"%s\"\n", end);


	// Output: ``Unescaped segment: "my/1. ressource.txt"``
	string? segment = Uri.unescape_segment (start, end);
	print ("Unescaped segment: \"%s\"\n", segment);

	// Output: ``Unescaped segment: "(null)"``
	segment = Uri.unescape_segment (start, end, "/");
	print ("Unescaped segment: \"%s\"\n", segment);


	// Output: ``Unescaped segment: "(null)"``
	segment = Uri.unescape_segment (null, null);
	print ("Unescaped segment: \"%s\"\n", segment);

	return 0;
}

valac --pkg glib-2.0 GLib.Uri.unescape_segment.vala

Parameters:

Returns: