Codehunter Works präsentiert
  Version 1.4
Die freie Bibliothek für Borland Delphi © 4 bis 7
dwReplaceStr
Ersetzt ausgewählte Zeichen innerhalb eines Strings durch einen anderen String.
function dwReplaceStr(OldStr, FillStr: String; ReplaceChar: Char; AlignRight: Boolean): String;
Unit
dwStrings
Parameter
OldStr
Typ: String
Bezeichnet den zu verarbeitenden String, in dem ausgewählte Zeichen ersetzt werden sollen
FillStr
Typ: String
Bezeichnet den einzusetzenden String
ReplaceChar
Typ: Char
Bezeichnet das Zeichen, welches zu ersetzen ist
AlignRight
Typ: Boolean
Gibt an, ob der einzusetzende String links- oder rechtsbündig in OldStr eingesetzt wird
Rückgabewert
Typ: String
Diese Funktion gibt den geänderten String zurück. Kommt ReplaceChar in OldStr nicht vor, so ist der Rückgabewert identisch mit OldStr.
Bemerkungen
Diese Funktion ersetzt alle Vorkommen von ReplaceChar in OldStr durch FillStr. Ist die Länge von FillStr größer der Anzahl der Vorkommen von ReplaceChar in OldStr, so werden nur so viele Zeichen von FillStr in OldStr eingefügt, wie das Zeichen ReplaceChar in OldStr vorhanden ist. Ist die Länge von FillStr kleiner als die Anzahl der Vorkommen von ReplaceChar in OldStr, so werden nur so viele der Zeichen, welche in OldStr mit ReplaceChar übereinstimmen ersetzt, wie FillStr Zeichen enthält. Die übrigen Zeichen in OldStr, die mit ReplaceChar übereinstimmen, werden nicht ersetzt. Die Zeichen in OldStr, welche mit ReplaceChar übereinstimmen, müssen nicht zusammenhängend in OldStr vorkommen. Es können sich andere Zeichen dazwischen befinden. Für die Ausführung der Funktion hat dies keine Bedeutung. Die nicht mit ReplaceChar übereinstimmenden Zeichen werden ignoriert. AlignRight bestimmt die Ausrichtung des einzufügenden Strings. Ist AlignRight FALSE, so wird linksbündig eingefügt. Das bedeutet, daß das Zeichen mit dem niedrigsten Index aus FillStr das Zeichen mit dem niedrigsten Index in OldStr, welches mit ReplaceChar übereinstimmt, ersetzt. Es folgt das Zeichen mit dem zweitniedrigsten Index usw. Ist AlignRight TRUE, so wird rechtsbündig eingefügt. In diesem Fall wird das Zeichen mit dem höchsten Index aus FillStr das Zeichen mit dem höchsten Index in OldStr, welches mit ReplaceChar übereinstimmt, ersetzen. Es folgt das Zeichen mit dem zweithöchsten Index, usw.
Kompatibilität
Windows NT/2000/XP: Windows NT, Windows 2000, Windows XP, Windows Server 2003
Windows 95/98/Me: Windows 95, Windows 98, Windows ME
Siehe auch
Übersicht der Units, Übersicht von dwStrings.pas, dwReverseStr
Autoren-Info
Autor: Codehunter
eMail-Adresse: codehunter [at] gmx [dot] net
Link: http://delphiworks.sourceforge.net
 

DelphiWorks SDK 10th Bithday Edition Version 1.4 Stable
Dokumentation © 2000-2004 Codehunter Works
Diese Seite wurde erzeugt am 14.02.2005 20:56:50 Uhr.