FUNKTION
	string ansi2pinkfish(string str)

ARGUMENTE
	str: zu bearbeitende Zeichenkette

BESCHREIBUNG
	Wandelt in einem String enthaltene ANSI Escape Farbsequenzen
	in ihre Pinkfish Aequivalente.

	Die Umwandlung ist nicht ideal, so wird zB YELLOW nur als
	BOLD ORANGE kodiert. Das ist zwar technisch korrekt, aber
	nutzt nicht die Moeglichkeiten von Pinkfish. Andersrum gibt
	es nicht fuer alle Escape-Sequenzen einen Pinkfish Ausdruck.
	So wird 'ESC [ 49 m' als RESET kodiert und nicht nur als
	Hintergrund-Zuruecksetzen.

BEISPIELE
	ansi2pinkfish("\e[31mblah\e[0m")
        => "%^RED%^blah%^RESET%^"

        string s;
        s = terminal_colour("%^GREEN%^Rasen %^RED%^Rosen%^RESET%^ ",
              PINKFISH_2_ANSI);
        s = ansi2pinkfish(s);
        => "%^GREEN%^Rasen %^RED%^Rosen%^RESET%^ "

        s = "%^YELLOW%^Sonnenblume Mneme%^RESET%^"
        s = ansi2pinkfish(terminal_colour(s, PINKFISH_2_ANSI));
        => "%^BOLD%^%^ORANGE%^Sonnenblume Mneme%^RESET%^"

SIEHE AUCH
	terminal_colour(E), break_string(S)