visual basic 6 referenz
visual basic 6 referenz rudolf huttary
new technology Markt+Technik Verlag
Die Deutsche Bibliothek – CIP-Einheitsaufnahme Ein Titeldatensatz für diese Publikation ist bei Der Deutschen Bibliothek erhältlich. Die Informationen in diesem Produkt werden ohne Rücksicht auf einen eventuellen Patentschutz veröffentlicht. Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt. Bei der Zusammenstellung von Texten und Abbildungen wurde mit größter Sorgfalt vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Verlag, Herausgeber und Autoren können für fehlerhafte Angaben und deren Folgen weder eine juristische Verantwortung noch irgendeine Haftung übernehmen. Für Verbesserungsvorschläge und Hinweise auf Fehler sind Verlag und Herausgeber dankbar.
Alle Rechte vorbehalten, auch die der fotomechanischen Wiedergabe und der Speicherung in elektronischen Medien. Die gewerbliche Nutzung der in diesem Produkt gezeigten Modelle und Arbeiten ist nicht zulässig. Fast alle Hardware- und Softwarebezeichnungen, die in diesem Buch erwähnt werden, sind gleichzeitig auch eingetragene Warenzeichen oder sollten als solche betrachtet werden. Umwelthinweis: Dieses Buch wurde auf chlorfrei gebleichtem Papier gedruckt. Die Einschrumpffolie – zum Schmutz vor Verschmutzung – ist aus umweltverträglichem und recyclingfähigem PE-Material.
10 9 8 7 6 5 4 3 2 1 03 02 01 00
ISBN 3-8272-5588-0
© 2000 by Markt+Technik Verlag, ein Imprint der Pearson Education Deutschland GmbH, Martin-Kollar-Straße 10–12, D 81829 München/Germany Alle Rechte vorbehalten Lektorat: Erik Franz,
[email protected] Herstellung: Claudia Bäurle,
[email protected] Satz: reemers publishing services gmbh, Krefeld Druck und Verarbeitung: Media Print, Paderborn Printed in Germany
Inhaltsverzeichnis Vorwort
15
Lesebuch und Nachschlagewerk Gut verwurzelt: traditionelles Basic vs. Visual Basic Zielgruppe
15 16 18
Teil I: Referenzteil
21
Grundlegendes
23
Programme und Module in Visual Basic Programm Modul Projekt Arten von Modulen in einem Projekt Literale und Konstanten Anweisungen Bezeichner und Namensraum Kontrollstrukturen Unbedingte und bedingte Verzweigung, Subroutinen Fallunterscheidung Schleifen Fehlerbehandlung
23 23 24 24 25 27 33 34 36 36 38 40 43
Datentypen und ihre Operationen
49
Elementare Datentypen Der Datentyp Variant Die Datentypen Integer, Long, Single und Double Die Datentypen Boolean und Byte Die Datentypen Currency und Date Der Datentyp Decimal Operatoren für elementare Datentypen und logische Bedingungen Arrays Typumwandlung Benutzerdefinierte Datentypen Type-Datentypen Enum-Aufzählungen Funktionen und Anweisungen für Zeichenfolgen Asc-, AscB- und AscW-Funktion Chr-, ChrB- und ChrW-Funktion Filter-Funktion Format-Funktion FormatCurrency-Funktion FormatDateTime-Funktion FormatNumber-Funktion
49 50 51 52 52 53 54 55 57 60 61 62 63 66 67 68 69 73 74 75
5
Inhaltsverzeichnis
FormatPercent-Funktion 75 Hex-Funktion 76 InStr- und InStrB-Funktion 76 InStrRev-Funktion 77 Join-Funktion 78 LCase-Funktion 79 Left- und LeftB-Funktion 79 Len- und LenB-Funktion 79 LSet-Anweisung 80 LTrim-Funktion 81 Mid- und MidB-Funktion 81 Mid- und MidB-Anweisung 82 MonthName-Funktion 82 Oct-Funktion 82 Option Compare-Anweisung 83 Replace-Funktion 84 Partion-Funktion 85 Right- und RightB-Funktion 85 RSet-Anweisung 86 RTrim-Funktion 86 Space-Funktion 86 Split-Funktion 87 Str-Funktion 87 StrComp-Funktion 88 StrConv-Funktion 89 String-Funktion 90 StrReverse-Funktion 90 Trim-Funktion 90 UCase-Funktion 91 Val-Funktion 91 WeekdayName-Funktion 92 Mathematische und finanzmathematische Funktionen und Anweisungen 92 Abs-Funktion 94 Atn-Funktion 95 Cos-Funktion 95 DDB-Funktion 96 Exp-Funktion 97 Fix-Funktion 97 FV-Funktion 98 Int-Funktion 99 IPmt-Funktion 99 IRR-Funktion 100 Log-Funktion 101 MIRR-Funktion 102 NPer-Funktion 103 NPV-Funktion 104
6
Inhaltsverzeichnis
Pmt-Funktion PPmt-Funktion PV-Funktion Randomize-Anweisung Rate-Funktion Rnd-Funktion und Rnd-Anweisung Round-Funktion Sgn-Funktion Sin-Funktion SLN-Funktion Sqr-Funktion SYD-Funktion Tan-Funktion Funktionen und Anweisungen für Datums-/Zeitwerte CDate-Funktion Date-Funktion und Date-Anweisung DateAdd-Funktion DateDiff-Funktion DatePart-Funktion DateSerial-Funktion DateValue-Funktion Day-Funktion FileDateTime-Funktion FormatDateTime-Funktion Hour-Funktion Minute-Funktion Month-Funktion MonthName-Funktion Now-Funktion Second-Funktion Time-Funktion und Time-Anweisung Timer-Funktion TimeSerial-Funktion TimeValue-Funktion Weekday-Funktion WeekdayName-Funktion Year-Funktion Dateiorientierte Funktionen und Anweisungen ChDir-Anweisung ChDrive-Anweisung Close-Anweisung CurDir-Funktion Dir-Funktion Environ-Funktion EOF-Funktion FileAttr-Funktion
105 106 106 107 108 109 110 110 112 112 113 113 114 114 116 116 116 117 118 119 120 121 121 121 121 121 122 122 122 122 123 124 124 125 125 126 126 126 131 132 133 134 135 136 137 138
7
Inhaltsverzeichnis
FileCopy-Anweisung FileDateTime-Funktion FileLen-Funktion FreeFile-Funktion Get-Anweisung GetAttr-Funktion Input- und InputB-Funktion Input #-Anweisung Kill-Anweisung Line Input #-Anweisung Loc-Funktion Lock-Anweisung LOF-Funktion LSet-Anweisung MkDir-Anweisung Name-Anweisung Open-Anweisung Print #-Anweisung Put-Anweisung Reset-Anweisung RmDir-Anweisung Seek-Anweisung und Seek-Funktion SetAttr-Anweisung Shell-Anweisung Unlock-Anweisung Write #-Anweisung
Variablen Variablendeklaration Typkennzeichen und Bezeichnerbereiche für Typen Variableninitialisierung Geltungsbereiche von Variablen
Funktionen und Prozeduren Parameterübergabe an Funktionen und Prozeduren Funktionen selbst definieren Prozeduren selbst definieren Routinen aus DLLs und der Windows-API einsetzen
Objekte und Klassen Klassen als Datentypen für Objektvariablen Ereignisroutinen Standardereignisse Activate-Ereignis und Deactivate-Ereignis Change-Ereignis Click-Ereignis DblClick-Ereignis
8
138 139 139 139 140 142 142 143 144 145 146 146 147 148 148 148 149 151 153 154 155 156 157 158 159 159
161 162 167 168 173
175 178 181 183 185
195 196 204 207 212 214 215 217
Inhaltsverzeichnis
DragDrop-Ereignis DragOver-Ereignis GotFocus-Ereignis und LostFocus-Ereignis Initialize-Ereignis KeyDown-Ereignis und KeyUp-Ereignis KeyPress-Ereignis LinkClose-Ereignis LinkError-Ereignis LinkExecute-Ereignis LinkNotify-Ereignis LinkOpen-Ereignis Load-Ereignis MouseDown-Ereignis und MouseUp-Ereignis MouseMove-Ereignis OLECompleteDrag-Ereignis OLEDragDrop-Ereignis OLEDragOver-Ereignis OLEGiveFeedback-Ereignis OLESetData-Ereignis OLEStartDrag-Ereignis Paint-Ereignis QueryUnload-Ereignis Resize-Ereignis Terminate-Ereignis Unload-Ereignis Validate-Ereignis Global-Objekt App-Objekt CallByName-Methode Clipboard-Objekt Command-Methode CreateObject-Methode DeleteSetting-Methode DoEvents-Methode Err-Objekt Forms-Auflistung GetAllSettings-Methode GetObject-Methode GetSetting-Methode InputBox-Methode Load-Methode LoadPicture-Methode LoadResData-Methode, LoadResPicture-Methode, LoadResString-Methode Printer-Objekt Printers-Auflistung
218 221 222 224 225 228 230 231 232 233 233 236 237 239 241 242 245 247 248 250 253 256 257 258 259 260 261 264 269 270 273 273 275 276 277 279 279 280 281 281 282 283 284 284 297
9
Inhaltsverzeichnis
QBColor-Methode RGB-Methode SavePicture-Methode SaveSetting-Methode Screen-Objekt Sendkeys-Methode Unload-Methode Auflistungen und Collection-Objekte Formulare Form-Objekt (Basisobjekt für Formulare) MDIForm-Objekt Selbst definierte Klassen ClassModul-Schnittstelle
Steuerelemente Gemeinsame Eigenschaften Alignment-Eigenschaft Appearance-Eigenschaft AutoSize-Eigenschaft BackColor-Eigenschaft und ForeColor-Eigenschaft BackStyle-Eigenschaft BorderStyle-Eigenschaft Caption-Eigenschaft Container-Eigenschaft CausesValidation-Eigenschaft DataChanged-Eigenschaft DataField-Eigenschaft DataFormat-Eigenschaft DataMember-Eigenschaft DataSource-Eigenschaft DisabledPicture-Eigenschaft DownPicture-Eigenschaft DragIcon-Eigenschaft DragMode-Eigenschaft DrawMode-Eigenschaft DrawStyle-Eigenschaft Enabled-Eigenschaft FillColor-Eigenschaft FillStyle-Eigenschaft Font-Eigenschaft ForeColor-Eigenschaft HasDC-Eigenschaft hDC-Eigenschaft Height-Eigenschaft und Width-Eigenschaft HelpContextID-Eigenschaft und WhatsThisHelpID-Eigenschaft hWnd-Eigenschaft Image-Eigenschaft
10
298 299 299 300 300 302 303 304 306 307 313 318 320
321 323 327 328 329 330 331 332 334 335 335 336 336 338 339 339 341 341 342 343 344 346 347 348 349 349 350 350 351 351 353 354 354
Inhaltsverzeichnis
Index-Eigenschaft Left-Eigenschaft und Top-Eigenschaft MaskColor-Eigenschaft MouseIcon-Eigenschaft MousePointer-Eigenschaft MultiLine-Eigenschaft Name-Eigenschaft OLEDropAllowed- und OLETypeAllowed-Eigenschaften OLEDropMode-Eigenschaft Parent-Eigenschaft Picture-Eigenschaft RightToLeft-Eigenschaft ScaleLeft-Eigenschaft und ScaleTop-Eigenschaft ScaleHeight-Eigenschaft und ScaleWidth-Eigenschaft ScaleMode-Eigenschaft ShowTips-Eigenschaft Style-Eigenschaft TabIndex-Eigenschaft TabStop-Eigenschaft Tag-Eigenschaft ToolTipText-Eigenschaft UseMaskColor-Eigenschaft Visible-Eigenschaft WhatsThisHelp-Eigenschaft WhatsThisHelpID-Eigenschaft Width-Eigenschaft Gemeinsame Methoden Drag-Methode LinkExecute-Methode LinkPoke-Methode LinkRequest-Methode LinkSend-Methode Move-Methode OLEDrag-Methode Refresh-Methode SetFocus-Methode ShowWhatsThis-Methode ZOrder-Methode Standardsteuerelemente Anzeige-Steuerelement (Image) Befehlsschaltfläche-Steuerelement (CommandButton) Bezeichnungsfeld-Steuerelement (Label) Bildfeld-Steuerelement (PictureBox) Bildlaufleisten-Steuerelemente (HScrollBar, VScrollBar) Dateilistenfeld-Steuerelement (FileListBox) Data-Datensteuerelement (Data)
356 357 358 359 360 361 361 362 363 364 365 366 366 368 369 371 372 375 376 376 377 377 378 378 378 379 379 379 380 381 382 382 383 383 384 385 386 386 387 390 392 393 395 398 400 402
11
Inhaltsverzeichnis
Figur-Steuerelement (Shape) Kombinationsfeld-Steuerelement (ComboBox) Kontrollkästchen-Steuerelement (CheckBox) Laufwerklistenfeld-Steuerelement (DriveListBox) Linie-Steuerelement (Line) Listenfeld-Steuerelement (ListBox) OLE-Container-Steuerelement (OLE) Optionsfeld-Steuerelement (OptionButton) Rahmen-Steuerelement (Frame) Textfeld-Steuerelement (TextBox) Verzeichnislistenfeld-Steuerelement (DirListBox) Zeitgeber-Steuerelement (Timer) ActiveX-Steuerelemente (OCX) – Windows-Standardsteuerelemente Abbildungsliste-Steuerelement (ImageList) Weitere ActiveX-Steuerelemente Bildausschnitt-Steuerelement (PictureClip) Standarddialoge-Steuerelement (CommonDialog)
Teil II: Praxisteil
451
Ältere Basic-Programme nach Visual Basic portieren
453
Wie importiert man den Quelltext? Einfache Programme Implementation einer eigenen Input-Routine Anspruchsvollere Programme Implementation von Inkey$ Implementation von LOCATE, POS, CSRLIN und COLOR Koordinatensystem und Grafikmodus Zusammenfassung der Emulation als Standardmodul Von WANKEL.BAS zur WankelAnimation Die portierte Fassung
454 454 456 457 459 460 461 463 468 472
Mathematik und Algorithmen ApfelmannZoom – eine Fahrt durch die Mandelbrotmenge Implementation des Apfelmännchen-Algorithmus Optimierung Ereignisbehandlung mit DoEvents, ein komplexes Problemfeld Benutzerschnittstelle Der Stack Einzelbilder speichern
Formulare und Ansichten Ereignisbehandlung Gummiband – Bereiche interaktiv auswählen DDE-Verbindungen OLE-Drag&Drop
12
406 407 409 410 411 412 415 424 426 427 431 432 433 436 439 442 444
477 478 484 485 485 487 488 489
491 491 492 495 501
Inhaltsverzeichnis
DiaProjektor – SDI-Formulare synchronisieren Das Programmdesign Info-Dialog als gebundenes Formular aufrufen Ereignisse delegieren und Instanziierung durch One-Shot-Logik Programmstart und Auswahl der Bilddateien im Standarddialog Öffnen Das Anzeigesystem Bilder einlesen und in maximaler Größe zeichnen Vollbildanzeige Menü und Kontextmenü Benutzerschnittstelle Bildlaufleisten für Ansichten einsetzen und auf Größenänderungen reagieren Bildlauf – ein kleiner Betrachter für große Bilder HexView – eine schnelle Textansicht für große Dateien Registrierung RegTest – Sitzungen wieder aufnehmen
Objektorientiertes Basic Klassen selbst definieren Ring – eine einfache Klasse demonstriert Grundlegendes 3DAnimation – Drahtgittermodelle frei im Raum gedreht Point3D – ein Punkt im Raum Line3D – eine Linie aus zwei Punkten ActiveX-Steuerelemente und Benutzersteuerelemente LongTimer – der Timer mit Ausdauer Transparenz und Drag&Drop MemoryEdit – das Textfeld mit Gedächtnis Kurzreferenz der Schlüsselwörter mit Vergleich zu QBasic
Tabellenindex
511 514 525 525 527 530 535 536 538 542 544 545 551 561 562
567 567 568 577 582 586 599 599 606 615 642
659
13
Vorwort Wer heute nicht täglich mit einem bestimmten Produkt, etwa einem Entwicklungssystem wie Visual Basic, einer Tabellenkalkulation oder einer Textverarbeitung arbeitet, sondern eher sporadisch, dem bleibt nichts anderes übrig, als erst einmal erhebliche Mengen an wertvoller Zeit schlicht damit zu vergeuden, sich und sein System immer wieder auf den neuesten Stand des jeweiligen Produkts zu bringen. Der Effizienzvorsprung, den der neueste Stand des Produkts verspricht, muss oft sehr teuer mit Lernaufwand und der Umgestaltung bestehender Lösungen erkauft werden. Die Hersteller wollen nicht nur, dass ein Produkt in der neuen Version äußerlich anders erscheint, die zusätzlichen Features sowie die Anpassung an eine sich ständig ändernde Umgebung (Benutzeroberfläche, Betriebssystem, Entwicklungsplattform, Vernetzung, verwandte Produkte) erzwingen in den meisten Fällen auch Änderungen des inneren Aufbaus, eingeführter Daten- und Kommunikationsstrukturen und nicht zuletzt auch erhebliche Änderungen in der Dokumentation. Damit wären wir bereits beim Thema.
Lesebuch und Nachschlagewerk Dieses Buch reiht sich mit seinem Titel in die 1999 neu ins Leben gerufene Referenzreihe des Markt+Technik-Verlags ein. Maßgeblich für das Erscheinen dieser neuen Reihe war der Wunsch vieler semi- wie professioneller Programmierer nach verdichteten Referenzinformationen mit ineinander greifender theoretischer und praktischer Aufarbeitung, mit anderen Worten, der schnelle und gleichzeitig kompetente Überblick über ein Sprachprodukt mit nichttrivialen praktischen Anregungen – als Nachschlagewerk für den Einstieg, Umstieg sowie die Auffrischung für die konkrete Arbeit mit dem Produkt. Die Titel in dieser Reihe geben Antwort auf die Fragen »Was ist das?« und »Wie geht das?« – und dies in einer für den Einzelnen noch überschaubaren Weise. Das Buch soll dem Käufer als Lesebuch und als Nachschlagewerk dienen, es soll ihm also das nötige Know-how für seine Programmiertätigkeit vermitteln und ihm gleichzeitig Anregungen und Lösungen anbieten, die er in seine Programmierarbeit einfließen lassen kann. Schaltstelle und Garant für die gute gegenseitige Durchdringung der Themen im Referenz- und Praxisteil ist der zentrale Tabellenindex im Anhang, dessen themen- und sachbezogene Einträge überwiegend in beiden Teilen Fundstellen ausweisen. Heutige Online-Hilfen zu Produkten können dies aus verschiedenen Gründen eher schlecht als recht bzw. immer häufiger gar nicht mehr leisten. So, weil sie sich über die Versionen hinweg immer weiter aufgeblasen haben, ohne strukturell überarbeitet worden zu sein, weil sie aufgrund schlechter und unvollständiger Aufarbeitungen teilweise bereits in sich widersprüchlich geworden sind, weil sie aufgrund erbärmlicher Indizes nur sehr zeitraubend zu handhaben sind und nicht zuletzt, weil sie in ihrem enzyklopädischen Charakter keinerlei Gewichtung der Informationen nach Kriterien der Brauchbarkeit und dem Wissensstand des Lesers mehr enthalten. Ein wirklich pathologisches Beispiel einer solchen Online-Hilfe ist die MSDN Library für Visual Studio 6.0. Der monumentale Fundus dieses in seinem Format inzwischen auf den Internet Explorer zugeschnittenen Hilfesystems ist auf zwei CDs verteilt und stellt einen Rundschlag an Informationen über die wichtigeren Sprachprodukte von Microsoft dar – darunter zu Visual Basic, Visual C++, Visual J++, Visual FoxPro sowie die SDK- und die DDK-Dokumentation. Die Benutzbarkeit des Systems lässt jedoch extrem zu wünschen übrig. Erstens wurden Text und Index teilweise eingedeutscht, was für den Index eine echte Katastrophe darstellt, teilweise im amerikanischen Original belassen, und zweitens wurde bei der indexikalischen Suche schlicht vergessen, die Produktzugehörigkeit der einzelnen Themen mit anzugeben. Die Volltextsuche leistet dies zwar, erschlägt einen aber schier mit der Fülle der Fundstellen. Wer dieser Hilfe in annehmbarer Zeit etwas halbwegs Vernünftiges über Visual Basic entlocken will, tut
15
Gut verwurzelt: traditionelles Basic vs. Visual Basic
Gut verwurzelt:
traditionelles
Bas ic
vs.
Visual Basic
gut daran, sich über das Menü ANSICHT/UNTERMENGE DEFINIEREN als Erstes eine Quellenauswahl in Form einer Untermenge zusammenzustellen und diese für die weitere Arbeit als Filter zu benutzen. Eine gedruckte Referenz zu Visual Basic im Umfang des vorliegenden Buches kann es sich nicht leisten, ausgiebigst auf allen Hochzeiten zu tanzen – das sei der Online-Hilfe vorbehalten. Vielmehr stellt sich die gedruckte Referenz der Aufgabe, die Ecken und Kanten abzuschleifen, die ein Verständnis der Sprache oder spezifische Problemlösungen erschweren, indem sie Zusammenhängendes als solches aufzeigt, begreiflich darstellt und in seinen relevanten Dimensionen exemplarisch erläutert. Entscheidend ist dabei die Auswahl und Verdichtung der behandelten Thematiken, die zwar nicht in jedem Fall, so doch aber in der Mehrzahl der Fälle eine Vertiefung der eher lax gehaltenen Online-Hilfe zu Visual Basic erreicht. Der vorliegende Band enthält eine umfassende Darstellung der Konzepte, Funktionen und Objekte von Visual Basic als Programmiersprache und Entwicklungsplattform, beschränkt sich aber in seiner Themenauswahl auf die »Innensicht der Sprache«, ohne sich allzu weit in der Welt des ActiveX, der Automatisierung, der Datenbankprogrammierung sowie generell des COM (bzw. DCOM) zu verlieren. Grob gesehen deckt der Band das gesamte Instrumentarium von Visual Basic inklusive aller Standardsteuerelemente sowie ausgewählter Windows-Standardsteuerelemente und die Programmierung eigener Benutzersteuerelemente ab.
Gut verwurzelt: traditionelles Basic vs. Visual Basic Keiner anderen Programmiersprache haftet so stark das Etikett an, in Hunderte verschiedener Dialekte zerfallen zu sein, wie Basic. Das liegt zum einen daran, dass Basic über lange Zeit hinweg, insbesondere für die ersten in ihren Möglichkeiten massiv beschränkten Mikrocomputer und später für den PC die mit dem Betriebssystem ausgelieferte Standardsprache darstellte – wenn es nicht gar, wie etwa für den Commodore C64 zur Kommandosprache für das Betriebssystem selbst avanciert war. Zum anderen liegt es aber auch daran, dass die Sprache in ihrer Entwicklung einer weniger rigiden Kontrolle durch Standardisierungskomitees und -gremien ausgesetzt war als die anderen – vielleicht wegen des Buchstabens »B« im Akronym, der ja bekanntlich für »Beginners« steht. Unterschwellig mag dabei freilich auch noch das Vorurteil mitgeschwungen haben, Basic werde aufgrund seiner Begrenztheit als Entwicklungssprache für ernst zu nehmende Anwendungen sowieso nie taugen. Ein großes Veränderungspotential geht aber auch mit einem großen Entwicklungspotential und der Fähigkeit zur schnellen Adaption einher. In der Tat haben im letzten Jahrzehnt die Philosophien für Benutzeroberflächen und Betriebssysteme einen massiven Wandel durchgemacht. Das gilt in besonders krasser Weise für den PC. Da ist es nicht verwunderlich, wenn sich auch die Anforderungen verlagert haben, denen eine Programmiersprache bei der Anwendungsentwicklung für moderne Benutzeroberflächen genügen muss. Eine wichtige Rolle spielen heute Objektorientierung, Modularisierung und Prozesskommunikation. Mit anderen Worten, das monolithische Programm, das isoliert von anderen Anwendungen den ihm zugedachten Aufgaben nachkommt, indem es seine eigenen Datenformate und Algorithmen strickt, seine eigene Benutzerschnittstelle parat hält und vielleicht noch so tut, als gehöre ihm die Maschine alleine, hat unwiderruflich ausgedient. Gefragt sind überschaubare, möglichst allgemein einsetzbare Komponenten, die im Dienste der Allgemeinheit das Ihre zum Großen Ganzen beitragen. Dieser neue Zeitgeist hört auf den Namen COM (Component Object Model), eine sprachübergreifende Spezifikation, die die Implementation und das Miteinander von Objekten in dieser Welt regelt. Microsoft hat seinen Beitrag an der technologischen Umsetzung dieser Konzeption (mit Blick auf die Internet-Programmierung) unter der Bezeichnung ActiveX zusammengefasst. Einer Anwendung, gleich in welcher Sprache sie realisiert wird, stehen damit vonseiten des Betriebssystems komplexe, allgemein gehaltene Bausteine in Form von Komponenten (Steuerelemente,
16
Gut verwurzelt:
traditionelles
Basic
vs.
Visual Basic
●
●
●
●
Module – der Modulbegriff deckt sich nicht mehr mit dem Programmbegriff, sondern erweitert die Strukturierungsfähigkeit der Sprache nach oben hin. Die Sprache vermag damit insbesondere Bibliotheken (Klassen- und Komponentenbibliotheken) konzeptuell zu integrieren Objekte – der Objektbegriff ist inzwischen sprachlich-syntaktisch verwurzelt. Neben den einfachen Datentypen stehen nun auch komplexe, verkapselte Datentypen samt zugehöriger Operationen zur Disposition. Der Sprache eröffnet sich damit unter anderem die vollständige Anbindung an alle Dienste des Betriebsystems inklusive der grafisch orientierten Benutzerschnittstelle, des gesamten Dateiwesens, der Kommunikationseinrichtungen und der Datenbankschnittstellen. Ereignisse – die Sprache adaptiert das Modell der ereignisgesteuerten Anwendungsprogrammierung von Windows über den Objektbegriff. So gestatten vordefinierte Klassen und interaktiv definierte Objekte dieser Klassen eine umfassende Repräsentation der Benutzerschnittstelle mit all ihren Elementen (Fenster, Menüs, Symbol- und Statusleisten, Steuerelemente, Komponenten) und Aktionen. ActiveX – die vom COM geforderte Codeabstraktion ermöglicht es der Sprache nicht nur, von existierenden Komponenten zu profitieren, sondern auch selbst Komponenten beizusteuern, von denen wiederum andere Anwendungen profitieren können.
Erst mit Integration dieser Konzepte besitzt Visual Basic das nötige Rüstzeug, um in der Welt der modernen Windows-Programmierung Schritt halten zu können. Das gilt mit gleichem Vorzeichen für den Programmierer: Wer auch nur halbwegs ernst zu nehmende Anwendungen mit Visual Basic zu Stande bringen will, dem bleibt nichts anderes übrig, als sein Basic-Repertoire (und sein Denken) auf den Stand dieser Neuerungen zu bringen. Dabei spielt in erster Linie der Objektbegriff eine zentrale Rolle. Wer den Objektbegriff einmal soweit verinnerlicht hat, dass er nicht mehr über die Nahtstelle zwischen dem »alten Basic« und dem »Basic mit Objekten« stolpert, dem wird auch die modulare Programmierung mit Code- und Klassenbibliotheken, ActiveX-Komponenten keine allzu großen Rätsel mehr aufgeben. Damit wären wir bereits bei der Zielgruppe dieses Buchs.
17
Gut verwurzelt: traditionelles Basic vs. Visual Basic
Schnittstellen, Player, Filter etc.) mit verkapselter Funktionalität und Implementation zur Verfügung, derer sie sich nach Belieben und ohne großes Brimborium bedienen kann. Angesichts dieser Entwicklungen scheint es etwa bei Betrachtung der Linie von BasicA über QuickBasic/QBasic nach Visual Basic beinahe schon verblüffend, wie treu sich die Sprache in ihren Wurzeln doch geblieben ist und wie viel sie von ihren ursprünglichen Konzepten in die neue Objekt-dominierte Welt retten konnte. Mehr noch, die Adaption ist so erstaunlich gut gelungen, dass sich der mit Visual Basic vorliegende Basic-Dialekt mit Fug und Recht inzwischen zu den ernst zu nehmenden Sprachen für die Anwendungsentwicklung zählen darf. Aber auch damit noch nicht genug. Microsoft hat Visual Basic vielmehr die Rolle des Flagschiffs zugedacht: In Form von VBA (Visual Basic für Anwendungen) stellt das neue Basic zudem die Automatisierungssprache für die wichtigsten Anwendungen der Microsoft Office Suite, und in der stark eingeschränkten Form von VBScript ist das neue Basic auch gleich noch zur neuen Kommandosprache des Betriebssystems Windows avanciert. Wer nun darauf beharrt, Visual Basic habe nicht mehr viel mit dem traditionellen Basic zu tun, dem kann natürlich genauso wenig widersprochen werden. Die objektorientierte Fassung von C ist C++ und von Pascal ist Modula oder Delphi, und keiner wird Letztere als Dialekte Ersterer bezeichnen wollen, obwohl die Kenntnis von C bzw. Pascal doch sehr beim Verständnis ihrer objektorientierten Nachfolger von Vorteil ist. Nehmen Sie es so: Basic war schon immer mehr ein Oberbegriff, denn ein kohärentes Gebilde, und als Oberbegriff ist es durchaus in der Lage, auch den Übergang in die objektorientierte Programmierung unter sich zu subsumieren. Die wesentlichen in Visual Basic zu findenden Neuerungen sind:
Zielgruppe
Zielgruppe Was das Vorwissen des Lesers betrifft, so wurde bei der Gestaltung der einzelnen Themen größter Wert auf eine Steigerung vom Einfachen zum Komplexen und vom Allgemeinen zum Speziellen gelegt. Der Eine liest so weit, wie er kommt, der Andere beginnt da zu lesen, wo es für ihn interessant wird. Damit ist, wie für eine Referenz üblich, die Zielgruppe dieses Buchs naturgemäß recht breit anzusetzen. Sie umfasst:
Zielgruppe
●
●
●
●
●
den unerfahrenen Programmierer, der die ersten Schritte und Hürden der Visual-BasicProgrammierung zwar hinter sich gebracht hat, aber weder den inneren Zusammenhang der Sprache so recht durchdrungen hat, noch eine Vorstellung von der Fülle ihrer Möglichkeiten bei der Bewältigung praktischer Problemfelder besitzt. Programmierer dieser Gruppe finden in diesem Buch nicht nur einen übersichtlichen Grundlagenteil, der auf die Elemente und Konzepte der Sprache genauer eingeht und gleichermaßen eine Vertiefung des Objektbegriffs vermittelt, sondern auch Anregungen für die eigene Programmiertätigkeit in Form einfacher Programmbeispiele, die Lösungen zu typischen Fragestellungen vorstellen. den Alten Hasen, der Basic seit langem kennt, die Sprache aber vernachlässigt hat und mit Visual Basic den schnellen Wiedereinstieg in die heutige objektorientierte Basic-Programmierung sucht. Programmierer dieser Gruppe werden in der Referenz nützliche Gegenüberstellungen und Anmerkungen finden, die gerade auf die Veränderung der Sprache im Vergleich zu QBasic abzielen. den ambitionierten Anwendungsentwickler, der sein Repertoire erweitern will, nach Ansätzen für neue Lösungen sucht und sich vom Griff zur Referenz nicht nur Auskunft, sondern auch Inspiration erwartet. Als Referenz bemüht sich das Buch, Licht in möglichst viele Winkel der Visual-Basic-Programmierung zu bringen. Programmierer dieser Gruppe werden daher in der Fülle der vorgestellten Programmiertechniken und Problemlösungen schnell Ansatzpunkte für die Lösung der eigenen Fragestellungen finden. den versierten Programmierer, der in vielen Programmiersprachen zu Hause ist und gezielte Hilfestellung in der einen oder anderen Fragestellung sucht. Die problemrelevante Auswahl der Einzelthemen und die Anwendungen unterschiedlicher Schwierigkeitsgrade und Komplexität umfassende Beispielsammlung dürfte das Buch für diesen Programmierertyp zu einer Fundgrube bei der Suche nach speziellen Lösungen werden lassen. den Entwickler spezifischer Datenbanklösungen, der Visual Basic unter anderem als Plattform für die Front-End-Programmierung benutzt
Auch wenn im Text vielfach nur »Visual Basic« zu lesen ist, ist der Inhalt des Buches vor dem Hintergrund der bei Drucklegung aktuellsten Version von Visual Basic zu interpretieren. Die in diesem Buch aufgeführten Thematiken und Beispiele wurden daher unter Visual Basic 6.0 (SP3) sowie der dazu von Microsoft bereitgestellten Dokumentation sorgfältig ausgearbeitet und auch getestet. Da Microsoft die Entwicklungszyklen seiner Produkte inzwischen scheinbar zunehmend auf Release-Versionen ausdehnt und eine weitgehende Fehlerfreiheit meist erst mit dem zweiten oder dritten Service-Pack erreicht wird, bietet diese Version eine hinreichend stabile Plattform für die Anwendungsentwicklung.
Die CD zum Buch Dem Buch ist eine CD beigelegt, auf der Sie die im Text explizit als Projekte bezeichneten Beispiele in je eigenen Unterverzeichnissen der Verzeichnisse Referenz und Praxis vorfinden. Zur einfacheren Orientierung tragen die Unterverzeichnisse die Namen der Projekte. Um die nicht
18
Zielgruppe
kompilierten Programme auszuführen, öffnen Sie die jeweilige VBP-Projektdatei oder VBG-Projektgruppendatei in der Visual-Basic-Entwicklungsumgebung und starten die Ausführung mittels der Taste (F5). Für Kommentare, Verbesserungen und Anregungen mit Bezug auf den Inhalt dieses Buchs bin ich jederzeit dankbar. Richten Sie Zuschriften bitte an:
[email protected]
München im August, 2000
Rudolf Huttary
Zielgruppe 19
Teil 1: Referenzteil
21
Grundlegendes Bei der prozeduralen Programmierung erfolgt die Strukturierung des Quellcodes traditionell durch Kontrollstrukturen, Funktionen/Prozeduren und Module. Während Kontrollstrukturen als Muss für jede Programmiersprache schon immer zum Kern von Basic zählten, hielten der Funktions- und Prozedurbegriff und das damit verbundene Konzept des Namensraums nur sehr zögerlich Einzug in die Sprache. Der Modulbegriff war als solcher zwar schon immer vorhanden, er implizierte bis zur Entwicklung von Visual Basic jedoch nicht mehr als die schiere Möglichkeit, von einem ersten Programm aus die Kontrolle zusammen mit gegebenenfalls speziell für den Export deklarierten Werten an ein zweites Programm abzugeben. Da das erste Programm dadurch beendet wurde und seine gesamte Umgebung verlorenging, war dieses Konzept als zusätzliche Strukturebene wenig geeignet. Brauchbare Adaptionen für Funktionen/Prozeduren gibt es seit QuickBasic und QBasic, wenngleich die etwas seltsam anmutenden Regeln für den Namensraum aus heutiger Sicht den Eindruck erwecken, als seien den Funktionen/Prozeduren Teile eines Modulkonzepts untergemischt worden. Erst die mit Visual Basic vollzogene Öffnung zur objektorientierten Programmierung brachte der Sprache ein ausgewogenes Verhältnis dieser drei Strukturebenen, wie es heute in allen modernen Programmiersprachen zu finden ist: Kontrollstrukturen sind (unverändert) bedingte Verzweigungen und Schleifen, die eine Steuerung der Programmausführung ermöglichen. Prozeduren/Funktionen fassen als Unterprogramme umfangreiche Anweisungsfolgen zu kompakten Einheiten zusammen, wobei Funktionen aufgrund des Funktionswerts, den sie verkörpern, noch der spezielle Aspekt der Auswertung komplexer Ausdrücke zufällt. Module haben Bibliothekscharakter und kombinieren Code und Datenstrukturen zu eigenständigen Programmeinheiten. Damit erfüllen sie die strukturelle Voraussetzung für die Implementation von Objektdatentypen (Klassen).
Programme und Module in Visual Basic Dieser Abschnitt diskutiert den Programm- und Modulbegriff von Visual Basic und stellt die verschiedenen Ausprägungen vor.
Programm Ein Programm ist eine Folge von Befehlen, die auf einem Computer ausführbar ist und im weitesten Sinne eine spezifische Anleitung für die spezifische Verarbeitung spezifischer Daten darstellt. Das hier etwas strapazierte Wort »spezifisch« soll deutlich machen, dass bei der Datenverarbeitung die Repräsentation eine enorme Rolle spielt und Programm nicht gleich Programm ist, selbst wenn es das Gleiche tut. Basic war ursprünglich als Interpretersprache konzipiert, was nichts anderes heißt, als dass zur Ausführung eines Basic-Programms ein Interpreter (also ein weiteres Programm) erforderlich war, das vergleichbar einem Dolmetscher die Basic-Befehle nacheinander in Maschinenbefehle übersetzte. Darüber hinaus musste der Interpreter während des Übersetzens auch noch darauf achten, dass der Programmtext keine Fehler syntaktischer oder sonstiger Natur enthielt. Das hatte zwar den Vorteil, dass die Programmentwicklung sehr einfach – weil vollständig interaktiv – vonstatten gehen konnte, aber auch den Nachteil, dass die Ausführungsgeschwindigkeit zu wünschen übrig ließ. Basic hatte daher immer schon den Ruf, »nicht gerade der schnellsten einer« zu sein. Im Gegensatz zu Basic sind andere Sprachen wie C oder Pascal von vornherein als Compilersprachen konzipiert, das heißt, Programmtexte werden einmalig (sowie nach jeder Änderung) von einem Compiler (Übersetzungsprogramm) auf syntaktische und sonstige Fehler hin untersucht und dann in eine ausführbare Version übersetzt, die aus nichts weiter als aus Maschinenbefehlen besteht und vom Prozessor direkt verarbeitet werden kann. (In der Praxis muss der vom Compiler gelieferte Code allerdings zur Auflö-
23
Programme und Module in Visual Basic
Programme und Module in Visual Basic
sung von Bibliotheksverweisen noch einem Bindevorgang unterzogen werden – dafür ist der so genannte Linker zuständig). Der Geschwindigkeitsvorteil liegt dabei natürlich auf der Hand. Visual Basic vereint heute die Vorteile einer Interpretersprache mit der einer Compilersprache. Für die interaktive Programmentwicklung stellt die Entwicklungsumgebung von Visual Basic einen Interpreter (genau genommen handelt es sich dabei um einen inkrementellen Compiler) mit integriertem Debugger bereit, und zur Fertigstellung einen Compiler, der direkt ausführbaren Code erzeugen kann. Dieser Code ist allerdings noch auf eine oder mehrere zu Visual Basic gehörende Laufzeitbibliotheken angewiesen, die in Form von DLLs bereitstehen. Neben der Übersetzung in Maschinencode bietet Visual Basic auch die Übersetzung in den so genannten PCode an, ein im Schnitt etwa um 40 Prozent kompakterer und syntaktisch fehlerfreier Zwischencode. In P-Code vorliegende Programme besitzen einen kleinen ca. 9 KB umfassenden Maschinencode-Anteil, den so genannten P-Code-Interpreter, der ein primitives Laufzeitsystem darstellt und den P-Code (mit weitaus geringeren Geschwindigkeitsverlusten als ein Basic-Interpreter) in Maschinencode entfaltet.
Modul Ein Blick auf die Entwicklung von Basic zeigt weiterhin, dass sich die Sprache von einer schwach strukturierenden Sprache, deren einzige Strukturelemente Kontrollstrukturen und (inzwischen völlig verpönte) Subroutinen bildeten, zu einer stark strukturierenden Sprache gemausert hat, die sich dem Vorwurf, sie würde Spagetti-Code fördern, nicht mehr gefallen lassen muss. So baut sich die Funktionseinheit Programm heute nicht mehr als schlichte Folge von Anweisungen, Verzweigungen und Sprüngen auf, sondern als Sammelsurium sich gegenseitig in streng hierarchischer Organisation aufrufender Funktionen und Prozeduren, also in sich abgeschlossener und gekapselter Untereinheiten mit eng begrenzten und überschaubaren Funktionalitäten. Damit aber nicht genug. Um als Programmiersprache in einer zunehmend objektorientiert gestalteten Systemumgebung noch mitmischen zu können, muss auch die Möglichkeit einer Strukturierung »nach oben hin« gegeben sein. Dies bringt den Begriff des Moduls ins Spiel. Ein Modul vereinigt im Wesentlichen das unter sich, was traditionell als Basic-Programm begriffen wurde: einen als Datei vorliegenden Programmtext, der vom Basic-Laufzeitsystem als eigenständige Programmeinheit behandelt wird. Charakteristikum des Moduls ist, dass es einen eigenen Namensraum darstellt, mithin also Variablen bereitstellen kann, die global in allen Prozeduren des Moduls bekannt sind (Deklaration mit Dim oder Private). Darüber hinaus ist auch ein Export globaler Variablen und Prozeduren an andere Module (Deklaration mit Public) möglich. Auf diese Weise lässt sich in Visual Basic die Gesamtfunktionalität eines Programms als Ansammlung kleinerer »Programme« bzw. Module mit definierten Schnittstellen begreifen. Das einzelne Modul kann im Zusammenspiel mit anderen Modulen einem höheren Zwecke dienen, aber auch für sich genommen ein vollständiges Programm sein. Mit Blick auf die Objektorientierung hat das Modul in Visual Basic eine noch weitere sehr wichtige Funktion: Es kann als eigenständiger komplexer Datentyp (Klasse) auftreten und stellt dafür die Implementation. Eine ausführliche Diskussion dieses Aspekts finden Sie im Teil »Objekte und Klassen« (S. 195).
Projekt Der Visual-Basic-Programmierer legt für jedes neue Programm ein Projekt an, welches als organisatorischer Rahmen für die verschiedenen Module seines Programms fungiert. Damit das Programm für sich lauffähig ist, muss eines (und nur eines) dieser Module ein Startobjekt bereitstellen, das unter PROJEKTEIGENSCHAFTEN auf der Seite ALLGEMEIN anzugeben ist. Der Name »Objekt« ist hier ein wenig unglücklich gewählt, weil nicht nur Objekte mit eigenständiger Nachrichtenbehandlung (wie Formulare), sondern auch eine Prozedur mit dem speziellen Bezeichner Main zur Auswahl stehen. Ist für ein Projekt kein Startobjekt definiert, kann der resultierende Code nur als Bibliothek für andere Programme oder Bibliotheken fungieren. (Eine
24
Arten von Modulen in einem Projekt
Bibliothek kann allerdings gleichfalls ein Startobjekt benötigen, wenn noch vor dem Aufruf der ersten Bibliotheksroutine gegebenenfalls notwendige Initialisierungen durchzuführen sind.) So ergibt sich, dass in Visual Basic geschriebene Programme aus unterschiedlichen Teilen zusammengesetzt sind, die jeweils unterschiedliche Gestalten haben bzw. annehmen können: ●
Arten von Modulen in einem Projekt Visual Basic unterscheidet mehrere Arten von Modulen. Um einem bestehenden Projekt ein weiteres Modul hinzuzufügen, finden sich im Menü PROJEKT der Entwicklungsumgebung entsprechende Einträge. Mit Ausnahme von Standardmodulen des Typs Modul sowie allgemeinen Klassenmodulen setzt sich ein Modul aus einer Codekomponente und einer Objektkomponente (lies: sichtbare Repräsentation) zusammen. Die Bearbeitung der Codekomponente erfolgt im ASCII-Editor und die Bearbeitung der Objektkomponente im Designerfenster der integrierten Entwicklungsumgebung Visual Studio. Standardmäßiges Modul für die Programmierung kleiner Anwendungen mit Ein- und Ausgabefunktionalität ist das Formular. Sein Charakteristikum ist, dass seine Funktionalität im Wesentlichen auf ein einzelnes Fenster ausgerichtet ist, das ihm als Eingabe- und Ausgabemedium dient. Nachdem ein Formularmodul zur Laufzeit durch ein Formularobjekt mit eigenständiger Nachrichtenbehandlung repräsentiert wird, kann jedes Formularmodul formal zum Startobjekt erklärt werden. (Natürlich muss dann auch das Design sowie die Logik des Formulars auf diese Eigenschaft zugeschnitten sein.) Somit kann ein aus einem einzelnen Formularmodul bestehendes Projekt bereits als vollständiges, interaktives Visual-Basic-Programm auftreten. Sie erhalten ein solches Minimalprojekt (mit geeignet definiertem Startobjekt), wenn Sie ein Projekt des Typs »Standard-EXE« anlegen. Mit dieser Konstellation kommt das Formularmodul dem traditionellen Basic-Programm am weitesten entgegen, auch wenn die Programmiertechniken für die Ein- und Ausgabe unter Windows doch erheblich anders aussehen als vergleichsweise noch unter DOS. Eine Anleitung, wie ältere, noch mit QBasic geschriebene Basic-Programme unter Visual Basic zum Laufen gebracht werden, findet sich zu Anfang des Praxisteils. Eine andere, gleichfalls auf die Arbeit mit Fenstern ausgerichtete Modulart ist das MDI-Formular. Es unterscheidet sich vom gewöhnlichen Formularmodul darin, dass es das Rüstzeug für die Programmierung mit einem Hauptfenster und beliebig vielen weiteren, ersterem untergeordneten Fenstern sozusagen bereits mitbringt. MDI-Formularmodule kommen dementsprechend dann zum Einsatz, wenn es um die Darstellung und Verwaltung mehrerer Dokumente (Formularmodule) »unter einem gemeinsamen Dach« (MDI-Formularmodul) geht. Weitere Informationen hierzu im Abschnitt »Selbst definierte Klassen« auf Seite 318. Die schlichte Bezeichnung Modul für die dritte Modulart verrät bereits, dass es sich hierbei um ein unspezifisches Standardmodul handelt. Ein solches Modul kann beispielsweise die Logik für die Koordination weiterer Module enthalten oder schlicht als Bibliothek für von allen Modulen eines Projekts gemeinsam genutzte Funktionen, Prozeduren, Variablen, Typen und Konstanten fungieren.
25
Programme und Module in Visual Basic
●
Quelltext oder Interpretercode – liegt im ASCII-Format vor und kann die Dateierweiterungen .frm (Formular und MDI-Formular), .bas (Programmmodul), .ctl (ActiveXSteuerelement) oder .cls (Klassenmodul, ActiveX-Komponente) haben. Zur Ausführung des Quelltextes im Visual-Basic-Interpreter sind darüber hinaus je Quelltext eine Projektdatei (.vbp) und bei Gruppierung mehrerer Projekte zu einem Ganzen eine Gruppierungsdatei (.vbg) vonnöten. Compilercode – liegt als ausführbarer Maschinencode oder P-Code vor und kann die Dateierweiterungen .exe (Ausführbare Datei oder prozessexterne ActiveX-Komponente), .dll (dynamische Bibliothek oder prozessinterne ActiveX-Komponente) oder .ocx (ActiveX-Steuerelement) tragen.
Programme und Module in Visual Basic
Programme und Module in Visual Basic
Geheimnisvoller ist die Bezeichnung Klasse für die vierte Modulart. Sie ist dafür gedacht, die neu mit Visual Basic hinzugekommene Seite der objektorientierten Programmierung aktiv zu bedienen, sprich, eigene Objekte zu implementieren. Sieht man ein Objekt als Kombination aus einem benutzerdefinierten Datentyp und den zugehörigen Operationen über diesem Datentyp an, wird die Rolle des Klassenmoduls schnell deutlich. Es beherbergt die Beschreibung des Objektdatentyps hinsichtlich seiner Repräsentation und seiner Methoden (lies: Funktionen und Prozeduren). Weitere Informationen hierzu im Abschnitt »Selbst definierte Klassen« auf Seite 318. Die Modulart Benutzersteuerelement ist dem Bereich der ActiveX-Programmierung zuzurechnen. Sie erlaubt die Bereitstellung eigener Steuerelemente im OCX-Format, deren Funktionalität im (allerdings recht reichhaltigen) Angebot der unter Windows allgemein verfügbaren Steuerelemente nicht enthalten ist. Anders als ein Formular ist ein Benutzersteuerelement im Allgemeinen nicht dazu da, ein komplettes Fenster darzustellen, sondern – wie der Name schon sagt – nur ein Steuerelement, das sich auf einem Formular platzieren lässt. Aus diesem Grund besitzt ein Benutzersteuerelement für gewöhnlich weder Menüleisten, Symbolleisten und andere Dinge, die bei Formularen anzutreffen sind, noch ein feste Größe. Vergleichbar mit den Standardsteuerelementen, werden die sichtbaren Abmessungen eines Benutzersteuerelements erst bei Platzierung des fertigen Steuerelements im Verlauf des Formularentwurfs oder programmgesteuert festgelegt. Das Benutzersteuerelementmodul enthält die gesamte Logik eines Benutzersteuerelements sowie die Schnittstellendefinition für den Datenaustausch (Eigenschaften). Wie das Formular Minimalbestandteil des Projekttyps »Standard-EXE« ist, so ist das Benutzersteuerelement Minimalbestandteil des Projekttyps »ActiveX-Steuerelement«. Auch die Modulart Eigenschaftsseite fällt in den Bereich der ActiveX-Programmierung. ActiveX-Steuerelemente haben oft komplexe Eigenschaften (so etwa zusammengesetzte Datentypen oder Objekte), deren Darstellung im standardmäßigen Fenster Eigenschaften der Entwicklungsoberfläche nicht mehr erfolgen kann. Für diesen Fall besteht die Möglichkeit, eine oder mehrere Eigenschaftsseiten für die Eingabe der Eigenschaften bereitzustellen. Da ein ActiveX-Steuerelement, das beim Entwurf eines Formulars, eines anderen Steuerelements oder einer anderen Komponente in den Entwurfbereich gezogen wird, standardmäßig (als Entwurfsinstanz) zur Ausführung kommt, steht insbesondere auch der hinter einer Eigenschaftsseite steckende Code zur Verfügung. Eine Eigenschaftsseite lässt sich wie ein Formular unter Verwendung von Steuerelementen im Designerfenster der Entwicklungsumgebung zusammenstellen und im Code-Editor mit der entsprechenden Logik für den Datenaustausch mit einem ActiveX-Steuerelement, aber auch mit mehreren ActiveX-Steuerelementen (bei Mehrfachauswahl von ActiveXSteuerelementen im Designerfenster, denen die gleiche Eigenschaftsseite zugeordnet ist) versehen. Die letzte Modulart, Designer, ist mehr oder weniger ein Sammelbecken für die verschiedensten Objekte. Visual Basic hält für jedes dieser Objekte ein Designer-Werkzeug bereit, das ähnlich dem Formulardesigner die interaktive visuelle Gestaltung der Objektkomponente ermöglicht. Wie beim Formular wird in der Codekomponente eines solchen Objekts seine spezifische Reaktion auf bestimmte Ereignisse festgelegt. Unter den Werkzeugen finden sich der DHTML-Designer für den Entwurf und die Programmierung dynamischer HTML-Seiten, der Data-ReportDesigner für den Entwurf und die Programmierung von Datenberichten, der Data-Environment-Designer für die interaktive Gestaltung und das Management der Datenumgebung für Datenbankverbindungen mit programmgesteuerten Datenzugriffen sowie der WebClass-Designer für die Bereitstellung von Active Server Pages (.asp-Dateien) im Zusammenhang mit verteilten Anwendungen im Internet oder Intranet und dem Internet Information Server. Tipp
................................................... Tipp
Module sind ein sehr geeignetes Mittel für die Strukturierung von Programmcode hinsichtlich seiner Wiederverwendbarkeit. Die Vielfalt der unter Visual Basic vorhandenen Modularten för-
26
Literale und Konstanten
dert zwar bereits von sich aus die modulare Programmierung, ersetzt aber verständlicherweise nicht die bewusste Aufteilung des Codes in spezifische und allgemein verwendbare Programmtexte. Wer sich beizeiten vernünftige Bibliotheken anlegt, kann später um so mehr davon profitieren. Beispiele
................................................... Beis piele
' Projekt: Modultest ' vollständiger Code von Module1 Sub Main() ' Main ist Startobjekt des Projekts Dim f As New Form1 f.Caption = "Erster Aufruf" ' Lädt Formular Form1 in Hauptspeicher f.Show 1 ' Zeigt Formular an und wartet, bis dieses endet f.Caption = "Zweiter Aufruf" f.Show 1 ' Zeigt Formular an und wartet, bis dieses endet End Sub ' vollständiger Code von Form1 ' Formular enthält Schaltfläche "Beenden" Private Sub Beenden_Click() Unload Me End Sub
Das in den folgenden beiden Abbildungen gezeigte Projekt EuroDMTestprojekt besteht aus zwei Modulen, einem einfachen Formularmodul und einem Benutzersteuerelementmodul. Das Programm testet ein Benutzersteuerelement namens EuroDM, welches die Ein- und Ausgabe von Geldbeträgen wahlweise in DM oder Euro gestattet. Der Einfachheit halber wurde auf eine Rundung und eine Korrektur der Punkt-/Komma-Problematik verzichtet. Das aus zwei Textund zwei Bezeichnungsfeldern bestehende Benutzersteuerelement rechnet Eingaben in der einen Währung automatisch in die andere um und erlaubt die Definition und Abfrage seiner beiden Textfelder über die Eigenschaften Euro und DM. Da die Textfelder eine gegenseitige Wertänderung im Rahmen ihrer Change-Behandlung vornehmen, sind ein wenig Logik und die globale Zustandsvariable Changing nötig, um eine Endlosschleife zu verhindern.
Literale und Konstanten [Public | Private] Const ConstName [As Typ] = Literal [Public | Private] Const ConstName [As Typ] = LiteralerAusdruck
27
Literale und Konstanten
Das einfache Projekt Modultest besteht aus zwei Modulen, einem gewöhnlichen Modul Module1 und einem Formularmodul Form1. Module1 enthält eine Startprozedur namens Main, die im Dialog PROJEKTEIGENSCHAFTEN als Startobjekt spezifiziert ist. Form1 enthält dagegen nichts weiter als eine Schaltfläche Beenden zum Beenden des Formulars. In diesem Programm ruft Main als Startobjekt Form1 zweimal hintereinander als gebundenes Formular auf und passt dazu den Fenstertitel entsprechend an. Wählt man Form1 als Startobjekt, erfolgt nur ein Aufruf des Formulars, während das Modul Module1 gar nicht erst zur Ausführung kommt:
Literale und Konstanten
Literale und Konstanten
Testprojekt für das Benutzersteuerelement EuroDM im Entwurfsmodus
Das Benutzersteuerelement EuroDM im Einsatz Beschreibung
................................................... Bes c hreibung
Die elementarste Unterscheidung bei der Datenverarbeitung, an der selbst einfachste Taschenrechner nicht vorbeikommen, ist die zwischen Daten und Befehlen. Als Datum bezeichnet man die Repräsentation eines Werts in einem spezifischen Datenformat (Datentyp). Ein Datum kann als Literal, als Konstante oder als Variable vorliegen. Im Falle des Literals steht der Wert für sich selbst, etwa wie 42 für die Zahl Zweiundvierzig oder »Rudolf« für den Vornamen des Autors dieses Buches. Im Falle der Konstanten hat man es genau genommen gleichfalls mit einem Literal zu tun, da der Interpreter bzw. Compiler jedes Vorkommen einer Konstanten im Quelltext automatisch durch ihren literalen Wert ersetzt. Variablen sind dagegen auf ein bestimmtes Datenformat (Datentyp) zugeschnittene Behälter, die einen Bezeichner (lies: einen Namen) tragen und einen (in dem bestimmten Datenformat gehaltenen) Wert enthalten. Während sich der Wert eines Literals oder einer Konstanten im Programmverlauf nicht ändern kann, weil – wenn man so will – Bezeichner und Wert identisch sind, kann eine Variable (im
28
Literale und Konstanten
Anwendung
................................................... Anwendung
Ein Literal kann überall dort stehen, wo ein Wert erforderlich ist – so bei Zuweisungen als Rechtswert (lies: rechts von Gleichheitszeichen), in Ausdrücken als Operand, bei Funktionsund Prozeduraufrufen als Argument für einen Parameter. Für die Notation literaler Größen gibt es feste Regeln, die sich auch von Datentyp zu Datentyp unterscheiden können. So sind Zeichenfolgenliterale in doppelte Anführungszeichen einzuschließen, und damit es zu keiner Verwechslung zwischen dem doppelten Anführungszeichen als Zeichen und dem Zeichenfolgenende kommt, muss das Anführungszeichen doppelt notiert werden, wenn es als Zeichen auftritt. strMyName = "Rudolf Huttary" Position$ = "Das Schiff liegt 2° 3' und 42"" Ost"
Zahlenliterale können Sie in dezimaler Schreibweise, wie gewohnt: Const cMaxSize = 255
in hexadezimaler Schreibweise durch Voranstellen von &H: Const cMaxSize = &HFF
' dezimaler Wert 255
oder in oktaler Schreibweise durch Voranstellen von &O notieren: Const cMaxSize = &O377
' dezimaler Wert 255
Die dezimale Notation von Zahlenliteralen mit Nachkommastellen erfolgt mit Dezimalpunkt. (Achtung: In Zeichenfolgen, die später implizit oder mittels einer Funktion wie Val umgewandelt werden, gelten jedoch die Ländereinstellungen, so dass hier auf einem deutschen System ein Komma zu notieren ist.) Etwaige Zehnerpotenzen sind, durch ein »E« abgetrennt, an die Dezimaldarstellung anzuhängen. Positive Vorzeichen können Sie weglassen; negative Vorzeichen stellen Sie jeweils dem Wert voran, für den sie gelten. Const delta = -2.14E-27
' Minus 2 Komma 14 mal 10 hoch Minus 27
29
Literale und Konstanten
Rahmen ihres Datenformats) unter Beibehaltung ihres Namens jederzeit ihren Wert ändern. Anders gesagt: Ein Literal ist ein Wert, eine Konstante steht für einen Wert und eine Variable enthält einen Wert. Ein Befehl ist eine allgemeine Vorschrift für die Manipulation von Daten im weitesten Sinne und wird in Visual Basic häufig mit der so genannten Anweisung gleichgesetzt (vgl. »Anweisungen«, S. 33). So ist beispielsweise die Zuweisung eines Werts an eine Variable, die so genannte Zuweisungsoperation mit »=« ebenso ein Befehl wie die Ausgabe einer Grafik mit automatischer Größenanpassung in ein Bildfeld, das auf einem Formular gelegen ist. Als Operationen bezeichnet man dagegen eine besondere Art von Befehlen, bei der ein Operator (lies: Rechenvorschrift) auf einen oder mehrere Operanden (lies: Werte einer bestimmten Art) angewendet wird und einen neuen Wert (gleicher Art) produziert – so etwa die Bildung der Summe zweier Zahlen, die Verkettung von Zeichenfolgen, die Restwertdivision (Modulo-Rechnung) oder, wie gesagt, die Zuweisung eines Werts an eine Variable. Ist ein Wert so notiert, dass er erst durch Anwendung von Operatoren auf Operanden berechnet werden muss, spricht man von einem Ausdruck. Sind die Operanden als Literale notiert, spricht man genauer von einem literalen Ausdruck.
Literale und Konstanten
Der standardmäßige Datentyp von Zahlenliteralen ist Integer bzw. – bei vorhandenen Nachkommastellen – Single. Um einen anderen Datentyp zu erzwingen, können Sie dem literalen Wert ein Typkennzeichen anhängen.
Literale und Konstanten
Const cAlpha = 100& Const cBeta = 100! Const cGamma = 100#
' cAlpha ist vom Typ Long ' cBeta ist vom Typ Single ' cGamma ist vom Typ Double
Nicht ganz so eingängig sind die Regeln für die Notation von Datumsliteralen. Werte dieses Typs repräsentiert Visual Basic als 64-Bit-Gleitkommazahlen (8 Bytes) nach IEEE und kann somit Datumsangaben im Bereich zwischen dem 1. Januar 100 und dem 31. Dezember 9999 sowie Uhrzeiten im Bereich von 0:00:00 bis 23:59:59 unterscheiden. Datumsliterale können Datumsangaben und Zeitangaben kombinieren, aber auch je einzeln ausdrücken. Der Notation literaler Datums- und Zeitangaben liegt das amerikanische Format zugrunde, das heißt, in Datumsangaben wird der Monat vor dem Tag notiert und die Abtrennung erfolgt durch das Zeichen »/«, und Zeitangaben sind in 12-Stunden-Darstellung gefolgt von »PM« oder »AM« zu treffen. Zudem ist die Darstellung durch ein führendes und abschließendes Zeichen »#« einzuschließen. (Der Editor erkennt übrigens auch andere Darstellungen, so etwa #1 Feb 99#, und korrigiert diese beflissen in das erwünschte Format.) Dim a = b = c =
a As Date, b As Date, c As Date #2/1/1996 1:12:01 PM# #12:01:00 PM# #2/1/1996#
Konstanten lassen sich – wie Literale – überall dort einsetzen, wo ein Wert erforderlich ist. Gegenüber Literalen bieten sie den Vorteil, dass der Wert, für den sie stehen, an zentraler Stelle definiert und fortan formal durch Angabe des Konstantenbezeichners notiert werden kann. Die Definition einer Konstanten erfolgt zur Entwurfszeit im Rahmen einer Const-Anweisung durch Zuweisung eines Literals oder eines literalen Ausdrucks an einen Konstantenbezeichner. Bei der Wahl des Konstantenbezeichners gelten die üblichen Vorschriften für die Bezeichnerwahl (vgl. »Bezeichner und Namensraum«, S. 34). Es ist legitim, bei der Definition von Konstanten, andere, bereits definierte Konstanten als Rechtswerte oder als Operanden in Ausdrücken zu verwenden. Const MinSize = 8 Const MaxSize = MinSize + 2741
' MinSize steht für den Wert 8 ' MaxSize steht für den Wert 2749
................................................... Warnung
Warnung
Wer denkt, dass die Konstantendeklarationen Const a = 65535
und Const b = &HFFFF
identisch sind, der irrt. a steht für die Zahl 65535 (wie notiert), b jedoch für -1. Das liegt daran, dass Visual Basic a implizit den Datentyp Long und b den Datentyp Integer zuordnet und der Wert -1 aufgrund der Repräsentation negativer Zahlen durch Zweierkomplementbildung die hexadezimale Darstellung &HFFFF hat. Damit beide Konstanten den gleichen Wert erhalten, ist die hexadezimale Darstellung so zu notieren: Const b = &H0FFFF
30
Literale und Konstanten
In Basic existiert nur formal ein Unterschied zwischen der bitweisen Operation und der logischen Operation, da die Repräsentation logischer Werte genau so gewählt ist, dass eine bitweise Operation die jeweilige logische Operation hervorbringt. Const a = Not 2
' a steht für -3 (Zweierkomplement)
und s% = -3 And 42 Or 1 ' s% erhält den Wert 41
Tipps
................................................... Tipps Vermeiden Sie im Programmtext nach Möglichkeit die Verwendung von Literalen und arbeiten Sie mit Konstanten, die Sie jeweils zu Anfang des Moduls im Bereich ALLGEMEIN (seltener: zu Anfang einer Prozedur) definieren. Auf diese Weise können Sie den Wert eines Literals an zentraler Stelle mit globaler Wirkung für den gesamten Programmtext ändern. Const cMaxSize = 255 ... For x = 0 to cMaxSize
Um für Konstanten einen bestimmten Typ zu erzwingen, erklären Sie diesen entweder durch die Angabe eines Typkennzeichens oder durch eine explizite Typdeklaration. Const cMaxSize As Integer = 255
Bildet ein literaler Wert die Grundlage für einen weiteren literalen Wert, so empfiehlt es sich, den zweiten Wert als Ausdruck zu schreiben, der auf den ersten aufbaut, oder anstelle des zweiten Literals eine Variable einzusetzen und deren Wert rechnerisch aus dem ersten Literal zu ermitteln. Const cMinSize = 100 ' Const cMaxSize = 199 Const cMaxSize = 2 * cMinSize – 1 Const cVerschlüsseltesKennWort = "2XVf5uhf" ' Const KennwortLänge = 8 ... Dim KennwortLänge As Integer KennwortLänge = Len(cVerschlüsseltesKennwort)
' falsch ' richtig
' falsch
' richtig
Visual Basic besitzt eine sehr reichhaltige Fülle an vordefinierten Konstanten (auch Objektkonstanten), deren Einsatz nicht nur ein Garant für Kompatibilität ist, sondern auch (gerade im Zusammenhang mit Objektkonstanten) zu Laufzeitverbesserungen führt. Einen Überblick über diese Konstanten gibt der Objektkatalog (aufzurufen über ANSICHT/OBJEKTKATALOG oder (F2)). Beispiel
................................................... Beis piel
Das folgende vollständige Programm Apfelmann, eine stark vereinfachte Version des mehrfach in diesem Buch diskutierten Apfelmännchens, demonstriert den Umgang mit literalen Werten. Da das Programm während der Berechnung keine Aktualisierung der Anzeige vornimmt, erscheint das Bild erst nach Abschluss aller Berechnungen – es sei denn, man fügt einen ShowAufruf in die Load-Routine ein und setzt die AutoRedraw-Eigenschaft des Formulars auf False.
31
Literale und Konstanten
Die von Visual Basic verwendete interne Repräsentation für Datumswerte kann mit folgender Kapriole aufwarten: Der 30. Dezember 1899 ist nicht darstellbar. Visual Basic interpretiert diesen Tag vielmehr als reine Zeitangabe #12:00:00 AM#.
Literale und Konstanten
Literale und Konstanten
' Bereich Allgemein Const cx1 As Double = -2.1 Const cy1 As Double = -1.2 Const cx2 As Double = 0.7 Const cy2 As Double = 1.2 Const cFenster_x = 4000 Const cFenster_y = 3600 Const cMaxIterat As Integer = 200 Const cGrenze As Double = 100
' Bildausschnitt des Apfelmännchens
' Fensterabmessungen nicht zu groß ' sonst dauert es zu lange
Private Sub Apfel(m_x1, m_x2, m_y1, m_y2, step_x, step_y) Dim r1 As Double, re As Double, im As Double Dim zr As Double, zi As Double, it As Integer For zr = m_x1 To m_x2 Step step_x ' alle Spalten in x-Richtung For zi = m_y1 To m_y2 Step step_y ' alle Punkte in Spalte zr re = 0 ' Realteil initialisieren im = 0 ' Imaginärteil initialisieren For it = 0 To cMaxIterat ' Iteration für Punkt r1 = re * re – im * im + zr im = 2 * re * im + zi re = r1 If re < -cGrenze Or re > cGrenze Or _ im < -cGrenze Or im > cGrenze Then PSet (zr, zi), it * 16 ' Punkt ausgeben Exit For End If Next it Next zi Next zr End Sub Private Sub Form_Load() Dim step_x As Double, step_y As Double Width = cFenster_x ' Fensterabmessungen anpassen Height = cFenster_y ' AutoRedraw = False ' Show ScaleMode = vbPixels ' Ab jetzt Bildpunkte als Einheit step_x = (cx2 – cx1) / ScaleWidth ' Breite eines Bildpunkts step_y = (cy2 – cy1) / ScaleHeight ' Höhe eines Bildpunkts Scale (cx1, cy1)-(cx2, cy2) ' Koordinatensystem vorgeben Apfel cx1, cx2, cy1, cy2, step_x, step_y ' Apfelmännchen berechnen End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
Dim, Public, Private, ReDim Verwandte Themen
................................................... Verwandte Them en
Datentypen und ihre Operationen (S. 49); Operatoren für elementare Datentypen und logische Bedingungen (S. 54); Anweisungen (S. 33); Bezeichner und Namensraum (S. 34)
32
Anweisungen
Anweisungen _ (Operator für Übertrag in nächste Zeile) : (Operator für Aneinanderreihung von Anweisungen) [Let] Var = Wert Rem Kommentar ' Kommentar
Beschreibung
................................................... Bes c hreibung
Der Quelltext eines Visual-Basic-Moduls setzt sich aus einer Folge von Anweisungen zusammen. Unter einer Anweisung versteht man in Visual Basic alles, was einen Befehl darstellt, ohne selbst einen Wert zu verkörpern. Man unterscheidet zwischen einfachen Anweisungen, die in einer einzelnen Zeile stehen können, und Kontrollstrukturen, die als zusammengesetzte Anweisungen ihrerseits Anweisungsfolgen strukturieren und auf höherer Ebene zu einer logischen Einheit zusammenfassen. Eine besondere Anweisungsform stellen Compileranweisungen dar, denen das Zeichen # vorangeht (#If Then...#Else...#End If). Sie werden nicht erst zur Laufzeit, sondern bereits zur Übersetzungszeit interpretiert und führen dazu, dass bestimmte Teile des Codes gar nicht erst übersetzt werden. Ausdrücke in solchen Anweisungen dürfen nur aus Literalen und Konstanten zusammengesetzt sein. Visual Basic definiert in diesem Zusammenhang die Boolean-Konstanten Win16 und Win32, deren (jeweils gegensätzlicher) Wahrheitswert ausdrückt, ob die Übersetzung auf einer 16-Bit- oder 32-Bit-Plattform erfolgt. Anwendung
................................................... Anwendung
Zu den einfachen Anweisungen zählen Zuweisungsoperationen (Let, Set, LSet, RSet Mid), Prozeduren (vordefinierte und benutzerdefinierte), Deklarationen (Const, Dim, Private, Public, Declare) und Definitionen (Function, Sub) aller Art. Alles, was Visual Basic als einfache Anweisungen betrachtet, kann als eigenständige Programmzeile stehen. Überlange einfache Anweisungen lassen sich mittels des Übertragsoperators _ (Unterstrich) in zwei oder mehrere Zeilen aufteilen. Dabei muss der Übertragsoperator durch ein Leerzeichen getrennt als letztes Zeichen in der Zeile notiert sein – und darf insbesondere keine Zeichenfolgenliterale trennen. Mehrere Anweisungen lassen sich in eine Zeile stellen, wenn zwischen den Anweisungen der Aneinanderreihungsoperator : (Doppelpunkt) notiert ist. Eine Kontrollstruktur ist eine zusammengesetzte Anweisung, die sich über mehrere Zeilen hinweg erstrecken kann und eine Rahmung untergeordneter Anweisungsfolgen mittels Schlüsselwörtern vorsieht, entsprechend den die Kontrollstruktur geltenden syntaktischen Regeln. Im Falle der If-Anweisung akzeptiert Visual Basic sowohl die kompakte Zeilenform als auch eine mehrzeilige Form. Rem-Anweisungen sind nur aus formaler Sicht Anweisungen. Eigentlich stellen sie Kommentare dar, da sie der Compiler bei der Übersetzung ebenso ignoriert wie Kommentare, die durch ein Hochkomma ' eingeleitet sind.
33
Anweisungen
#If Ausdruck Then Anweisungsfolge1 [#Else | ElseIf AusdruckN AnweisungsfolgeN #End If
Bezeichner und Namensraum
Bezeichner und Namensraum Bezeichner, Namensraum, Schlüsselwörter Private, Public, Dim Beschreibung
Bezeichner und Namensraum
................................................... Bes c hreibung
Bezeichner fungieren in Visual Basic als formale Namen für verschiedenen Größen: Konstanten, Variablen und Objekte, Funktionen und Prozeduren (Methoden) sowie Module. Bei der Wahl eines Bezeichners für eine bestimmte Größe genießt der Programmierer weitestgehende Freiheiten. Er muss lediglich die formalen Regeln zur Bezeichnerbildung einhalten und auf Eindeutigkeit im jeweiligen Namensraum achten. Zudem verbietet sich die Verwendung der von Visual Basic reservierten Schlüsselwörter, die von der Sprache selbst mit einer festen Bedeutung belegt sind. Die formalen Regeln für die Bezeichnerbildung in Visual Basic sind: ● ●
●
●
Bezeichner dürfen zwischen ein und 255 Zeichen lang sein Bezeichner müssen mit einem Buchstaben beginnen, wobei auch deutsche Umlaute und Sonderzeichen (genau genommen sogar alle ANSI-Zeichen mit einem Code zwischen 128 und 255) erlaubt sind. Für alle weiteren Zeichen sind darüber hinaus auch die Ziffern »0« bis »9« und der Unterstrich »_« erlaubt. Visual Basic unterscheidet in der Notation von Bezeichnern nicht zwischen Groß- und Kleinschreibung. MyVar und Myvar bezeichnen somit dasselbe. (Der Editor der integrierten Entwicklungsumgebung setzt allerdings auf Modulebene eine konsistente Schreibweise durch, indem er jeweils die bei der Deklaration eines Bezeichners verwendete Schreibweise erzwingt und bei implizit deklarierten Bezeichnern jeweils die zuletzt verwendete Schreibweise für alle Vorkommen des Bezeichners übernimmt.)
Als Namensraum eines Bezeichners wird der Bereich bezeichnet, innerhalb dessen ein Bezeichner bekannt ist. Der größte Namensraum ist der so genannte globale Namensraum oder die Programmebene. Bezeichner, die diesem Namensraum angehören, sind in allen Modulen eines Programms bekannt und somit global ansprechbar. Jeweils kleinere Namensräume sind die Modulebene und Prozedurebene. Bezeichner, deren Namensraum auf die Modulebene beschränkt ist, sind nur innerhalb des Moduls bekannt, in dem sie deklariert wurden, und Bezeichner, deren Namensraum auf die Prozedurebene beschränkt ist, sind nur innerhalb der Prozedur (bzw. Funktion) bekannt, in dem sie deklariert wurden. Bei Bezeichnerkonflikten, die durch die Wahl gleicher Bezeichner für unterschiedliche Größen in überlappenden Namensräumen unterschiedlicher Stufe entstehen, ist im kleineren Namensraum immer nur der in diesem Namensraum deklarierte Bezeichner sichtbar. Anwendung
................................................... Anwendung
Während Modulbezeichner von vornherein dem globalen Namensraum angehören, müssen Prozeduren, Funktionen und Methoden explizit mit dem Zusatz Public deklariert werden, damit ihr Bezeichner im globalen Namensraum sichtbar wird. Geschieht die Deklaration dagegen mit dem Zusatz Private oder ohne Zusatz, ist ihr Bezeichner jeweils immer nur innerhalb des Moduls bekannt, das den Quelltext enthält. Die vielfältigsten Möglichkeiten für die Gestaltung des Namensraums bieten Konstanten, Variablen und Objekte. Bei impliziter oder expliziter Deklaration in einem Prozedur- oder Funktionskörper erstreckt sich der Namensraum des Bezeichners ab Deklaration bis zum Endes des Körpers. Findet die Deklaration dagegen auf Modulebene (im Bereich ALLGEMEIN) ohne Zusatz oder unter Angabe von Dim oder Private statt, ist der Bezeichner fortan im restlichen Teil des Modulkörpers bekannt und insbesondere
34
Bezeichner und Namensraum
auch in allen Funktionen und Prozeduren (bzw. Methoden) sichtbar. Während sich der Namensraum einer Konstanten grundsätzlich nicht über mehrere Module erstrecken kann, sondern maximal auf die Modulebene beschränkt bleibt, unterliegen Variablen und Objekte dieser Einschränkung nicht. Damit eine Variable oder ein Objekt im globalen Namensraum bekannt wird, muss eine Public-Deklaration auf Modulebene erfolgen. Warnung
................................................... Wa rnung
Dim x As Single, y As Single ... Sub BerechneMatrix(a(), b()) ... For x = 1 To 100 For y = 1 To 200 ... Next x, y End Sub
Die Variablen x und y werden hier leichtfertig und im Vertrauen auf die implizite Deklaration als Zählvariablen eingesetzt. Eine solche findet aber nicht statt, da unter diesen Bezeichnern globale Variablen bekannt sind. Diese verlieren durch die Schleifen leider ihren Wert, was an völlig anderer Stelle seltsame Nebeneffekte hervorbringen kann. Deshalb immer fleißig deklarieren und auf globaler Ebene keine nichtssagenden 08/15-Bezeichner vergeben. Tipp
................................................... Tipp
Wer die Wahl hat, hat die Qual. Dieser Spruch bewahrheitet sich insbesondere, wenn es darum geht, sich immer wieder neue Bezeichner auszudenken. Eine gute Hilfe ist es, sich dabei von formalen Kriterien leiten zu lassen und bei der Auswahl darauf zu achten, dass ein Bezeichner möglichst viel über die Größe aussagt, für die er steht. Um Konstanten, Variablen und Prozeduren besser auseinander halten zu können, folgen viele Programmierer daher bei der Bildung von Bezeichnern bestimmten Konventionen. So hat es sich beispielsweise bewährt, Konstanten immer in Großschreibung zu notieren, Variablen mit einem Kleinbuchstaben beginnen zu lassen und Prozeduren mit einem Großbuchstaben. Sehr verbreitet ist zudem die so genannte ungarische Notation, die durch Bezeichnerpräfixe den zu einem Bezeichner gehörigen Datentyp zum Ausdruck bringt. Variablen vom Typ Integer würden mit einem »i« beginnen, Variablen vom Typ String mit einem »s« oder »str« usw. Der restliche Teil des Bezeichners kann dann noch in gemischter Groß- und Kleinschreibung notiert werden, um seine Funktion mnemonisch besser zum Ausdruck zu bringen. (Diese Schreibweise wird inzwischen der früher weit verbreiteten Zusammensetzung mit Unterstrichen »_« vorgezogen.) Bei sehr enger Verwandtschaft zweier Größen leistet oft auch die Abzählung durch Anhängen von Ziffern als Suffix gute Dienste.
35
Bezeichner und Namensraum
Visual Basic betrachtet es nicht als Fehler, wenn Sie ein und denselben Bezeichner in verschiedenen Namensräumen vergeben. Solange die Namensräume nichts miteinander zu tun haben, wird dies keine allzu große Verwirrung stiften, ja, vielfach sogar Vorteile bringen. Problematisch wird es allerdings, wenn ein Namensraum den anderen umfasst, wie etwa die Modulebene eine Prozedurebene. In diesem Fall wird die auf Modulebene deklarierte Variable in der Prozedurebene unsichtbar, weil ihr Bezeichner durch die lokal in der Prozedur deklarierte Variable »verdeckt« ist. Dies ist meist zu verschmerzen, oft sogar auch gewollt. Fehlerträchtig wird es allerdings, wenn der Programmierer auf eine implizite Deklaration auf Prozedurebene setzt und unwissentlich oder fahrlässig den Bezeichner einer global deklarierten Variable erwischt. So führt beispielsweise der folgende Code zu unangenehmen Nebeneffekten:
Kontrollstrukturen
Beispiel
................................................... Beis piel
Kontrollstrukturen
' Unterscheidung der Notation durch Klein und Großschreibung Const MAXSIZE = 10 ' Konstanten in Großschreibung Private anzahl As Integer ' Variable in Kleinschreibung Private ergebnis As Single, werte(MAXSIZE) As Single Function StandardAbweichung(a() As Single) As Single ' Ungarische Notation Const cMaxSize = 10 ' Präfix "c" für Konstante Private iElemAnzahl As Integer ' Präfix "i" für Integer Private bChanging As Boolean ' Präfix "b" für Boolean Private frmAnmeldung As Form1 ' Präfix "frm" für Formular Private sErgebnis1 As Single ' Präfix "s" für Single, Abzählung Private sErgebnis2 As Single ' Präfix "s" für Single, Abzählung Function sStandardAbweichung(a() As Single) As Single Verwandte Befehle
................................................... Verwa ndte Befehle
DefType Verwandte Themen
................................................... Verwandte Them en
Datentypen und ihre Operationen (S. 49); Typkennzeichen und Bezeichnerbereiche für Typen (S. 167); Geltungsbereiche von Variablen (S. 173)
Kontrollstrukturen Aufgabe einer Kontrollstruktur ist die Steuerung der Programmausführung in Abweichung von der im Quelltext notierten Anweisungsfolge.
Unbedingte und bedingte Verzweigung, Subroutinen GoTo {Marke | Zeile} ... Marke: GoSub SubRoutine ... SubRoutine: ... Return If Bedingung Then Anweisung [Else Anweisung] If Bedingung Then [ThenAnweisungsBlock] [ElseIf Bedingung1 [ElseIfAnweisungsBlock]] ... [Else [ElseAnweisungsBlock]] End If
36
Unbedingte und bedingte Verzweigung,
Subroutinen
Beschreibung
................................................... Bes c hreibung
Anwendung
................................................... Anwendung
Der unbedingte Sprung mit GoTo, aber auch die GoSub-Unterprogramme, zählen zu den Erblasten von Basic, denen die Sprache in ihrer Anfangszeit das Attribut »Spagetti-Code« zu verdanken hatte. In der modernen, strukturierten Programmierung findet in seltenen Fällen nur noch die GoTo-Anweisung Anwendung, nämlich im Zusammenhang mit der Fehlerbehandlung, wo der Befehl im Zusammenspiel mit On Error gezielte Sprünge zu Fehlerbehandlungsroutinen ermöglicht. Anstelle von GoSub-Unterprogrammen benutzt man heute ausschließlich benutzerdefinierte Funktionen und Prozeduren. Anders die If-Anweisung. Sie hat an Wichtigkeit im Laufe der Zeit nichts eingebüßt. In der mehrzeiligen Form eignet sie sich bei Verwendung von ElseIf-Zweigen für umfangreichere Fallunterscheidungen, auch wenn die Select-Anweisung hier oft die bessere Wahl darstellt. IfAnweisungen können natürlich auch vollständig verschachtelt werden, von der Laufzeit her sind ElseIf-Formulierungen jedoch überlegen. Warnung
................................................... Wa rnung
Aufrufe parameterloser Prozeduren und schlichte Sprungmarken kann Visual Basic von der Notation her nicht unterscheiden, wenn der Doppelpunkt-Operator zur Anreihung mehrerer Anweisungen in einer Programmzeile ins Spiel kommt. Visual Basic zieht in diesem Fall die Interpretation »Sprungmarke« der anderen vor. Setzen Sie parameterlose Prozeduraufrufe daher besser in eigene Zeilen (ohne nachfolgenden Doppelpunkt) oder benutzen Sie die CallAnweisung für den Aufruf. Beispiel
................................................... Beis piel
Die folgenden Zeilen zeigen, wie die Logik für die Berechnung der Sgn-Funktion aussieht:
37
Kontrollstrukturen
Die einfachste (inzwischen aber verpönte) Möglichkeit, die Kontrolle einem anderen Programmteil weiterzugeben, ist der unbedingte Sprung mittels GoTo zu einer Sprungmarke oder Zeilennummer. Die Anweisung GoSub ermöglicht den Aufruf eines Unterprogramms (auch verschachtelt), das an der Sprungmarke oder Zeilennummer SubRoutine beginnt und bis zur nächsten Return-Anweisung (auf gleicher Ebene) reicht. Sprungmarken und Zeilennummern müssen jeweils innerhalb der gleichen Funktion/Prozedur liegen und am Zeilenanfang stehen. Eine Sprungmarke ist ein beliebiger Bezeichner gefolgt von einem Doppelpunkt. Die wichtigste Kontrollstruktur zur Steuerung des Programmablaufs ist die bedingte Verzweigung in Form der If-Anweisung, für die zwei unterschiedliche Notationen zulässig sind. In der kürzeren Schreibweise (Zeilenform) muss die Anweisung – gegebenenfalls samt Else-Teil – in einer Zeile und ohne abschließendes End If notiert sein. In der mehrzeiligen Schreibweise ist dagegen das abschließende End If unerlässlich. Die Syntax erlaubt in dieser Form zudem ElseIf-Fallunterscheidungen. Die If-Anweisung führt den im Then-Zweig gelegenen ThenAnweisungsblock aus, wenn die – meist als logischer Ausdruck formulierte – Bedingung Bedingung einen Wert ungleich 0 ergibt. Ist der Wert 0, kommt der ElseAnweisungsblock des Else-Zweiges zur Ausführung. Der Else-Zweig kann durch Einfügung von ElseIf-Zweigen weiter aufgespreizt sein, wobei ein ElseIf-Zweig nichts anderes als die optimierte Form einer verschachtelten If-Anweisung im Else-Zweig ist. Ergibt sich für die Bedingung eines ElseIf-Zweiges ein Wert ungleich 0, kommt der ElseIfAnweisungsblock zur Ausführung. Bei vorhandenen ElseIfZweigen kommt ein ElseAnweisungsblock nur zur Ausführung, wenn alle bis dahin geprüften Bedingungen den Wert 0 ergeben haben.
Kontrollstrukturen
If a > 0 Then a = 1 ElseIf a < 0 Then a = -1 End If ' für den Fall a = 0 hat a bereits den richtigen Wert! Verwandte Befehle
................................................... Verwa ndte Befehle
On Error, Select, On ... GoSub
Kontrollstrukturen
Verwandte Themen
................................................... Verwandte Them en
Operatoren für elementare Datentypen und logische Bedingungen (S. 54); Fallunterscheidung (S. 38); Fehlerbehandlung (S. 43)
Fallunterscheidung Select Case TestAusdruck [Case Fall1 [AnweisungsBlock1]] ... [Case FallN [AnweisungsBlockN]] [Case Else [ElseAnweisungsBlock]] End Select Function Switch(Ausdruck1, Wert1,[Ausdruck2, Wert2[, ...]]) As Variant Function Choose(Index As Integer, Wert1[, Wert2[,... WertN]]) As Variant On Ausdruck GoSub SprungzielListe On Ausdruck GoTo Sprungzielliste Function IIf(Kriterium As Boolean, ThenWert, ElseWert) As Variant Beschreibung
................................................... Bes c hreibung
Die Select Case-Kontrollstruktur führt eine Fallunterscheidung auf Basis des Werts von TestAusdruck durch. Für jeden zu unterscheidenden Fall ist ein Case-Zweig mit der Anweisungsfolge AnweisungsblockN zuständig. Der Case-Ausdruck Fall kann als Konstante/Literal, Is-Vergleich (offener Bereich), To-Bereich (geschlossener Bereich) oder als Fall-Aufzählung formuliert sein: Fall Fall Fall Fall
= = = =
Zahl | Zeichenfolge Is VglOperator VglWert Fall1 To FallN Fall1, ..., FallN
In einer Select-Struktur kommt maximal ein, bei vorhandenem Else-Zweig genau ein Zweig zur Ausführung. Die Switch-Funktion führt eine Fallunterscheidung auf Basis ihrer in Paaren zu je einem Ausdruck und einem potentiellen Funktionswert organisierten Parameterliste durch. Den Funktionswert WertN eines solchen Paares gibt die Funktion zurück, wenn der Ausdruck AusdruckN von links beginnend der erste Ausdruck ist, der einen von 0 verschiedenen Wert hat, also den Wahrheitswert True besitzt. Falls keiner der Ausdrücke ungleich 0 ist, liefert die Funktion den Wert Null.
38
Fallunterscheidung
Anwendung
................................................... Anwendung
Obwohl sich Fallunterscheidungen prinzipiell gesehen genauso gut über If-Anweisungen (verschachtelt oder mit ElseIf-Zweigen) formulieren lassen, sind Select Case-Formulierungen im Allgemeinen eleganter und übersichtlicher – vor allem, wenn viele Fälle zu unterscheiden sind. Die Syntax für die Formulierung der einzelnen Fälle ist reichhaltig. Der Compiler nimmt allerdings keine Überprüfung auf Überlappung vor, so dass auf eine disjunkte Formulierung der Fall-Ausdrücke geachtet werden sollte. In einfachen Fällen, wenn sich die Fallunterscheidung (wie bei Arrays) auf die indexorientierte Auswahl eines Werts aus einer Werteliste zurückführen lässt, sollte die Choose-Funktion das Mittel der Wahl sein. Dieselbe Funktionalität lässt sich allerdings mittels der Array-Funktion erzielen, wie das Beispiel am Ende des Abschnitts zeigt. Für Fallunterscheidungen, die auf die Auswahl eines Werts in Abhängigkeit verschiedener Bedingungen hinauslaufen, ist die Switch-Funktion meist das eleganteste Mittel. Die Anwendung der Funktion widerspricht aber in gewisser Hinsicht der Intuition, da es grundsätzlich zur Auswertung aller Ausdrücke kommt. In der Praxis hat das zwei Auswirkungen: Erstens muss jeder Ausdruck für jeden Fall wohldefiniert sein (kein Überlauf, keine Division durch 0 etc.), sonst kommt es zu einem Laufzeitfehler, und zweitens hat die Funktion unabhängig vom unterschiedenen Fall immer die gleichen Seiteneffekte. Von einem Gebrauch der On-Anweisung (jenseits von On Error) ist abzuraten, weil GoTo-Sprünge und GoSub-Unterprogramme angesichts der reichhaltigen Ausstattung von Visual Basic für die strukturierte Programmierung nicht mehr zeitgemäß sind. Diese Befehle werden nur noch für die Abwärtskompatibilität unterstützt. Warnung
................................................... Wa rnung
Da in Select-Strukturen immer nur ein Case-Zweig zur Ausführung kommt, ist im Falle der Überlappung von Case-Ausdrücken die Reihenfolge der Case-Aufzählung relevant. Visual Basic wertet bei Abarbeitung der Switch-Funktion immer alle Ausdrücke aus, so dass eventuelle Seiteneffekte vom Funktionswert unabhängig bleiben. Beispiel
................................................... Beis piel
Der folgende Code zeigt die eine Select-Fallunterscheidung für den von einem Textfeld gemeldeten Tastaturcode: Private Sub Text1_KeyUp(KeyCode As Integer, Shift As Integer) Select Case KeyCode Case vbKeyDelete, vbKeyBack ' wg. Überschreibmodus Case vbKeyUp, vbKeyDown ' Nächste Zeile in Textfeld AktualisiereZeile(sZeile) ' Änderungen zurückschreiben
39
Kontrollstrukturen
Die Choose-Funktion liefert den an der Position Index in der Werteliste stehenden Wert – der Wert 1 wählt Wert1, der Wert 2 wählt Wert2 usw. Die On-Kontrollstruktur ermöglicht eine Fallunterscheidung durch Auswahl eines Sprungziels aus der Liste SprungzielListe in Abhängigkeit von Ausdruck. Der Wert von Ausdruck darf zwischen 0 und 255 liegen. Ist er 0 oder größer als die Anzahl der Sprungziele in der Liste, findet kein Sprung bzw. Unterprogrammaufruf statt, ansonsten benennt er die Listenposition des anzusteuernden Sprungziels. Als Sprungziele können wahlweise Zeilennummern oder Sprungmarken genannt sein, die in der gleichen Funktion/Prozedur definiert sind. Eine Fallunterscheidung der besonderen Art stellt die Funktion IIf dar. Sie wird mit drei Parametern aufgerufen und liefert in Abhängigkeit vom Wahrheitswert des ersten Parameters den zweiten Parameter (erster Parameter ist True) oder dritten Parameter (erster Parameter ist False) als Funktionsergebnis.
Kontrollstrukturen
Kontrollstrukturen
Case vbKeyEscape List1_Click ' Ursprüngliche Fassung holen Case vbKeyEnd Start = LineLen – 1 Case vbKeyLeft Start = LinePos – 1 Case vbKeyRight Start = LinePos + 1 Case vbKeyHome Start = 0 Case Else ' Sonstige Tasten VerarbeiteTaste(KeyCode, sZeile) End Select Text1.SelStart = Start ' Position in Puffer aktualisieren Text1.SelLength = 1 ' Überschreibmodus End Sub
Hier verschiedene Formulierungen für die Zuordnung eines numerischen Werts zu einer Zeichenfolge: sZahl = Choose(a + 1, "Null", "Eins", "Zwei", "Drei", "Vier", "Fünf") sZahl = Switch(a = 0, "Null", a = 1, "Eins", a = 2, "Zwei", a = 3, _ "Drei", a = 4, "Vier", a = 5, "Fünf") sZahl = Array("Null", "Eins", "Zwei", "Drei", "Vier", "Fünf")(a)
IIf macht die Min-/Max-Berechnung leicht: Min = IIF(a < b, a, b) Max = IIF(a > b, a, b) Verwandte Befehle
................................................... Verwa ndte Befehle
If, GoTo, GoSub Verwandte Themen
................................................... Verwandte Them en
Unbedingte und bedingte Verzweigung, Subroutinen (S. 36)
Schleifen For CountVar = StartVal To EndVal [Step StepVal] [Anweisungsfolge] [Exit For] [Anweisungsfolge] Next [CountVar[, CountVar1]] For Each IteratVar In Liste [Anweisungsfolge] [Exit For] [Anweisungsfolge] Next [IteratVar[, IteratVar1 ...]] While Bedingung [Anweisungsfolge] [Exit While]
40
Schleifen
[Anweisungsfolge] Wend Do [{While | Until} Bedingung] [Anweisungsfolge] [Exit Do] [Anweisungsfolge] Loop
Beschreibung
................................................... Bes c hreibung
Schleifen sind Kontrollstrukturen, die es gestatten, einen Anweisungsblock oder Schleifenkörper in Abhängigkeit eines Kriteriums – einer logischen Bedingung oder dem Wert einer Zählvariablen – mehrmals zu durchlaufen. Das klassische Programmiermodell unterscheidet zwischen abweisenden Schleifen, die das Schleifenkriterium im Schleifenkopf vor dem ersten Durchlaufen des Schleifenkörpers prüfen (und selbst die einmalige Ausführung des Schleifenkörpers unterbinden können), und nicht abweisenden Schleifen, die ihr Kriterium nach Abarbeitung des Schleifenkörpers prüfen. Visual Basic weicht diese Unterscheidung allerdings auf, indem es sprachliche Mittel für den Schleifenabbruch an beliebiger Stelle vorsieht. Darüber hinaus lässt sich zwischen Schleifen unterscheiden, bei denen eine Berechnung der benötigten Schleifendurchläufe noch vor dem ersten Eintritt in die Schleife möglich ist (Zählschleifen), und solchen, bei denen diese Berechnung nicht möglich ist (Schleifen mit implizitem Abbruchkriterium). Schleifen, deren Kriterium sich nie erfüllt, heißen Endlosschleifen. Falls der Schleifenkörper einer Schleife eine weitere Schleife enthält, spricht man von verschachtelten Schleifen. Anwendung
................................................... Anwendung
Der Einsatzbereich von Schleifen ist derartig breit, dass es wohl nur wenige auch nur halbwegs anspruchsvolle Programme geben wird, die ohne dieses Mittel auskommen. Abweisende Schleifen werden in Visual Basic als For-, While- oder Do-Schleifen und nicht abweisende Schleifen ausschließlich als Do-Schleifen formuliert. Als Zählschleife ist die starre Form der For-Schleife am besten geeignet. Schleifen lassen sich beliebig verschachteln, solange gewährleistet ist, dass eine äußere Schleife den Schleifenkörper einer inneren Schleife jeweils vollständig enthält.
Die For...Next- Schleife Eine For-Schleife kann in einer von zwei Formen benutzt werden. In der ersten Form verlangt sie die Bekanntgabe einer Zählvariablen (CountVar) eines beliebigen numerischen Typs, eines Startwerts (StarVal), eines Endwerts (EndVal) und gegebenenfalls einer Schrittweite, wenn diese von der standardmäßigen Schrittweite 1 abweicht. Der Ablauf ist: 1. Beim ersten Eintritt der Programmausführung in den Schleifenkopf initialisiert die ForSchleife die Zählvariable mit dem Startwert. 2. Unmittelbar vor jedem Durchlaufen des Schleifenkörpers prüft die Schleife, ob die Zählvariable den Endwert bereits überschritten hat. Falls ja, endet die Schleife, und die Ausführung überspringt den Schleifenkörper. 3. Nach jedem Durchlaufen des Schleifenkörpers erfolgt automatisch die Aktualisierung der Zählvariablen unter Beachtung der geltenden Schrittweite.
41
Kontrollstrukturen
Do [Anweisungsfolge] [Exit Do] [Anweisungsfolge] Loop [{While | Until} Bedingung]
Kontrollstrukturen
Kontrollstrukturen
Beachten Sie, dass Sie zwar den Wert der Zählvariablen jederzeit ändern und somit das Verhalten der Schleife von innerhalb des Schleifenkörpers manipulieren können, nicht jedoch den geltenden Endwert oder die Schrittweite. Von einer solchen Manipulation ist aber generell eher abzuraten, da der Code dann nicht mehr übersichtlich ist. Um eine For-Schleife verfrüht abzubrechen, bedienen Sie sich besser des Befehls Exit For. Als Datentyp für die Zählvariable kommen ganzzahlige Typen wie Integer oder Long in Betracht, ebenso aber auch Fließkommatypen wie Single oder Double. Das beste Laufzeitverhalten hat eine Schleife, wenn die Zählvariable vom Typ Long ist. Um eine Schleife zum Rückwärtszählen zu bewegen, geben Sie StepVal mit einer negativen Schrittweite an sowie einen Endwert, der kleiner als der Startwert ist. Dim i As Long For i = 10 to 2 Step -2 Print i, i+1 Next i
In Form der For Each-Schleife ermöglicht die For-Schleife das Durchlaufen aller Elemente einer Auflistung Liste. An die Stelle der Zählvariable tritt die Aufzählvariable IterateVar, die bei jedem Schleifendurchlauf den Wert des jeweils nächsten Elements von Liste annimmt, bis das Ende der Auflistung erreicht ist. Eine Modifikation der Aufzählvariable innerhalb des Schleifenkörpers hat keine Auswirkung auf die Aufzählung. Einzig der vorzeitige Abbruch mittels Exit For ist möglich. Als Voraussetzungen für die Anwendung dieser Form sind zu beachten: Liste muss eine Auflistung (Collection-Objekt) oder ein Array sein, und IterateVar muss den Datentyp Variant oder einen Objektdatentyp tragen. Dim a(20) As Integer Dim i As Variant For Each i In a i = 2 Next i
' Array elementweise initialisieren
Die Nennung der Zähl- bzw. Aufzählvariablen nach dem Schlüsselwort Next ist optional. Als Abschluss verschachtelter For-Schleifen ist auch die Nennung mehrerer Zähl- bzw. Aufzählvariablen nach dem Schlüsselwort Next zulässig.
Die While...Wend- Schleife Als Standardlösung für abweisende Schleifen bietet sich die While-Schleife an. Schleifen dieser Art prüfen unmittelbar vor jedem Eintritt in den Schleifenkörper, ob das Kriterium Bedingung einen Wert ungleich 0 hat. Falls dem so ist, bricht die Schleife ab und die Ausführung überspringt den Schleifenkörper. While-Schleifen lassen sich jederzeit auch von innerhalb des Schleifenkörpers mittels einer Exit While-Anweisung abbrechen. While Not EOF(1) Line Input #1, a MyList.AddItem a Wend
' Zeilen aus Datei in Auflistung einlesen
Die Do...Loop- Schleife Am meisten Flexibilität bietet die Do-Schleife. Sie lässt sich als abweisende, als nicht abweisende Schleife und als Endlosschleife formulieren. In der abweisenden Form wird das Schleifenkriterium mit einem While- oder Until-Zusatz hinter das Schlüsselwort Do, in der nicht abweisenden Form hinter das Schlüsselwort Loop gesetzt. Ein While-Kriterium bricht die Schleife ab, wenn es den Wert 0 hat, während ein Until-Kriterium mit einem Wert ungleich 0 den Abbruch bedingt. Wie die anderen Schleifen lässt sich auch die Do-Schleife jederzeit von innerhalb des Schleifen-
42
Fehlerbehandlung
körpers mittels einer Exit Do-Anweisung abbrechen. Endlosschleifen sind in Wirklichkeit halbabweisende Schleifen, da sie mittels Exit Do irgendwo mitten im Schleifenkörper abgebrochen werden müssen. Do Line Input #1, a Loop While a = "" MyList.AddItem a
' Leerzeilen überlesen
' Zeile in Auflistung einfügen
Warnung
................................................... Wa rnung
Tipps
................................................... Tipps Als Faustregel lässt sich sagen, dass Schleifen in einem Programm ca. zwischen 80 und 99 Prozent der Ausführungszeit absorbieren. Es lohnt sich daher, wenn es um die Einsparung von Laufzeit geht, insbesondere innere Schleifen zu optimieren, die besonders oft durchlaufen werden. Rekursive Aufrufe von Funktionen/Prozeduren lassen sich in der Regel ohne große Schwierigkeiten mittels Schleifen in iterative Aufrufe überführen. Iterative Fassungen dienen insbesondere der Vermeidung des Fehlers 28, »Nicht genügend Stapelspeicher« und sind von der Laufzeit her meist überlegen. Endlosschleifen nicht kompilierter Programme lassen sich innerhalb der Entwicklungsumgebung mittels (Strg)+(Untbr) abbrechen. Schwieriger ist der Abbruch von endlosen Ereignisschleifen unter Windows 9x. Aber auch hierzu gibt es einen Trick, den unter Windows 9x allfälligen Reset zu vermeiden. Das Problem ist, dass der Task-Scheduler von Windows 9x der aus dem Rahmen fallenden Anwendung nach gewisser Zeit nahezu die gesamte Rechenzeit zur Verfügung stellt, weil die Nachrichtenflut die Priorität so weit hochschraubt, dass keine Hintergrundanwendung mehr Nachrichten zugestellt bekommt (noch nicht einmal der Task-Switcher). Der Trick: Man muss die Visual-Basic-Anwendung durch den impliziten Start einer Vordergrundanwendung in den Hintergrund verbannen. Für einen solchen impliziten Start reicht bereits das Einlegen einer CD (gegebenenfalls mit Autorun-Anwendung) oder der Empfang eines Faxes. Windows NT ist gegen endlose Ereignisschleifen unempfindlich, da die Ereigniswarteschlange in diesem Betriebssystem anders implementiert ist. Beispiele
................................................... Beis piele
Für die For-Anweisung vgl. das Beispiel zu »Literale und Konstanten« (S. 23). Für die Do-Anweisung vgl. das Beispiel zu »InStrRev-Funktion« (S. 79). Für die While-Anweisung vgl. die Beispiele zu »Dir-Funktion« (S. 148). Komplexer ist das Beispiel des Bubble-Sort-Algorithmus im Abschnitt »Prozeduren selbst definieren« (S. 204).
Fehlerbehandlung Sub Error(lFehlerNr As Long)
43
Kontrollstrukturen
Da Schleifen die Reaktionen eines Windows-Programms auf Benutzereingaben sehr beeinträchtigen können, empfiehlt es sich, in Schleifen mit zeitaufwändigen Berechnungen etwa jede Zehntelsekunde die Anweisung DoEvents aufzurufen. Beachten Sie jedoch, dass es zur Rekursion kommt, wenn bei der Ereignisverarbeitung die so unterbrochene Funktion/Prozedur erneut aufgerufen wird. Achtung! Endlosschleifen entstehen häufig auch ungewollt durch Ereignisse, die sich gegenseitig oder selbst auslösen. Ereignisfluten dieser Art können das System destabilisieren.
Kontrollstrukturen
Sub Err.Raise(Number As Long[, Source As String, _ Description As String, Helpfile As String, _ Helpcontext As String]) Function Error(lFehlerNr As Long) As String
Kontrollstrukturen
On Error Resume Next On Error GoTo Marke ... [On Error GoTo 0] ... Exit {Function | Sub} Marke: ... Resume [Next] Function CVErr(FehlerNummer As Long) As Error Funktion IsError(VarWert) As Boolean Beschreibung
................................................... Bes c hreibung
Die Vielfalt der möglichen Ursachen für das Fehlverhalten eines Systems steigt mit der Komplexität des Systems. Es ist nicht nur aus theoretischen Gründen unmöglich, die Logik eines Programms so zu gestalten, dass dieses vor jedem Schritt jede Fehlermöglichkeit ausschließt – schließlich könnte sich eine Fehlerbedingung im zeitlichen Verlauf auch erst unmittelbar nach der Prüfung einstellen –, auch aus praktischen Erwägungen heraus ist es unsinnig, Laufzeit für die Überprüfung selbst halbwegs wahrscheinlicher Fehlerbedingungen aufzuwenden. Anstatt umfangreicher und letztlich doch unzulänglicher Fehlerprüfungen setzt sich daher in den Programmiersprachen zunehmend das Konzept der Ausnahmebehandlung bzw. der Behandlung von Laufzeitfehlern durch. Zu einem Laufzeitfehler kommt es, wenn eine Routine ihrer Aufgabe aufgrund einer Fehlerbedingung nicht nachkommen kann und dies als Laufzeitfehler mit einer bestimmten Nummer signalisiert. Das Signal für einen Laufzeitfehler kann von einer Routine des Betriebssystems, einer Komponente oder einem sonstigen Objekt gesetzt werden (die entsprechenden Fehlernummern sind im Hilfesystem dokumentiert), aber auch von einer Visual-Basic-Routine selbst, wenn diese die Anweisung Error unter Angabe einer Fehlernummer, lFehlerNr, oder die RaiseMethode des vordefinierten Err-Objekts ausführt. Die Funktion Error liefert die zu einer Fehlernummer gehörige textuelle Fehlermeldung. Zur Behandlung eines Laufzeitfehlers – gleich welcher Natur dieser ist – lässt sich mittels einer On Error GoTo-Anweisung eine vorbereitete Fehlerbehandlungsroutine auf Funktions-/Prozedurebene installieren. Die Anweisung On Error Resume Next installiert dagegen eine standardmäßige Fehlerbehandlungsroutine für die Inline-Fehlerbehandlung, deren Strategie darin besteht, den für den Laufzeitfehler verantwortlichen Befehl zu überspringen und die Fehlerbehandlung unmittelbar im Anschluss an den Befehl durch Auswertung der Fehlernummer durchzuführen. Für die De-installation einer Fehlerbehandlungsroutine sorgt On Error GoTo 0. Ein anderes Konzept für die Signalisierung von Fehlern eröffnet die Funktion CVErr. Sie liefert einen Wert von Typ Variant mit dem Untertyp Error zurück und ermöglicht die Implementation von Funktionen/Prozeduren, die als Ergebniswert auch eine Fehlernummer zurückgeben können. Ob ein Variant-Wert den Untertyp Error hat, lässt sich mittels der IsError-Funktion in Erfahrung bringen. Aufgerufen mit einem Variant-Wert, liefert Sie den Wert True, wenn dieser eine Fehlernummer repräsentiert.
44
Fehlerbehandlung
Anwendung
................................................... Anwendung
45
Kontrollstrukturen
Die Anweisungen Error bzw. Err.Raise werden im Allgemeinen zur Simulation von Fehlern eingesetzt, um den Code für die Behandlung von Laufzeitfehlern zu testen. Darüber hinaus eignen sich die Befehle auch für die Realisierung programminterner Fehlerbehandlungsmechanismen. (Einzelheiten über den Einsatz des Fehlerobjekts für die Signalisierung von Laufzeitfehlern finden Sie im Abschnitt »Err-Objekt«, S. 277). Die Fehlernummer 0 sowie Fehlernummern größer als 65535 sind nicht zulässig, sondern führen ihrerseits zu einem Laufzeitfehler 5, »Ungültiger Prozeduraufruf oder ungültiges Argument«. Die Fehlernummern zwischen 1 und 1000 sind für das Laufzeitsystem von Visual Basic reserviert, wenn auch derzeit noch nicht alle mit einer Bedeutung versehen sind. Die anderen Fehlernummern sind frei verfügbar und lassen sich für programmspezifische Zwecke nutzen. Für die reservierten Fehlernummern von Visual Basic stehen textuelle Fehlermeldungen zur Verfügung, die sich mittels der Funktion Error – jeweils auf den letzten Fehler bezogen – abfragen lassen. Bei Einsatz des Err-Objekts lässt sich diese Fehlermeldung für jede Fehlernummer Number frei gestalten, da Error nichts weiter als den Wert der Description-Eigenschaft dieses Objekts liefert. Wenn der Vorgabetext des Systems für die Signalisierung programmspezifischer Fehler nicht angemessen ist, ist nur der Wert dieser Eigenschaft anzupassen – bzw. der Text als Wert bei Aufruf der Raise-Methode für den zweiten Parameter anzugeben. Um Laufzeitfehler abzufangen und darauf reagieren zu können, installiert man mittels On Error GoTo Marke eine Fehlerbehandlungsroutine, wobei Marke (am Zeilenanfang gefolgt von einem Doppelpunkt zu notieren) eine innerhalb derselben Routine befindliche Sprungmarke darstellt, die den Beginn des Fehlerbehandlungscodes kennzeichnet. Die für die genauere Analyse des Fehlers erforderliche Fehlernummer liefert die Eigenschaft Err.Number des vordefinierten Fehlerobjekts. Nachdem es sich dabei um die Standardeigenschaft des Objekts handelt, ergibt sich der Wert bereits durch schlichte Nennung des Objektbezeichners – was insbesondere die Kompatibilität mit älterem Basic-Code sicherstellt. Der zur Fehlernummer gehörige Fehlertext liefert die Error-Funktion oder die Eigenschaft Err.Description. Der Befehl Resume beendet die Fehlerroutine nach erfolgreicher Behandlung des Fehlers mit einem Rücksprung und bewirkt die erneute Ausführung jenes Befehls, der den Laufzeitfehler ausgelöst hatte. Falls eine Wiederholung dieses Befehls nicht in Frage kommt, lässt sich die Ausführung mit Resume Next beim nächstfolgenden Befehl wieder aufnehmen. Bei Fehlern, die sich nicht erfolgreich behandeln lassen oder für die die Fehlerroutine nicht ausgelegt ist, bleibt der Routine nur der Ausweg, ihrerseits einen Fehler auszulösen, der dann auf der Ebene des Aufrufers behandelt wird – und somit den gleichen Weg nimmt wie ein Fehler, für den keine Fehlerbehandlung auf aktueller Aufrufebene eingerichtet ist. Anders herum: Kommt während der Behandlung eines Fehlers eine Funktion/Prozedur zum Aufruf, die eine eigene Fehlerbehandlung vornimmt, ist deren Fehlerbehandlungsroutine für alle auf dieser Ebene ausgelösten Fehler zuständig. Hat die Funktion/Prozedur keine eigene Fehlerbehandlung, fällt die Fehlerbehandlung der Fehlerbehandlungsroutine des Aufrufers zu. Damit besteht die Möglichkeit, dass eine Fehlerbehandlungsroutine während der Behandlung eines Fehlers erneut zum Aufruf kommt, was von der Sache her nicht unbedingt mit Schwierigkeiten verbunden sein wird, logisch aber ein wenig verzwickt sein kann. Wenn ein Laufzeitfehler bereits durch Überspringen des jeweiligen Befehls behoben ist, kann die Fehlerbehandlungsroutine auch inline mittels On Error Resume Next installiert werden. In diesem Fall ist kein weiterer Code erforderlich. Die Zuständigkeit der jeweils aktuellen Fehlerbehandlungsroutine in einer Funktion/Prozedur erlischt mit dem Befehl On Error GoTo 0. Fehlt dieser Befehl, endet Zuständigkeit mit der Rückgabe der Kontrolle an den Aufrufer.
Kontrollstrukturen
Bei Signalisierung eines Fehlers ermittelt das Laufzeitsystem jeweils die nächste zuständige Fehlerbehandlungsroutine. Eine auf gleicher Ebene (Prozedurebene) gelegene Fehlerbehandlungsroutine kommt als Erstes zum Zuge, ansonsten wandert der Fehler in umgekehrter Aufruffolge von Aufrufer zu Aufrufer, bis sich eine zuständige Fehlerbehandlungsroutine findet oder das Laufzeitsystem schließlich eine standardmäßige Behandlung vornimmt. Warnung
Kontrollstrukturen
................................................... Wa rnung
Die Logik von Fehlerbehandlungsroutinen ist meist komplizierter als man denkt. So ist erstens davon auszugehen, dass jeder zwischen einer On Error GoTo Marke-Anweisung und einer On Error GoTo 0-Anweisung auftretende Laufzeitfehler zum Aufruf der Routine führen kann: falsche Argumente bei Prozedur-/Funktionsaufrufen ebenso wie Laufzeitfehler, die von einer aufgerufenen Prozedur oder Funktion signalisiert werden, weil sie dort keine Behandlung erfahren oder eine Behandlung nicht möglich ist. Zweitens ist aber auch davon auszugehen, dass ein Fehler immer wieder auftritt, weil er nicht korrekt behoben ist. Der unbedachte Einsatz von Resume ohne den Zusatz Next kann dann zu lästigen Endlosschleifen führen, die sich in der Entwicklungsumgebung nur noch mittels (Strg)+(Untbr) oder in der kompilierten Fassung des Programms nur noch über den Task-Manager abbrechen lassen. Ein häufiger Fehler im Zusammenhang mit Fehlerbehandlungsroutinen ergibt sich aus einer Nachlässigkeit: Die Ausführung durchläuft die Routine auch ohne Vorliegen eines Laufzeitfehlers, weil diese nicht durch den Befehl Exit Sub oder Exit Function vom gewöhnlichen Code abgesetzt ist. Tipp
................................................... Tipp
Testen Sie jede Fehlerbehandlungsroutine auf Herz und Nieren, indem Sie Testcode einsetzen, der alle Fehler – also auch solche, die die Routine nicht behandeln kann – mittels Error-Anweisungen oder Aufrufen der Methode Err.Raise simuliert. Beispiel
................................................... Beis piel
Das folgende Codebeispiel demonstriert die Fehlerbehandlung, wenn das Öffnen einer Datei mit vorangehender Abfrage des Dateinamens fehlschlägt. Da es keinen Sinn macht, die OpenAnweisung ohne erneute Eingabe des Dateinamens (hier über ein Standarddialoge-Objekt CommonDialog1 gelöst) zu wiederholen, ist der betreffende Code in einer eigenen Funktion zusammengefasst, der die Dateinummer zurückliefert. Die in der aufrufenden Routine installierte Fehlerbehandlungsroutine bietet dem Benutzer die Wahl zwischen der Wiederholung des gesamten Funktionsaufrufs oder einem Abbruch der aktuellen Routine. Der Abbruch wird seinerseits durch Auslösung eines Laufzeitfehlers bewerkstelligt. (Hinweis: Der FreeFile-Aufruf liefert nach einem Fehlschlag wieder die gleiche Dateinummer, da Open keine Reservierung der angebotenen Dateinummer vornimmt.) ... Dim Handle As Integer Dim Meldung As String ... On Error GoTo OpenFehler ' Routine installieren Handle = OpenBinary ' Funktion aufrufen On Error GoTo 0 ' Routine de-installieren ... Exit Sub ' Hier nicht weiter! OpenFehler: Meldung = "Fehler" + Str(Err) + ": " + Error(Err)
46
Fehlerbehandlung
If MsgBox(Meldung, vbRetryCancel) = vbRetry Then Resume ' Funktionsaufruf wiederholen Else ' Fehler an Aufrufer weitermelden Err.Raise(1001, "Binärdatei lässt sich nicht öffnen") End If ...
Vgl. auch das Beispiel zu »Open-Anweisung« (S. 166). Verwandte Themen
................................................... Verwa ndte Them en
Dateiorientierte Funktionen und Anweisungen (S. 126); Err-Objekt (S. 277); Standarddialoge-Steuerelement (CommonDialog) (S. 444)
47
Kontrollstrukturen
Function OpenBinary() As Integer OpenBinary = FreeFile ' freie Dateinummer ermitteln CommonDialog1.ShowOpen Open CommonDialog1.FileName For Binary As FreeFile End Function
Datentypen und ihre Operationen Wie alle Programmiersprachen, deren Wurzeln in der prozeduralen Programmierung liegen, verfügt Basic über ein Typkonzept, das im Laufe der Sprachentwicklung zunehmend reichhaltiger geworden ist. Das ursprüngliche Typsystem von Basic war geschlossen. Es gab vier numerische Datentypen mit unterschiedlichen Wertebereichen, über denen sich Ganzzahl- und Fließkommaarithmetik und ein wenig Boolsche Algebra betreiben ließ, sowie einen Zeichenfolgendatentyp mit vielen komfortablen Funktionen. QuickBasic und QBasic brachten der Sprache eine »Pascalisierung«, die sich nicht nur in einem verallgemeinerten Prozedur- und Funktionsbegriff bemerkbar machte, sondern auch in der Öffnung des Typsystems für benutzerdefinierte Datentypen. Darüber hinaus erhielt die Sprache auch einen flexiblen Datentyp, der jeden elementaren Datentyp (nicht jedoch benutzerdefinierte Datentypen) vertreten konnte und aufgrund impliziter Typumwandlungen eine gewisse Typtoleranz mit sich brachte. Seit die Sprache mit Visual Basic in den Bereich der objektorientierten Programmierung vorgedrungen ist, hat das Typsystem der Sprache in Form der in Typbibliotheken vorliegenden Objektdatentypen eine explosive Verbreiterung erfahren.
Elementare Datentypen Byte, Boolean, Integer, Long, Single, Double, Currency, Decimal, Date, Object, String, Variant True, False, Empty, Nothing, Null, Error Function IsEmpty(Var) As Boolean Function IsError(Var) As Boolean Function IsNull(Var) As Boolean Function IsNumeric(Var) As Boolean Function IsObject(Var) As Boolean Beschreibung
................................................... Bes c hreibung
Elementare Datentypen sind die Grundelemente einer Sprache für die Darstellung und Interpretation von Informationen. Die einzelnen Datentypen unterscheiden sich hinsichtlich ihrer Darstellung, ihrer Wertebereiche und der für sie definierten grundlegenden Operationen. Visual Basic kennt elementare Datentypen für die Repräsentation logischer Werte (Boolean), binärer Werte (Byte), numerischer Ganzzahlwerte (Integer und Long), numerischer Fließkommawerte (Single und Double), Datumsgaben (Date), Zeichenfolgen (String) und die Referenz auf Objekte (Object). Anwendung
................................................... Anwendung
Mit Hilfe der elementaren Datentypen lassen sich Konstanten und Variablen für die Handhabung der in Programmen anfallenden Daten deklarieren. Jeder dieser Datentypen mit Ausnahme von Variant steht für eine ganz bestimmte Art der Repräsentation und Interpretation von Information. Die folgende Tabelle gibt einen Überblick über ihre Wertebereiche.
49
Elementare Datentypen
Elementare Datentypen
Datentyp
Bytes
Beschreibung und Wertebereich
Byte
1
Kurze vorzeichenlose Ganzzahl zwischen 0 bis 255
Boolean
2
Logischer Wert, True oder False
Integer
2
Ganzzahl zwischen –32.768 bis 32.767
Long
4
Lange Ganzzahl zwischen –2.147.483.648 und 2.147.483.647
Single
4
Gleitkommazahl einfacher Genauigkeit von –3,402823E38 bis –1,401298E–45 für negative Werte und von 1,401298E-45 bis 3,402823E38 für positive Werte
Double
8
Gleitkommazahl mit doppelter Genauigkeit: –1,79769313486232E308 bis –4,94065645841247E-324 für negative Werte und 4,94065645841247E–324 bis 1,79769313486232E308 für positive Werte
Currency
8
Ganzzahl mit Skalierung in 10.000stel zwischen –922.337.203.685.477,5808 und 922.337.203.685.477,5807
Decimal
14
29stellige Dezimalzahl ohne Exponent, als Ganzzahl zwischen ±79.228.162.514.264.337.593.543.950.335 mit Abstand 1, als Zahl mit 28 Nachkommastellen zwischen ±7,9228162514264337593543950335 mit Abstand ±0,0000000000000000000000000001
Date
8
Datum zwischen 1. Januar 100 und 31. Dezember 9999
Object
4
Referenz auf ein Objekt, eine gültige Adresse oder Nothing
String
10 + Länge Zeichenfolge mit variabler Länge. 0 bis theoretisch 231-1 Zeichen. In der Praxis ist je nach Speicherausbau des Systems aber bereits bei einer Länge von ca. 100 Millionen Zeichen Schluss, wegen »Überlauf des Zeichenfolgenspeichers»
String *
Länge
Zeichenfolge mit fester Länge zwischen 1 und 65.535 (216-1)
Variant
16
Standardtyp, bei numerischem Untertyp wie der Datentyp Double
Variant
22 + Länge Standardtyp, bei Zeichenfolge als Untertyp, wie Datentyp String mit variabler Länge
Die elementaren Datentypen von Visual Basic
Der Datentyp Variant Der Typ Variant bildet eine Hülle für alle anderen Datentypen und kann alle durch elementare Datentypen darstellbaren Werte repräsentieren (außer Zeichenfolgen fester Länge) sowie die Werte Empty, Nothing, Null und Error. Variablen vom Typ Variant müssen nicht eigens deklariert werden, da Visual Basic diesen Datentyp als Standardtyp für alle nicht explizit oder via Typkennzeichen deklarierten Variablen einsetzt. Es ist aber kein Fehler (ja sogar guter Programmierstil), Variablen vom Typ Variant explizit zu deklarieren. In diesem Fall erhält die Variable Empty als Initialisierungswert. Man kann einer Variant-Variablen auch den Wert Null zuweisen, was üblicherweise signalisiert, dass die Variable absichtlich keinen gültigen Wert enthält. Bei Zuweisung eines typgebundenen Werts speichert die Variable nicht nur den Wert an sich, sondern auch seinen Typ. Man spricht in diesem Zusammenhang vom Untertyp eines
50
Die Datentypen Integer,
Long,
Single und Double
Die Datentypen Integer, Long, Single und Double Die Datentypen Integer und Long setzt man üblicherweise für Zählvariablen, Indizierungen oder Berechnungen im Bereich der Ganzzahlarithmetik ein. Sie unterscheiden sich von einander allein durch ihren Wertebereich. Single und Double eignen sich dagegen speziell für die Darstellung gebrochen-rationaler Werte (lies: Dezimalzahlen mit Nachkommaanteil). Die zugehörige Gleitkommaarithmetik entspricht der üblichen Dezimalrechnung mit Rundung auf eine feste Anzahl von Dezimalstellen. Das bedingt, dass benachbarte Werte in den jeweiligen Wertebereichen keinen festen Abstand zueinander aufweisen (der bei den Datentypen Integer und Long ja 1 ist), sondern ihren Abstand mit wachsendem Betrag vergrößern (bzw. gegen 0 hin verkleinern). Double weist gegenüber Single die doppelte Genauigkeit sowie einen erheblich größeren Wertebereich auf. Visual Basic initialisiert diese Datentypen mit dem Wert 0 bzw. 0,0. ' Vollständige Deklaration Const cDelta As Double = 2.71364234E-123 Dim iGanzzahl As Integer Dim lGanzzahl As Long Dim sFlKommazahl As Single Dim dFlKommazahl As Double ' Deklaration mit Typkennzeichen Const ci# = 1.2 Dim i% Dim l&
51
Elementare Datentypen
Variant-Werts. Um die Sonderwerte abzufragen, lassen sich die eigens dafür definierten Boolean-Funktionen IsEmpty, IsError und IsNull verwenden – ein expliziter Vergleich mit den Werten Empty, Nothing, Null und Error tut es natürlich auch. Bei der Operation mit typgebundenen Werten kann es passieren, dass der Wertebereich des aktuellen Untertyps einer Variant-Variablen für die Darstellung eines Wert nicht mehr ausreicht. In diesem Fall nimmt Visual Basic eine implizite Typumwandlung im Sinne einer Wertebereichserweiterung vor. Implizite Typumwandlungen finden auch statt, wenn ein VariantWert mit numerischem Untertyp einer String-Variable oder ein Variant-Wert mit Untertyp String einer Variable mit numerischem Typ zugewiesen werden soll. Im ersten Fall wandelt Visual Basic den Variant-Wert in eine adäquate Zeichendarstellung um und im zweiten Fall in eine adäquate numerische Darstellung. Der Sonderwert Error in einer Variablen vom Datentyp Variant ist dafür vorgesehen, in Prozeduren erkannte Fehlerbedingungen anzuzeigen, wenn keine On Error-Fehlerbehandlung durch die Anwendung stattfindet. In diesem Fall muss die rufende Prozedur selbst den Fehler auswerten und nötige Maßnahmen ergreifen. Gesetzt wird der Sonderwert gewöhnlich mittels der Funktion CVErr, die eine Fehlernummer entgegennimmt und einen entsprechenden Error-Wert vom Typ Variant liefert. Trägt ein Variant-Wert den Untertyp Object, drückt der Wert Nothing aus, dass auf kein Objekt referiert wird. Um in Erfahrung zu bringen, ob ein Variant-Wert den Untertyp Object trägt, lässt sich die Boolean-Funktion IsObject verwenden. Nach all dem dürfte offensichtlich sein, welch enorme Flexibilität der Datentyp Variant mit sich bringt und wie sehr er die Programmierung vereinfachen kann, indem er die Typenvielfalt auf einen einzigen Datentyp zurückführt. Allerdings verhält es sich bei der Programmierung mit diesem Datentyp anders als im richtigen Leben: Hier sollten die einfachen Dinge eher den Profis vorbehalten bleiben. Ungeübten Programmierern mit einem noch nicht vollständig ausgeprägten Verständnis für die elementaren Datentypen spielt das verborgene Wirken von Visual Basic gerne mal den einen oder anderen Streich.
Elementare Datentypen
Dim s! Dim d# For n% = 1 to 100
' Deklaration mit Typkennzeichen durch Nennung
Elementare Datentypen
Die Datentypen Boolean und Byte Der mit Visual Basic neu zu Basic hinzugekommene Datentyp Boolean weist einen sehr kleinen Wertebereich auf, nämlich nur die als Konstanten vordefinierten Wahrheitswerte True und False. In Basic entspricht der Wahrheitswert True traditionell dem Wert -1 und False dem Wert 0. Bei Typumwandlungen in den Datentyp Boolean wird jeder Wert ungleich 0 als True interpretiert und nur der Wert 0 als False. Boolean leistet vornehmlich in Kontrollstrukturen für die Programmsteuerung sowie bei der Berechnung logischer Funktionen auf Grundlage der Booleschen Algebra gute Dienste. Visual Basic initialisiert Variablen vom Typ Boolean mit False. Dim bLogValue As Boolean bLogValue = True ... If bLogValue Then ... End If
Gleichfalls ein neues Mitglied im Club ist der Datentyp Byte. Er dient insbesondere dem Umgang mit binären Inhalten, denen keine feste Interpretation zukommt. (Traditionell wurden für Inhalte dieser Art Zeichenfolgen benutzt.) Dieser Datentyp wird zwar noch als numerischer Datentyp gehandelt, das heißt, er wird mit 0 initialisiert, und man kann mit ihm ganz normal rechnen, solange der Wertebereich nicht überschritten wird. Er ist aber als einziger vorzeichenlos. Dim MyByte(256) As Byte ... For i = 0 to 255 Print #1, MyByte(i); Next i
Die Datentypen Currency und Date Der eng mit den ganzzahligen Typen Integer und Long verwandte Datentyp Currency wurde speziell zur Erleichterung finanzmathematischer Berechnungen mit in die elementaren Datentypen aufgenommen. Die Werte in seinem Wertebereich sind ein ganzzahliges Vielfaches von 0,0001. Damit stellt der Datentyp noch vier Stellen hinter dem Komma dar und seine Arithmetik entspricht der üblichen Dezimalrechnung mit Kaufmannsrundung an der vierten Stelle hinter dem Komma. Visual Basic initialisiert Currency-Variablen mit 0,0000. Interessanter ist der gleichfalls neue Datentyp Date, der nicht zuletzt im Schatten des Jahr-2000Problems eine ebenso zweifelhafte wie steile Karriere hinter sich hat. Visual Basic repräsentiert Werte dieses Typs als 64-Bit-Gleitkommazahlen (8 Bytes) nach IEEE und kann somit Datumsangaben im Bereich zwischen dem 1. Januar 100 und dem 31. Dezember 9999 sowie Uhrzeiten im Bereich von 0:00:00 bis 23:59:59 unterscheiden. Sie können mit diesem Datentyp Datumsangaben und Zeitangaben in Kombination, aber auch einzeln als Werte darstellen. Der Notation literaler Datums- und Zeitangaben liegt das amerikanische Format zugrunde, das heißt, in Datumsangaben wird der Monat vor dem Tag notiert und die Abtrennung erfolgt durch das Zeichen »/«, während Zeitangaben in 12-Stunden-Darstellung gefolgt von »PM« oder »AM« zu treffen sind. Zudem ist die Darstellung durch ein führendes und abschließendes Zeichen »#« einzuschließen. (Der Editor erkennt übrigens auch andere Darstellungen, so etwa #1 Feb 99#, und korrigiert diese beflissen in das erwünschte Format.)
52
Der Datentyp Decimal
Dim a = b = c =
a As Date, b As Date, c As Date #2/1/1996 1:12:01 PM# #12:01:00 PM# #2/1/1996#
Der Datentyp Decimal Der gleichfalls neue Datentyp Decimal ist kein eigenständiger Datentyp, sondern kann nur als Untertyp eines Variant-Werts auftreten. Um einen Wert dieses Typs zu erzeugen, bedarf es der Typumwandlungsfunktion CDec. Dim vDez1 vDez1 = CDec(100.00000021)
' aus Double erzeugt
Werte vom Typ Decimal haben eine 29-stellige dezimale Repräsentation mit Komma ohne Exponent im BCD-Code. Den Typen Single und Double liegt dagegen eine binäre Repräsentation zugrunde, die nicht mehr als 8 bzw. 15 dezimale Stellen erfasst. Um Decimal-Werte mit mehr als 15 Stellen (mehr erlaubt der Datentyp Double nicht) noch direkt definieren zu können, ist der Funktion CDec eine entsprechende Zeichenfolgendarstellung des Werts zu übergeben. Beachten Sie, dass dabei die auf dem jeweiligen System geltenden Ländereinstellungen eine Rolle spielen. So legt die Einstellung Deutsch (Standard) als Dezimalzeichen ein Komma fest. Dim vDez2 vDez2 = CDec("100,000000000000000021")
' aus String erzeugt
Warnung
................................................... Wa rnung
Visual Basic vereinbart jede Variable standardmäßig als Variant, wenn sie nicht explizit im Rahmen einer Variablendeklaration oder implizit durch eine DefType-Anweisung bzw. durch eines der traditionellen Typkennzeichen von Basic ($, %, &, !, #) eine feste Typzuweisung erfährt. Tipp
................................................... Tipp
Beobachten Sie bei der Fehlersuche in Programmen besonders Werte vom Typ Variant, insbesondere wenn Seltsames und Absurdes mit im Spiel zu sein scheint. Entlaufene Variant-Werte waren schon Ursache so manchen Übels. Vereinbaren Sie Variablen besser explizit, um einen bestimmten Datentypen zu erzwingen, das verbessert die Übersicht. Wenn Sie das Tippen länglicher Typdeklarationen scheuen, verwenden Sie doch DefType oder die Typkennzeichen ($, %, &, !, #). Oft entlarvt eine Option Explicit-Anweisung den Übeltäter bereits. Verwandte Befehle
................................................... Verwa ndte Befehle
Dim, Public, Private, Function, DefType Verwandte Themen
................................................... Verwandte Them en
Literale und Konstanten (S. 27); Typumwandlung (S. 57); Typkennzeichen und Bezeichnerbereiche für Typen (S. 167); Variablendeklaration (S. 162)
53
Elementare Datentypen
Beim Umwandeln anderer numerischer Datentypen in Werte des Datentyps Date repräsentieren die Vorkommastellen das Datum und die Nachkommastellen die Uhrzeit. Mitternacht entspricht dem Wert 0,0 und 12 Uhr Mittags dem Wert 0,5. Negative ganze Zahlen repräsentieren ein Datum vor dem 30. Dezember 1899, positive ein Datum nach dem 30. Dezember 1899. Den 30. Dezember 1899 selbst kennt Visual Basic dagegen überhaupt nicht, sondern interpretiert ihn als #12:00:00 AM#.
Operatoren für elementare Datentypen und logische Bedingungen
Operatoren für elementare Datentypen und logische Bedingungen +, –, *, /, \, MOD, ^, Not, And, Or, Xor, Eqv, Imp, <, >, =, >=, <=, <>, Is, TypeOf Beschreibung
Operatoren für elementare Datentypen und logische Bedingungen
................................................... Bes c hreibung
Operatoren dienen der Bildung von Ausdrücken. Die Menge der Operatoren, die Visual Basic für die elementaren Datentypen kennt, unterteilt sich in die Gruppe der logischen Operatoren (And, Or, Xor, Eqv, Imp, Not) – die in Visual Basic aufgrund der besonderen Wahl der Repräsentation der Wahrheitswerte mit den bitweisen Operatoren übereinstimmen –, die Gruppe der arithmetischen Operatoren (+, –, *, /. \, Mod, ^), die Gruppe der Vergleichsoperatoren (<, >, =, <=, >=, <>, Is) und die Gruppe der Zeichenfolgenoperatoren (die derzeit nur die Verkettungsoperatoren »+« und »&« umfasst). Eine Art Doppelrolle spielt traditionell der Zuweisungsoperator »=«, der für alle elementaren Datentypen definiert ist und gegebenenfalls auch für die implizite Typumwandlung zwischen verwandten Typen sorgt. Er darf nicht mit dem gleich notierten Vergleichsoperator verwechselt werden. Ein Vergleichsoperator der besonderen Art ist der Is-Operator für den Vergleich zweier Objektvariablen. Er liefert den Wert True, wenn die beiden Operanden auf dasselbe Objekt verweisen, ansonsten False. Er kommt insbesondere häufig im Zusammenhang mit dem TypeOf-Schlüsselwort zur Anwendung, wenn abgefragt werden soll, ob eine Objektvariable auf einen bestimmten Objekttyp verweist. If TypeOf MeineVar Is Form1 Anwendung
................................................... Anwendung Operator
Notation
Operation
Operanden
+ &
a + b a & b
Verkettung
Zeichenfolgen
+
a + b
Summenbildung
Numerische Werte
-
a – b
Differenzbildung
Numerische Werte
-
-a
Vorzeichenumkehr
Numerische Werte
*
a * b
Multiplikation
Numerische Werte
/
a / b
Division
Numerische Werte
\
a \ b
Division mit ganzzahligem Ergebnis
Numerische Werte
Mod
a Mod b
Restwertdivision (Modulo-Operation)
Numerische Werte
^
a ^ b
Potenz
Numerische Werte
And
a And b
Logisches und bitweises UND
Numerische Werte, logische Werte
Or
a Or b
Logisches und bitweises ODER Numerische Werte, logische Werte
Not
Not a
Logische und bitweise Negation
Operationen der elementaren Datentypen
54
Numerische Werte, logische Werte
Arrays
Notation
Operation
Operanden
Xor
a Xor b
Logisches und bitweises Exklu- Numerische Werte, logische Werte siv-ODER
Eqv
a Eqv b
Logische und bitweise Äquiva- Numerische Werte, logische Werte lenz
Imp
a Imp b
Logische und bitweise Implika- Numerische Werte, logische Werte tion
=
a = b
Logische Bedingung: »Gleichheit« (vgl. auch Eqv)
Numerische Werte, logische Werte, Zeichenfolgen, Datums-/Zeitwerte
<
a < b
Logische Bedingung: »kleiner als« (bei Zeichenfolgen von Option Compare abhängig)
Numerische Werte, logische Werte, Zeichenfolgen, Datums-/Zeitwerte
>
a > b
Logische Bedingung: »größer als« (bei Zeichenfolgen von Option Compare abhängig)
Numerische Werte, logische Werte, Zeichenfolgen, Datums-/Zeitwerte
<=
a <= b
Logische Bedingung: »kleiner Numerische Werte, logische Werte, gleich« (bei Zeichenfolgen: von Zeichenfolgen, Datums-/Zeitwerte Option Compare abhängig)
>=
a >= b
Logische Bedingung: »größer Numerische Werte, logische Werte, gleich« (bei Zeichenfolgen: von Zeichenfolgen, Datums-/Zeitwerte Option Compare abhängig)
<>
a <> b
Logische Bedingung: »ungleich«
Numerische Werte, logische Werte, Zeichenfolgen, Datums-/Zeitwerte
Is TypeOf
a Is b TypeOf a Is b
Testet, ob Operanden auf gleiches Objekt verweisen bzw. gleichen Objekttyp tragen
Objektvariablen
Operationen der elementaren Datentypen
Arrays Dim StatArray({iDimension1 | Untergrenze1 To Obergrenze1}[, _ {Dimension2 | Untergrenze2 To Obergrenze2}[, _ ... {DimensionN | Untergrenze2 To Obergrenze2}]]) _ [As Typ] Dim DynArray() [As Typ] ReDim [Preserve] DynArray [As Typ] Function Array([Wert1[, Wert2[, ... WertN]]]) As Variant Function UBound(Array[, iDimension As Integer = 1]) As Long Function LBound(Array[, iDimension As Integer = 1]) As Long Function IsArray(Var) As Boolean Option Base {0 | 1}
55
Arrays
Operator
Arrays
Beschreibung
Arrays
................................................... Bes c hreibung
Ein Array stellt eine ein- oder mehrdimensionale Struktur dar, die eine Menge von Werten gleichen Typs unter einem gemeinsamen Variablenbezeichner zusammenfasst. Visual Basic unterscheidet zwischen statischen und dynamischen Arrays. Die (endgültige) Deklaration statischer Arrays erfolgt im Rahmen einer Dim-Anweisung. Für die Deklaration sind neben dem Array-Bezeichner StatArray auch ein oder mehrere Indexbereiche anzugeben – je nachdem, wie viele Dimensionen das Array besitzt – sowie optional ein Elementtyp Typ. Wird ein Indexbereich durch Nennung einer Obergrenze iDimensionN angegeben, beginnt die Zählung der Array-Elemente standardmäßig bei 0 (Option Base 0 ist die Voreinstellung von Visual Basic), es sei denn, das betreffende Modul enthält die Anweisung Option Base 1. Es lassen sich aber auch Indexbereiche mit beliebigen Grenzen durch explizite Nennung unterer und oberer Grenzen (UntergrenzeN To ObergrenzeN) vereinbaren. Die formale Deklaration eines dynamischen Arrays kann durch Vereinbarung einer Array-Variablen im Rahmen einer Dim-Anweisung geschehen, muss aber nicht. Dabei notiert man den Bezeichner DynArray gefolgt von einem leeren Klammerpaar und vereinbart optional einen Elementdatentyp. Die konkrete Definition kann dann an passender Stelle vermittels der ReDimAnweisung unter Angabe von Dimensionen und Array-Grenzen geschehen – auch mehrmals mit unterschiedlichen Grenzen und Dimensionen, aber gleichem Datentyp. ReDim eignet sich auch zur Vergrößerung eines bereits definierten dynamischen Arrays unter Beibehaltung der Dimensionen und Elementwerte. In diesem Fall muss das Schlüsselwort Preserve angegeben werden. Der Zugriff auf den Wert eines Array-Elements erfolgt durch Angabe des Array-Bezeichners gefolgt von einem Index oder einer Indexliste (bei mehrdimensionalen) Arrays in Klammern). Anwendung
................................................... Anwendung
Arrays eignen sich hervorragend zur Verwaltung großer Mengen von gleichartigen, aber auch ungleichartigen (wenn als Datentyp Variant vereinbart wird) Daten, auf die ein effizienter indexsequenzieller Zugriff erfolgen soll. Seien es Matrixelemente bei der numerischen Vektorrechnung, Messwerte, Adressenstämme, Datensätze oder auch Ansammlungen gleichartiger Steuerelemente, die Array-Struktur bietet sich hervorragend für die einfache und schnelle Handhabung von variablen Werten an. Als Elementtyp für Arrays sind alle elementaren und komplexen Datentypen erlaubt, insbesondere auch benutzerdefinierte Datentypen, Objekte und der Typ Variant. Da ein Wert vom Typ Variant seinerseits ein Array sein kann, sind also auch implizit verschachtelte Arrays mit individueller Tiefe je Element möglich. Eine Array-Variable lässt sich wie eine gewöhnliche Variable verwenden – sie erhält ihren »Wert« durch Zuweisung oder durch (partielle) Initialisierung im Zuge einer ReDim-Anweisung. Im Gegensatz zu anderen Programmiersprachen (vgl. C/C++) beschränkt sich Visual Basic bei der Zuweisung eines Arrays an eine Array-Variable nicht auf eine reine Adresszuweisung, sondern erstellt eine physikalische Kopie des gesamten Arrays, wie folgender Code beweist: Dim a(0), b() a(0) = 10 b = a a(0) = 11 Print b(0), a(0)
' Ausgabe: 10
11
Diese Aussage ist allerdings mit Vorsicht zu genießen, sie gilt nämlich nur, wenn die Elemente einfache Datentypen tragen. Von Objekten fertigt Visual Basic keine Kopien an. Das liegt daran, dass der Wert einer Objektvariablen einen Verweis auf das tatsächliche Objekt darstellt und die einfache Zuweisungsoperation (im Gegensatz zur Set-Anweisung) sich auf eine Kopie des Verweises beschränkt, wie folgender Code zeigt:
56
Typumwandlung
Dim a(0) As Object, b() As Object Set a(0) = Me ' Formular wird zugewiesen b = a b(0).Caption = "Dieser " a(0).Caption = "oder jener?" Print b(0).Caption ' Ausgabe: "oder jener?"
Array- Funktionen
Beispiel
................................................... Beis piel
Dim StatArray(-10 To 10, -10 To 10) As Integer ' statisch, zweidim. Dim DynArray() As String ' dynam. deklarieren ... Redim DynArray(10) As String ' dynam. definieren ... Redim Preserve DynArray(UBound(DynArray) + 1) As String 'erweitern Verwandte Themen
................................................... Verwandte Them en
Auflistungen und Collection-Objekte (S. 304); Get-Anweisung (S. 140); Elementare Datentypen (S. 49)
Typumwandlung Function CBool(Ausdruck) As Boolean Function CByte(Ausdruck) As Byte Function CCur(Ausdruck) As Currency Function CDate(Ausdruck) As Date Function CDbl(Ausdruck) As Double Function CDec(Ausdruck) As Decimal Function CInt(Ausdruck) As Integer
57
Typumwandlung
Visual Basic unterstützt Array-Konstanten ebenso wenig wie literale Arrays. Während bei statischen Arrays die Wertzuweisung elementweise erfolgen muss, kann im Falle von dynamischen Arrays eine Zuweisung auch auf Array-Ebene erfolgen. Das macht ein kompakte Initialisierung mittels der Array-Funktion möglich, die ihre als Aufrufparameter übergebene Werteliste als Array zurückliefert. Um die obere bzw. untere Indexgrenze eines Arrays in Erfahrung zu bringen, gibt es die Funktionen UBound bzw. LBound. Falls das Array mehr als eine Dimension besitzt, lässt sich die Dimension als Wert iDimension spezifizieren (die Zählung beginnt bei 1). Variablen des Typs Variant können bekanntlich Werte verschiedenster Datentypen annehmen, darunter auch Arrays. Die Funktion IsArray liefert eine Aussage in Form eines Wahrheitswerts darüber, ob es sich bei einer Variablen um eine Array-Variable handelt oder nicht. Leider kennt Visual Basic keine Funktion, die den kompletten Speicherbedarf für das Speichern eines Arrays ermittelt. Dieser Wert muss vielmehr aus dem Elementdatentyp, der Dimensionenzahl, der Dimensionsgrenzen und gegebenenfalls mitzuspeichernder Deskriptoren »zu Fuß« errechnet werden (vgl. »Get-Anweisung«, S. 140), da Arrays in den unterschiedlichen Dateimodi unterschiedlich repräsentiert werden.
Typumwandlung
Function CLng(Ausdruck) As Long Function CSng(Ausdruck) As Single Function CVar(Ausdruck) As Variant Function CVDate(Ausdruck) As Variant Function CStr(Ausdruck) As String Function IsDate(Ausdruck) As Variant
Typumwandlung
Function IsNumeric (Ausdruck) As Boolean Beschreibung
................................................... Bes c hreibung
Die explizite Typumwandlung wird bei Visual Basic zwar nicht so groß geschrieben wie bei manch anderer Programmiersprache, da der Visual Basic Compiler von sich aus implizite Typanpassungen nach Bedarf vornimmt, vermeidbar ist sie aber nicht in allen Fällen. Die folgende Tabelle gibt einen Überblick über die auf die einzelnen Datentypen zugeschnittenen Konvertierungs- und Typumwandlungsfunktionen. Funktion
Beschreibung
CBool
Konvertiert Ausdruck nach Möglichkeit (bei Zeichenfolgen ohne Unterscheidung der Großschreibung) in einen Wert vom Typ Boolean; Interpretiert die Zeichenfolgen "Wahr", "True" sowie numerische Werte ungleich 0 als True und die Zeichenfolgen "Falsch", "False" sowie den Wert 0 als False. Bei anderen Zeichenfolgen liefert die Funktion einen Laufzeitfehler.
CByte
Liefert Ausdruck als Wert vom Typ Byte. Fließkommawerte mit einem Nachkommaanteil von exakt 0,5 werden zur nächsten geraden Zahl hin gerundet (0,5 wird zu 0 und 1,5 zu 2), ansonsten gilt die Kaufmannsrundung. Liegt der Wert von Ausdruck nicht im Bereich zwischen 0 und 255 oder ist Ausdruck von Typ String, löst die Funktion einen Laufzeitfehler aus.
CCur
Liefert Ausdruck als Wert vom Typ Currency. Rundet numerische Werte auf vier Stellen hinter dem Komma und interpretiert Zeichenfolgen im gebietsspezifischen Währungsformat. Für das Gebietsschema »Deutsch (Standard)« gilt: Komma ist Dezimalzeichen, Punkt ist Tausendertrennzeichen, »DM« als führendes oder nachgestelltes Währungssymbol ist erlaubt, sonstige nicht zur Notation von Zahlenliteralen gehörende Zeichen führen zu einem Laufzeitfehler. Der zulässige Wertebereich für Ausdruck geht von -922.337.203.685.477,5808 bis 922.337.203.685.477,5807.
CDate
Liefert Ausdruck als Wert vom Typ Date. Interpretiert numerische Werte und Zeichenfolgen als Zeit-/Datumswert. Bei numerischen Werten ist ein Vorkommaanteil zwischen -657.434 und 2.958.465 zulässig – er wird als Tage-Offset bezogen auf das Datum 1.1.1899 interpretiert – und ein Nachkommaanteil von nicht mehr als sechs Stellen – er wird als Sekunden-Offset bezogen auf das Datum interpretiert. Bei der Interpretation von Zeichenfolgen erkennt die Funktion das kurze, mittlere oder lange gebietsspezifische Datumsformat (das lange Datumsformat jedoch nur, wenn kein Wochentag notiert ist). Die Funktion IsDate erlaubt eine Vorabprüfung, ob ein gegebener Wert in einen Zeit-/Datumswert wandelbar ist.
Konvertierungs- und Typumwandlungsfunktionen
58
Typumwandlung
Beschreibung
CDbl
Liefert Ausdruck als Wert vom Typ Double. Bei der Konvertierung aus Decimal und Currency werden nicht darstellbare Stellen gegebenenfalls gerundet, alle anderen numerischen Datentypen lassen sich ohne Genauigkeitsverlust überführen. Bei der Konvertierung von Zeichenfolgen erwartet die Funktion das gebietsspezifische Zahlenformat. Für das Gebietsschema »Deutsch (Standard)« gilt: Komma ist Dezimalzeichen, Punkt ist Tausendertrennzeichen. Der Wertebereich geht von -1,79769313486232E308 bis -4,94065645841247E-324 für negative Werte und von 4,94065645841247E-324 bis 1,79769313486232E308 für positive Werte.
CDec
Liefert Ausdruck als Wert vom Typ Decimal, der jedoch (ohne erneute Typumwandlung) nur Variablen des Typs Variant zugewiesen werden kann. Bei der Konvertierung von Zeichenfolgen erwartet die Funktion das gebietsspezifische Zahlenformat. Für das Gebietsschema »Deutsch (Standard)« gilt: Komma ist Dezimalzeichen, Punkt ist Tausendertrennzeichen. Der Wert selbst darf im Bereich ±79.228.162.514.264.337.593.543.950.335 liegen, wobei das Komma fließen darf.
CInt
Liefert Ausdruck als Ganzzahlwert vom Typ Integer. Fließkommawerte mit einem Nachkommaanteil von exakt 0,5 werden zur nächsten geraden Zahl hin gerundet (0,5 wird zu 0 und 1,5 zu 2) ansonsten gilt die Kaufmannsrundung. Der Wertebereich geht von -32.768 bis 32.767.
CLng
Liefert Ausdruck als Ganzzahlwert vom Typ Long. Fließkommawerte mit einem Nachkommaanteil von exakt 0,5 werden zur nächsten geraden Zahl hin gerundet (0,5 wird zu 0 und 1,5 zu 2), ansonsten gilt die Kaufmannsrundung. Der Wertebereich geht von -2.147.483.648 bis 2.147.483.647.
CSng
Liefert Ausdruck als Wert vom Typ Single. Bei der Konvertierung aus Double, Decimal und Currency werden nicht darstellbare Stellen gegebenenfalls gerundet, alle anderen numerischen Datentypen lassen sich ohne Genauigkeitsverlust überführen. Bei der Konvertierung von Zeichenfolgen erwartet die Funktion das gebietsspezifische Zahlenformat. Für das Gebietsschema »Deutsch (Standard)« gilt: Komma ist Dezimalzeichen, Punkt ist Tausendertrennzeichen. Der Wertebereich geht von -1,79769313486232E308 bis -4,94065645841247E-324 für negative Werte und von 4,94065645841247E-324 bis 1,79769313486232E308 für positive Werte.
CVar
Konvertiert numerische Werte in den Untertyp Double (vgl. CDbl) und alle anderen in den Untertyp String
CVDate
Konvertiert einen numerischen Wert oder eine Zeichenfolge Ausdruck in das von älteren Visual-Basic-Versionen benutzte Datumsformat Variant mit Untertyp Date. Da Date inzwischen als elementarer Datentyp verfügbar ist, dient diese Funktion nur noch dem Erhalt der Kompatibilität mit älteren Programmen. Dieselbe Funktionalität ergibt sich auch implizit, wenn der Funktionswert eines CDate-Aufrufs einer Variablen vom Typ Variant zugewiesen wird. Umgekehrt lässt sich aufgrund der impliziten Typanpassung des Compilers auch der Funktionswert eines CVDate-Aufrufs einer Variablen vom Typ Date zuweisen, so dass zwischen CDate und CVDate praktisch gesehen kein Unterschied besteht.
Konvertierungs- und Typumwandlungsfunktionen
59
Typumwandlung
Funktion
Benutzerdefinierte Datentypen
Benutzerdefinierte Datentypen
Funktion
Beschreibung
CStr
Liefert literale Darstellung von Ausdruck als Zeichenfolge im gebietsspezifischen Format. Wahrheitswerte erscheinen als "Wahr" und "Falsch", numerische Werte ohne Tausendertrennzeichen jedoch mit Komma als Dezimalzeichen und erforderlichenfalls in Fließkommanotation mit Exponentenanteil. Der Wert Empty entspricht der leeren Zeichenfolge, während Null einen Laufzeitfehler auslöst. Datumswerte erhalten das für das Gebietsschema geltende kurze Datumsformat. Die literale Darstellung eines Objekts ist die seiner Standardeigenschaft – so liefert CStr(Err) die zuletzt gesetzte Fehlernummer Err.Number.
Konvertierungs- und Typumwandlungsfunktionen Anwendung
................................................... Anwendung
Wer viel mit dem flexiblen Datentyp Variant arbeitet oder von einer streng typisierenden Programmiersprache her kommt, wird in so manchem Fall die Typumwandlungsfunktionen von Visual Basic zu schätzen wissen. Obwohl der Visual-Basic-Compiler weitgehend tolerant ist, was die implizite Typanpassung bei der Zuweisung, der Parameterübergabe und der Ausdrucksberechnung betrifft, lässt sich die Flexibilität im Miteinander von Datentypen durch explizite Typumwandlungen noch weiter verbessern, insbesondere wenn die länderspezifische Darstellung entlang des in der Systemsteuerung eingestellten Gebietsschemas bei der Umwandlung aus Zeichenfolgen ins Spiel kommt. So ist beispielsweise die explizite Typumwandlung in Visual Basic 6.0 der einzige Weg, um Werte des nur als Untertyp von Variant existierenden Datentyps Decimal zu generieren, denn eine Deklaration mit diesem vergleichsweise neuen Datentyp ist in der Version 6.0 noch nicht möglich. Auch greift der Compiler nur dann zum Mittel der impliziten Typumwandlung, wenn eine Verengung oder Erweiterung des gegebenen Typs unvermeidbar ist. Tipps
................................................... Tipps Um festzustellen, ob ein Wert als Zahl ausgewertet werden kann, steht die Boolean-Funktion IsNumeric zur Verfügung. Die Typumwandlung von einem benutzerdefinierten Typ in einen elementaren Typ ist nicht so ohne Weiteres möglich. Einen Schleichweg eröffnet jedoch die LSet-Anweisung (vgl. S. 80). Verwandte Befehle
................................................... Verwa ndte Befehle
Asc, Chr, ChrB, Date, DateSerial, Fix, Format, FormatCurrency, FormatDateTime, FormatNumber, FormatPercent, Int, Round, Str, StrConv Time, TimeSerial, Val Verwandte Themen
................................................... Verwandte Them en
Elementare Datentypen (S. 49)
Benutzerdefinierte Datentypen Visual Basic kennt drei verschiedene Arten von benutzerdefinierten Datentypen: in TypeKonstrukten vereinbarte Datenstrukturen; in Enum-Konstrukten vereinbarte Aufzählungsdatentypen; in Klassenmodulen definierte Klassen (Objektdatentypen). Letztere werden ausführlicher im objektorientierten Teil vorgestellt, wenn es um »Selbst definierte Klassen« (S. 318) geht. Ein Vergleich zwischen Type-Datentypen und Objektdatentypen findet sich in der Tabelle auf Seite 197.
60
Type- Datentypen
Type- Datentypen {Private | [Public]} Type BDT ElementName [([Indizes])] As Typ [ElementName1 [([Indizes])] As Typ] ... End Type With bdtVar .ElementName = Wert End With
................................................... Bes c hreibung
Die Type-Struktur ermöglicht die Definition eines eigenen Datentyps BDT, der aus Elementen ElementName bereits bekannter Datentypen zusammengesetzt ist. Die Private-Vereinbarung des Datentyps ist für beliebige Modularten auf Modulebene möglich und beschränkt den Geltungsbereich der Definition auf das jeweilige Modul. Fehlt der Spezifizierer Private, behandelt der Compiler die Definition als Public-Vereinbarung, die jedoch nur in einem Standardmodul zulässig ist. Ein Public-Datentyp ist in allen Modulen des gegebenen Projekts sowie in allen Projekten einer gegebenenfalls existierenden Projektgruppierung bekannt. Anwendung
................................................... Anwendung
Im Gegensatz zu älteren Basic-Versionen sind in Visual Basic statische und dynamische Arrays als Feldelemente für benutzerdefinierte Datentypen ebenso zulässig wie Objektvariablen. Auch einer Verschachtelung benutzerdefinierter Datentypen durch Verwendung bereits definierter Datentypen als Feldtyp steht nichts im Wege. Die Vereinbarung eines benutzerdefinierten Datentyps BDT für eine Variable weist formal keine Besonderheiten gegenüber der Vereinbarung eines elementaren Datentyps auf. Der einzige Unterschied zu den vordefinierten Datentypen von Visual Basic besteht darin, dass die PublicVereinbarung von Variablen benutzerdefinierter Typen nur in einem Standardmodul erfolgen darf, während in allen anderen Modularten eine Private-Deklaration erforderlich ist. An Operationen für benutzerdefinierte Datentypen gibt es nur den Punktoperator und den Zuweisungsoperator. Der Punktoperator ermöglicht den Zugriff auf die einzelnen Felder des benutzerdefinierten Datentyps für die Arbeit mit einzelnen Feldwerten nach dem Schema Var.Feld. Der Zuweisungsoperator ermöglicht die Zuweisung eines Werts mit einem benutzerdefinierten Datentyp an eine Variable gleichen Typs. Dabei kopiert Visual Basic alle Feldwerte en bloc, selbst wenn Arrays mit im Spiel sind. Zur Vereinfachung der Notation beim Zugriff auf Elementwerte eines benutzerdefinierten Datentyps (aber auch auf Eigenschaften und Methoden von Objekten, mit Ausnahme von Print, Circle und Line) kann die With-Struktur benutzt werden. Dabei führt die With-Anweisung den genannten Bezeichner als Qualifizierungskontext ein. Innerhalb eines Moduls benutzt Visual Basic von sich den Modulbezeichner als Qualifizierungskontext. Mit jeder With-Anweisung (Verschachtelung ist erlaubt) verengt sich der bestehende Qualifizierungskontext. Warnung
................................................... Wa rnung
Vom Prinzip her besteht zwar die Möglichkeit, LSet-Zuweisungen zwischen benutzerdefinierten Datentypen mit unterschiedlichen Strukturen vorzunehmen, von einem Gebrauch dieses Hintertürchens ist aber generell eher abzuraten, da dabei unvorhergesehene Effekte auftreten können (vgl. »LSet-Anweisung«, S. 80).
61
Benutzerdefinierte Datentypen
Beschreibung
Benutzerdefinierte Datentypen
Tipp
................................................... Tipp
Anstelle benutzerdefinierter Datentypen können Sie eigene Datentypen auch über Klassenmodule implementieren. Der dahinter stehende objektorientierte Ansatz verschmilzt das Konzept des benutzerdefinierten Datentyps mit den zu dem Datentyp gehörigen Manipulationsoperationen und bietet somit den Vorteil der Datenabstraktion. Beispiel
Benutzerdefinierte Datentypen
................................................... Beis piel
' Bereich (Allgemein) eines Moduls Private Type BDT lFeld As Long sFeld As String lDynArray() As Long sStatArray(10) As String End Type ... Dim bdtVar1 As BDT, bdtVar1 As BDT ... bdtVar1.lFeld = 10 ' numerischen Wert zuweisen bdtVar1.sFeld = "Wert des String-Feldes" ' Zeichenfolge zuweisen ReDim bdtVar1.lDynArray(10) As Long ' dyn. Array dimensionieren bdtVar2 = bdtVar1 ' Struktur en bloc zuweisen ' Schreibweise bei Qualifizierung mit With With bdtVar1 .lFeld = 10 ' numerischen Wert zuweisen .sFeld = "Wert des String-Feldes" ' Zeichenfolge zuweisen ReDim .lDynArray(10) As Long ' dyn. Array dimensionieren End With bdtVar2 = bdtVar1 ' Struktur en bloc zuweisen Verwandte Befehle
................................................... Verwa ndte Befehle
LSet Verwandte Themen
................................................... Verwandte Them en
Elementare Datentypen (S. 49); Routinen aus DLLs und der Windows-API einsetzen (S. 185); Objekte und Klassen (S. 195); Klassen als Datentypen für Objektvariablen (S. 196)
Enum- Aufzählungen {Private | [Public]} Enum MeineAufzählung Element1 = LiteralerWert1 [Element2 = LiteralerWert2] ... End Enum Beschreibung
................................................... Bes c hreibung
Eine Enum-Aufzählung ist eine Sammlung von Konstanten des Typs Long, die formal in einem Aufzählungsdatentyp zusammengefasst sind. Die einzelnen Konstanten sind jedoch auch jede für sich im Rahmen des jeweiligen Geltungsbereichs bekannt. Ein Aufzählungsdatentyp lässt
62
Funktionen und Anweisungen für Zeichenfolgen
sich wie jeder andere Datentyp für die Vereinbarung von Variablen, Parametern und Funktionswerten heranziehen, eine Überprüfung auf Einhaltung des über die Aufzählung definierten Wertebereichs findet jedoch nicht statt; auch unterscheidet der Compiler nicht zwischen unterschiedlichen Aufzählungsdatentypen, vielmehr behandelt er jeden Aufzählungsdatentyp als Long. Anwendung
................................................... Anwendung
Beispiel
................................................... Beis piel
Public Enum VbTest vbA1 = &H11111111 vbA2 = 101 vbA3 = 105 vbA4 = 103 vbA5 = 104 End Enum ... ' innerhalb einer Prozedur/Funktion Dim a As VbTest a = vbA3 Print TypeName(a) ' Ausgabe: "Long"
Funktionen und Anweisungen für Zeichenfolgen Der unkomplizierte Umgang mit Zeichenfolgen war schon immer die ureigenste Domäne der Programmiersprache Basic. Darüber hinaus hat sich die Ausstattung für die Manipulation von Zeichenfolgen mit jeder Neuauflage von Basic noch einmal verbessert, so dass dem Programmierer unter Visual Basic 6.0 ein ausgesprochen reichhaltiges Angebot an vordefinierten Funktionen und Anweisungen für die Arbeit mit Zeichenfolgen zur Verfügung steht. Während in früheren Versionen von Visual Basic so manche Zeichenfolgenfunktion in zwei Varianten implementiert war – eine mit $-Suffix und eine ohne –, von denen diejenige mit $-Suffix »echte« Zeichenfolgen lieferte und diejenige ohne $-Suffix Werte des Typs Variant, unterstützt Visual Basic 6.0 die Varianten mit $-Suffix zwar noch zur Wahrung der Kompatibilität, kommt aber grundsätzlich ohne sie aus. Beschreibung
................................................... Bes c hreibung
Seit Einführung der 32-Bit-Version mit Visual Basic 4.0 legt Visual Basic intern allen Zeichenfolgen die Unicode-Darstellung zugrunde. Im Gegensatz zu dem bis dahin verwendeten ANSICode, der zur Repräsentation eines Zeichens gerade mal ein Byte vorsieht (und somit nicht mehr als 256 Zeichen unterscheiden kann), umfasst die Repräsentation eines Zeichens im Unicode zwei Bytes. In Unicode gibt es daher bis zu 65.535 unterschiedliche Zeichen, die von der
63
Funktionen und Anweisungen für Zeichenfolgen
Obwohl es möglich ist, Variablen zu vereinbaren, die einen Aufzählungsdatentyp tragen, und der Editor der Entwicklungsumgebung bei der Notation von Rechtswerten dieses Typs eine Liste mit den vereinbarten Konstanten einblendet, sind Aufzählungsdatentypen faktisch nichts weiter als eine Umbenennung des Datentyps Long und somit reine Fassade. Sie verwenden Aufzählungsdatentypen, um Konstanten zu gruppieren und Symbolvorräte formal als endliche Wertebereiche ausdrücken zu können. Ein Blick in den Objektkatalog (Taste (F2)) zeigt, dass Visual Basic in seinen Bibliotheken massiv von diesem Konzept Gebrauch macht.
Funktionen und Anweisungen für Zeichenfolgen
Funktionen und Anweisungen für Zeichenfolgen
ISO international festgelegt wurden. Zeichen mit Unicode kleiner als 256 entsprechen den Zeichen des ANSI-Codes, so dass beispielsweise das Zeichen »A« mit dem ANSI-Code 65 (oder &H40) in Unicode die Darstellung »0, 65« (oder &H0040) hat. Neben Unicode gibt es noch einen weiteren Zeichencode namens DBCS (Double-Byte Character Set), dessen Darstellung zwei Bytes je Zeichen vorsieht. Dieser Code ist in erster Linie im asiatischen Sprachraum verbreitet und dazu gedacht, die Vielfalt der in diesen Sprachen verwendeten Schriftzeichen ausdrücken zu können. Er hat weder etwas mit ANSI-Code noch mit Unicode gemeinsam, stellt also einen völlig eigenständigen Zeichensatz dar. All dies heißt für den Visual-Basic-Programmierer, dass er es potenziell mit allen drei, sicherlich jedoch mit zwei unterschiedlichen Repräsentationsarten für Zeichenfolgen zu tun bekommen kann – so etwa beim Lesen von Datensätzen aus Dateien mit älteren und neueren Datenformaten. Damit aber nicht genug: Es gilt auch systembedingte Unterschiede zu beachten, die sich aufgrund unterschiedlicher Versionen für Objektbibliotheken und Windows selbst einschleichen. Die folgende Tabelle zeigt eine Aufstellung, welche Umgebung mit welcher Zeichendarstellung einhergeht. Umgebung
Verwendete Zeichensätze
Windows-9x-API
ANSI und DBCS
16-Bit-Objektbibliotheken
ANSI und DBCS
Visual Basic
Unicode
32-Bit-Objektbibliotheken
Unicode
Windows-NT-API
Unicode
Automatisierung in Windows NT
Unicode
Automatisierung in Windows 9x
Unicode
Zeichendarstellung in verschiedenen Windows- Komponenten
Um den Programmierer gegen alle Fälle zu wappnen, unterhält Visual Basic daher für die traditionellen Zeichenfolgenfunktionen Asc, Chr, Len, InStr, Left, Right und Mid unterschiedliche Varianten, deren Funktionsweise spezifisch auf die eine oder andere Repräsentation ausgerichtet ist. Varianten mit Suffix B (so etwa AscB) gehen von einer ANSI-Darstellung und Varianten mit Suffix W (so etwa ChrW) von einer Unicode- oder DBCS-Darstellung aus. Die folgende Tabelle gibt eine Übersicht über die unter Visual Basic 6.0 verfügbaren Funktionen und Prozeduren, die im engeren oder weiteren Sinne etwas mit der Manipulation von Zeichenfolgen zu tun haben. Bezeichner
Kurzbeschreibung
Asc
Liefert den ANSI-Code des ersten Zeichens einer Zeichenfolge (auf DBCSSystemen DBCS-Code)
AscB
Liefert den ANSI-Code des ersten Bytes einer Zeichenfolge
AscW
Liefert den Unicode des ersten Doppel-Bytes einer Zeichenfolge
Chr
Liefert das zu einem ANSI-Code gehörige Unicode-Zeichen
ChrB
Liefert das zu einem ANSI-Code gehörige ANSI-Zeichen
ChrW
Liefert das zu einem Unicode gehörige Unicode-Zeichen
Zeichenfolgenfunktionen und - prozeduren von Visual Basic
64
Funktionen und Anweisungen für Zeichenfolgen
Kurzbeschreibung
Filter
Durchsucht alle Elemente eines Zeichenfolgen-Arrays nach einer bestimmten Zeichenfolge und liefert die Array-Elemente, in denen diese enthalten ist
Format
Liefert Zeichenfolgendarstellung eines Werts im spezifizierten Format
FormatCurreny
Liefert die Darstellung eines Währungswerts im spezifizierten Format
FormatDateTime
Liefert die Darstellung eines Datumswerts im spezifizierten Format
FormatNumber
Liefert die Darstellung eines Zahlenwerts im spezifizierten Format
FormatPercent
Liefert die Darstellung eines Prozentwerts im spezifizierten Format
Hex
Liefert die hexadezimale Notation eines Werts
InStr
Liefert die Startposition einer Zeichenfolge in einer anderen Zeichenfolge
InStrB
Liefert die Startposition einer ANSI-Zeichenfolge in einer anderen ANSIZeichenfolge
InStrRev
Wie InStr, beginnt die Suche aber von hinten
Join
Umkehrfunktion zu Split, setzt die Zeichenfolgen eines String-Arrays zu einer einzigen Zeichenfolge zusammen (Trennzeichen optional)
LCase
Liefert die Kopie einer Zeichenfolge in Kleinschreibung
Left
Liefert den linken Teil einer Zeichenfolge
LeftB
Liefert den linken Teil einer ANSI-Zeichenfolge
Len
Liefert die Anzahl der Zeichen in Zeichenfolge – trägt der im Parameter übergebene Wert nicht den Typ String, liefert die Funktion die Anzahl der zum Speichern dieses Werts erforderlichen Bytes.
LenB
Liefert die Anzahl der Bytes, die für die Darstellung des Werts (zum Beispiel bei Speichern) erforderlich sind; liefert damit auch die Länge einer ANSI-Zeichenfolge
LSet
Byteorientierte, linksbündige Zuweisungsoperation für beliebige Datentypen, ohne Längenanpassung des Linkswerts. Elementare Datentypen unterliegen einer Typüberprüfung, benutzerdefinierte nicht.
LTrim
Liefert eine Kopie der Zeichenfolge ohne führende Leerzeichen zurück
Mid
Liefert den mittleren Teil einer Zeichenfolge
Mid
Zuweisungsoperation für den mittleren Teil einer Zeichenfolge
MidB
Liefert den mittleren Teil einer Zeichenfolge als ANSI-Zeichenfolge
MidB
Zuweisungsoperation für mittleren Teil einer ANSI-Zeichenfolge
MonthName
Liefert für eine Zahl zwischen 1 und 12 den Monatsname als Zeichenfolge
Oct
Liefert die oktale Notation eines Werts
Option Compare
Standardvorgabe für Zeichenfolgenvergleiche auf binären Vergleich oder Textvergleich (ohne Beachtung der Großschreibung) setzen
Zeichenfolgenfunktionen und - prozeduren von Visual Basic
65
Funktionen und Anweisungen für Zeichenfolgen
Bezeichner
Funktionen und Anweisungen für Zeichenfolgen
Funktionen und Anweisungen für Zeichenfolgen
Bezeichner
Kurzbeschreibung
Partition
Liefert das Intervall, in das eine Zahl fällt, als Zahlenbereich der Form »IntervallAnf: IntervallEnde«. Der Aufruf der Funktion erfolgt unter Angabe eines Startwerts für das erste Intervall, eines Endwerts für das letzte Intervall und einer Intervallbreite.
Replace
Sucht Vorkommen einer Suchzeichenfolge in Zeichenfolge, ersetzt dieses gegen Ersatzzeichenfolge und liefert resultierende Zeichenfolge
Right
Liefert den rechten Teil einer Zeichenfolge
RightB
Liefert den rechten Teil einer ANSI-Zeichenfolge
RSet
Rechtsbündige Zuweisungsoperation für Zeichenfolgen ohne Längenänderung des Linkswerts; füllt mit Leerzeichen auf oder schneidet ab
RTrim
Liefert die Kopie einer Zeichenfolge ohne abschließende Leerzeichen
Space
Liefert eine Zeichenfolge mit der gewünschten Anzahl von Leerzeichen
Split
Umkehrfunktion zu Join, durchsucht eine Zeichenfolge nach Trennzeichen und liefert die Zeichenfolgenabschnitte als Array
Str
Liefert standardmäßige Repräsentation eines Zahlenwerts als Zeichenfolge
StrComp
Führt alphanumerischen Zeichenfolgenvergleich durch und unterscheidet dabei vier Fälle
StrConv
Konvertiert eine Zeichenfolge nach einem von sieben möglichen Konvertierungsschemata und liefert die konvertierte Version als Kopie
String
Liefert Zeichenfolge mit der gewünschten Anzahl eines einzelnen Zeichencodes
StrReverse
Liefert die Kopie einer Zeichenfolge mit verkehrter Reihenfolge der Zeichen
Trim
Liefert Zeichenfolge ohne führende und abschließende Leerzeichen
UCase
Liefert die Kopie einer Zeichenfolge in Großschreibung
Val
Liefert den Zahlenwert einer Zeichenfolge
WeekdayName
Liefert für eine Zahl zwischen 1 und 7 den Wochentag als Zeichenfolge
Zeichenfolgenfunktionen und - prozeduren von Visual Basic
................................................... Warnung
Warnung
Eine notorische Ursache für Ungereimtheiten im Programmverhalten ist die auf die länderspezifische Zahlendarstellung (Gebietseinstellungen des Systems) zurückzuführende Punkt-/KommaProblematik im Zusammenhang mit Zeichenfolgen. Wer mit Ländereinstellung »Deutsch (Standard)« auf seinem System einen Zahlenwert als literale Zeichenfolge spezifiziert, muss darauf achten, das Komma als echtes Komma zu schreiben, während in »echten« numerischen Literalen der Punkt als Dezimalsymbol notiert werden muss.
Asc- , AscB- und AscW- Funktion Function Asc (s As String) As Integer Function AscB (s As String) As Integer Function AscW (s As String) As Integer
66
Chr- ,
ChrB-
und ChrW - Funktion
Beschreibung
................................................... Bes c hreibung
Die Funktion Asc liefert den Code des ersten Zeichens der Zeichenfolge s entsprechend dem auf dem System geltenden Zeichensatz als Ganzzahl. Die beiden anderen Varianten der Funktion liefern (ohne Rücksicht auf den geltenden Zeichensatz) den ANSI-Code des ersten Bytes der Zeichenfolge (AscB) bzw. den Unicode des ersten Doppel-Bytes der Zeichenfolge (AscW). Beispiel
................................................... Beis piel
Die Funktion StrToHex wandelt eine Zeichenfolge beliebiger Länge byteweise in eine hexadezimale Repräsentation der Form "hh hh ..." um.
Funktionen und Anweisungen für Zeichenfolgen
' Funktion wandelt beliebig lange Byte-Strings in Hex-String um Function StrToHex(sByteString As String) As String Dim i As Integer, iByte As Integer Dim sLow As String, sHigh As String For i = 1 To LenB(sByteString) ' byteweise analysieren iByte = AscB(MidB(sByteString, i, 1)) If iByte \ 16 > 9 Then ' Ziffer oder Buchstabe? sHigh = Chr(iByte \ 16 + 55) ' Buchstabe Else sHigh = Chr(iByte \ 16 + 48) ' Ziffer End If If iByte Mod 16 > 9 Then sLow = Chr(iByte Mod 16 + 55) Else sLow = Chr(iByte Mod 16 + 48) End If StrToHex = StrToHex + sHigh + sLow + " " ' Zusammensetzen Next i End Function Verwandte Befehle
................................................... Verwa ndte Befehle
Chr, Str Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
Chr- , ChrB- und ChrW- Funktion Function Chr (iANSICode As Integer) As String Function ChrB (iANSICode As Integer) As String Function ChrW (iUnicode As Integer) As String Beschreibung
................................................... Bes c hreibung
Die Funktion Chr liefert das Unicode-Zeichen zu einem ANSI-Code als Unicode-Zeichenfolge der Länge 1. ChrB liefert dagegen zu einem ANSI-Code das ANSI-Zeichen als ANSI-Zeichenfolge der Länge 1 und ChrW das Unicode-Zeichen zu einem Unicode als Unicode-Zeichenfolge der Länge 1.
67
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
................................................... Beis piel
Funktionen und Anweisungen für Zeichenfolgen
Die Funktion HexToStr ist die Umkehrfunktion zu der Funktion StrToHex (vgl. Beispiel zu Asc). Sie wandelt beliebig lange Hexadezimaldarstellungen der Form "hh hh ..." in Bytefolgen des Typs String um. Public Function HexToStr(sHexString As String) As String Dim i As Integer, iHigh As Integer, iLow As Integer Dim sHexChar As String Dim sLow As String, sHigh As String If LenB(" ") = Len(" ") Then ' Unicode-System? HexToStr = Space(Len(sHexString) / 3) Else HexToStr = Space(Len(sHexString) / 6) End If For i = 1 To Len(sHexString) Step 3 ' iHigh = Asc(Mid(sHexString, i, 1)) – 48 ' If iHigh > 15 Then iHigh = iHigh – 7 ' iLow = Asc(Mid(sHexString, i + 1, 1)) – 48 If iLow > 15 Then iLow = iLow – 7 MidB(HexToStr, (i + 2) \ 3) = ChrB(iHigh * Next i End Function
aus 3 Zeichen wird 1 Byte! Annahme: Ziffer War es etwa ein Buchstabe?
16 + iLow) ' Zusammensetzen
Verwandte Befehle
................................................... Verwa ndte Befehle
Asc, Str Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
Filter- Funktion Function Filter( _ StringPool() As String, _ SuchString As String, _ [bVorkommenLiefern As Boolean = True], _ [vgl As vbCompareMethod = vbBinaryCompare]) _ As String() Beschreibung
................................................... Bes c hreibung
Die Funktion Filter durchsucht die Elemente des Zeichenfolgenarrays StringPool nach dem Vorkommen der Zeichenfolge SuchString und liefert die entsprechenden Array-Elemente als Zeichenfolgenarray. Hat der optionale Parameter VorkommenLiefern den Wert True oder fehlt er, enthält das Ergebnisarray alle Elemente, die SuchString enthalten, andernfalls (False) alle Elemente, die SuchString nicht enthalten. Hat der optionale Parameter vgl den Wert vbBinaryCompare oder fehlt er, ist die Vergleichsoperation ein zeichenweiser Unicode-Vergleich; hat vgl den Wert vbTextCompare, legt die Funktion der Vergleichsoperation die standardmäßige Sortierordnung der für die auf dem System geltenden Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung.
68
Format- Funktion
Warnung
................................................... Wa rnung
Das Standardverhalten der Funktion bei fehlendem Parameter vgl kann sich durch eine Option Compare-Anweisung ändern. Beispiel
................................................... Beis piel
Das Programm benutzt die Funktion Filter, um herauszufinden, welche Wochentage (hierfür gilt die Ländereinstellung) ohne Unterscheidung der Großschreibung die Zeichenfolge "TAG" nicht enthalten.
Verwandte Befehle
................................................... Verwa ndte Befehle
Join, Split
Format- Funktion Function Format( _ vData, _ sFormat As String], _ [FirstDayOfWeek As VbFirstDayOfWeek = vbSunday], _ [FirstWeekOfYear As VbFirstWeekOfYear = vbFirstJan1]) _ As String Beschreibung
................................................... Bes c hreibung
Die Funktion Format liefert für den Wert vData eine formatierte Darstellung als Zeichenfolge. Fehlt der optionale Parameter sFormat, folgt die Darstellung den auf dem jeweiligen System geltenden Ländereinstellungen, und das Ergebnis entspricht bis auf das fehlende führende Leerzeichen bei der Darstellung positiver Zahlen dem von Str. Ansonsten drückt sFormat unter Beachtung der Syntax für Formatausdrücke ein benutzerdefiniertes Darstellungsformat aus. Die optionalen Parameter FirstDayOfWeek und FirstWeekOfYear beziehen sich auf exotische Formen der Datumsdarstellung und können im Allgemeinen getrost weggelassen werden. Anwendung
................................................... Anwendung
Für den Formatausdruck sFormat gelten folgende Regeln: 1. Der Formatausdruck kann den Namen eines benannten Formats enthalten. Die folgenden drei Tabellen geben einen Überblick über die benannten Formate.
69
Funktionen und Anweisungen für Zeichenfolgen
Private Sub Form_Load() Dim sWochenTage(7) As String, sErgebnis() As String AutoRedraw = True For i = 0 To 6 ' Wochentage generieren sWochenTage(i) = WeekdayName(i + 1) Next i sErgebnis = Filter(sWochenTage, "TAG", False, vbTextCompare) For i = 0 To UBound(sErgebnis) – 1 ' es kommt nur der Mittwoch Print sErgebnis(i) Next i End Sub
Funktionen und Anweisungen für Zeichenfolgen
Formatname
Beschreibung
Funktionen und Anweisungen für Zeichenfolgen
"General Date" Übliche Datums-/Zeitdarstellung mit zweistelliger Jahreszahl – bei Angabe von Datum und Zeit: 01.01.00 13:00:00; bei Angabe von Zeit: 13:00:00; bei Angabe von Datum: 01.01.00 "Long Date"
Ausgeschriebenes Datum, entsprechend der Systemeinstellungen: Samstag, 1. Januar 2000
"Medium Date"
Mittleres Datumsformat (von Host-Anwendung definierbar): 1. Jan. 00
"Short Date"
Kurzes Datum, entsprechend der Systemeinstellungen: 01.01.00
Benannte Datumsformate
Formatname
Beschreibung
"Long Time"
Zeitangabe enthält auch Sekunden: 13:00:00
"Medium Time"
Zeitangabe im 12-Stunden-Format, ohne Sekunden: 1:00
"Short Time"
Zeitangabe im 24-Stunden-Format, ohne Sekunden: 13:00
Benannte Zeitformate
Formatname
Beschreibung
"General Number"
Zahlen werden ohne Tausendertrennzeichen notiert.
"Currency"
Zahlen werden mit Tausendertrennzeichen und zwei Nachkommastellen sowie unter Beachtung der auf dem System geltenden Gebietsschema-Einstellungen notiert.
"Fixed"
Festkommadarstellung unter Beachtung der auf dem System geltenden Gebietsschema-Einstellungen, ohne Tausendertrennzeichen und gerundet auf zwei Stellen hinter dem Komma: 10001,34
"Standard"
Wie "Fixed", jedoch mit Tausendertrennzeichen: 10.001,34
"Percent"
Wie "Fixed", jedoch mit Faktor 100 multipliziert und angehängtem Prozentzeichen %
"Scientific"
Wissenschaftliches Standardformat mit einer Stelle vor dem Komma, zwei Stellen nach dem Komma und Zehnerpotenz: 1,00E34
"Yes/No"
Ausgabe von »Nein« anstatt 0, »Ja« für jeden anderen Wert
"True/False"
Ausgabe von »False« anstatt 0, »True« für jeden anderen Wert
"On/Off"
Ausgabe von »Aus« anstatt 0, »Ein« für jeden anderen Wert
Benannte Zahlenformate
2. Der Formatausdruck kann ein benutzerdefiniertes Format enthalten. Die folgende Tabelle gibt einen Überblick über die Bedeutung der Symbole, die für die Zusammenstellung benutzerdefinierter Formate eine feste Interpretation haben.
70
Format- Funktion
Bedeutung
0
Platzhalter für Ziffer (vor und nach dem Dezimalzeichen). Auch Platzhalter für Ganzzahlanteil vor dem Dezimalzeichen. Platzhalterpositionen, die die Dezimaldarstellung nicht bedient, erhalten das Füllzeichen 0. Das Format "0.000" für 1234,12 ergibt "1234,120" und das Format "000000" für 1234,12 ergibt "001234".
#
Wie Symbol 0, es gibt jedoch kein Füllzeichen
.
Platzhalter für Dezimalzeichen
%
Zahlenwert wird mit 100 multipliziert und als Prozentwert mit anhängendem Prozentzeichen % dargestellt. Das Format "0.000%" für 1234,12 ist "123412,000%".
,
Die Position dieses Zeichens im Formatausdruck ist ausschlaggebend für seine Bedeutung. Steht es zwischen zwei Ziffernplatzhaltern links vom Dezimalzeichenplatzhalter erfolgt die Darstellung mit Tausendertrennzeichen. Steht es dagegen links vom ersten Ziffernplatzhalter in einer Zahlendarstellung, erscheint es als gewöhnliches Komma. Steht es bei fehlendem Dezimalzeichenplatzhalter rechts vom letzten Ziffernplatzhalter oder unmittelbar links neben dem Dezimalzeichenplatzhalter, wird der Zahlenwert durch 1000 dividiert. So bewirkt "#," für 123.4123.456 die Darstellung "1234123" und "#,,.0" für 1234.887.654 die Darstellung "1234,9".
E- oder e-
Wissenschaftliche Darstellung ohne Ausgabe des Pluszeichens im Exponenten
E+ oder e+
Wissenschaftliche Darstellung mit Ausgabe des Pluszeichens im Exponenten
- + $ ( )
Diese Symbole stehen für sich selbst. Sie erscheinen als Zeichen. Alle anderen bedeutungsbeladenen Symbole müssen einen umgekehrten Schrägstrich vorangestellt bekommen, um sie als einfaches Zeichen darzustellen.
\
Dieses Symbol kann einem anderen bedeutungsbeladenen Symbol vorangestellt werden, um dieses als Zeichen darzustellen. "\\" bewirkt die Ausgabe des Symbols selbst als Zeichen. Um ein Anführungszeichen auszugeben, muss es doppelt und in Kombination mit diesem Symbol notiert werden. Die Zahl 30405 wird mit "#0\°##\'##\"" \N\o\r\d" zu "3°04'05"" Nord".
"Nord"
Zeigt die Zeichenfolge in Anführungszeichen an. Die Regeln für Zeichenfolgenliterale fordern die doppelte Notation von Anführungszeichen. Die Zahl 30405 wird mit "#0\°##\'##\"" ""Nord""" gleichfalls zu "3°04'05"" Nord".
Symbole für benutzerdefinierte Zahlenformate
Symbol
Bedeutung
:
Platzhalter für Zeittrennzeichen zwischen Stunden, Minuten und Sekunden
/
Platzhalter für Datumstrennzeichen zwischen Tagen, Monaten und Jahren
C
Zeigt Datumsanteil in der Form ddddd und Zeitanteil in der Form ttttt an
d
Tag erscheint als Zahl ohne führende Null (1 bis 31)
dd
Tag erscheint als Zahl mit führender Null (01 bis 31)
ddd
Tag erscheint als abgekürzter Wochentag (Mo bis So)
Symbole für benutzerdefinierte Datums- und Zeitformate
71
Funktionen und Anweisungen für Zeichenfolgen
Symbol
Funktionen und Anweisungen für Zeichenfolgen
Funktionen und Anweisungen für Zeichenfolgen
Symbol
Bedeutung
dddd
Tag erscheint als ausgeschriebener Wochentag (Montag bis Sonntag)
ddddd
Datum erscheint vollständig im kurzen Datumsformat (vgl. benanntes Format "Short Date")
dddddd
Datum erscheint vollständig im langen Datumsformat (vgl. benanntes Format "Long Date")
w
Wochentag erscheint als Zahl ohne führende Null (1 bis 7)
ww
Woche erscheint als Kalenderwoche (1 bis 54)
m
Monat erscheint als Zahl ohne führende Null (1 bis 12)
mm
Monat erscheint als Zahl mit führender Null (01 bis 12)
mmm
Monat erscheint als abgekürzter Monatsname (Jan bis Dez)
mmmm
Monat erscheint als ausgeschriebener Monatsname (Januar bis Dezember)
q
Quartal erscheint als Zahl (1 bis 4)
y
Kalendertag erscheint als Zahl (1 bis 366)
yy
Jahr erscheint als zweistellige Zahl (00 bis 99)
yyyy
Jahr erscheint als vierstellige Zahl (100 bis 9999)
h
Stunde erscheint als Zahl ohne führende Null (0 bis 23)
hh
Stunde erscheint als Zahl mit führender Null (00 bis 23)
n
Minute erscheint als Zahl ohne führende Null (0 bis 59)
nn
Minute erscheint als Zahl mit führender Null (00 bis 59)
s
Sekunde erscheint als Zahl ohne führende Null (0 bis 59)
ss
Sekunde erscheint als Zahl mit führender Null (00 bis 59)
ttttt
Zeit erscheint als vollständiges langes Zeitformat mit Stunden, Minuten und Sekunden (vgl. benanntes Format "Long Time")
AM/PM
Zeit erscheint im 12-Stunden-Format mit Anhang »AM« für Stunden zwischen 0 und 12 und mit Anhang »PM« für Stunden zwischen 13 und 23. Das amerikanische Zeitformat ist somit "hh.nn.ss AM/PM".
am/pm
Wie AM/PM, jedoch mit kleingeschriebenem Anhang »am« bzw. »pm»
Symbole für benutzerdefinierte Datums- und Zeitformate
Symbol
Bedeutung
@
Platzhalter für alphanumerisches Zeichen; Füllzeichen ist das Leerzeichen
&
Platzhalter für alphanumerisches Zeichen; kein Füllzeichen
<
Erzwingt Kleinschreibung
>
Erzwingt Großschreibung
!
Erzwingt Auswertung der Platzhalter von links nach rechts (standardmäßig werden Platzhalter von rechts nach links ausgewertet)
Symbole für benutzerdefinierte Zeichenfolgenformate
72
FormatCurrency- Funktion
Warnung
................................................... Wa rnung
Leider ist die Format-Funktion von Visual Basic 6.0 nicht fehlersicher implementiert, und liefert im Zusammenhang mit der Print-Anweisung gerne mal den obskuren Fehler 480, »Anwendungs- oder objektdefinierter Fehler«, wenn der Formatausdruck syntaktisch nicht korrekt ist oder einfach nicht zum Typ oder Wert von vData passt. Da dieser Fehler danach selbst bei Angabe korrekter Argumente nicht mehr weg zu bekommen ist, hilft in diesem Fall nur ein Neustart von Visual Basic. Beispiel
................................................... Beis piel
' Projekt FormatDemo Private Sub Form_Load() Const cJahr = 2001 ' Jahr Const cHalbjahr = 2 AutoRedraw = True For iMonat = 1 To 6 ' erstes Halbjahr Dat = DateSerial(cJahr, iMonat + (cHalbjahr – 1) * 6, 1) Print Format(Dat, "mmmm yyyy") Print "Kal.-Woche", For i = 0 To 6 ' Wochentage ausgeben Print Format(Dat + i, "dddd"), Next Print ' Anzahl der Tage in Monat berechnen Tage = Day(DateSerial(Year(Dat), Month(Dat) + 1, Day(Dat) – 1)) For i = 1 To Tage ' Kalenderwoche und Tage ausgeben If (i – 1) Mod 7 = 0 Then Print Format(Dat + i – 1, "ww"), Print Format(i, "00"), If i Mod 7 = 0 Then Print Next Print Next End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
FormatCurrency, FormatDateTime, FormatNumber, FormatPercent, Str Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
FormatCurrency- Funktion Function FormatCurrency( _ vData, _ [NachkommaStellen As Long = -1], _ [NullVorKommaErgänzen As VbTriState = vbUseDefault], _ [WennNegativKlammernSetzen As VbTriState = vbUseDefault], _ [TausenderTrennzVerwenden As VbTriState = vbUseDefault]) _ As String
73
Funktionen und Anweisungen für Zeichenfolgen
Das Projekt FormatDemo gibt einen Halbjahreskalender auf einem gewöhnlichen Formular aus:
Funktionen und Anweisungen für Zeichenfolgen
Beschreibung
................................................... Bes c hreibung
Die Funktion FormatCurrency ist eine spezialisierte Variante der Funktion Format. Sie liefert unter Verwendung der in der Systemsteuerung definierten Währung eine als Währungswert formatierte Zeichenfolge. Mittels der vier optionalen Parameter lassen sich Vorgaben für die Anzahl der Nachkommastellen, die Ergänzung einer führenden Null bei Werten kleiner eins, die Klammerung negativer Zahlen sowie die Ergänzung eines Tausendertrennzeichens treffen. Beispiel
Funktionen und Anweisungen für Zeichenfolgen
................................................... Beis piel
' Ausgabe: "(-14.345,13 DM)" Print FormatCurrency(-14345.1253, , , vbTrue) ' Ausgabe: "-14345,125 DM" Print FormatCurrency(-14345.1253, 3, vbFalse, vbFalse, vbFalse) Verwandte Befehle
................................................... Verwa ndte Befehle
Format, FormatDateTime, FormatNumber, FormatPercent, Str, CStr Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
FormatDateTime- Funktion Function FormatDateTime( _ vData, _ BenanntesFormat As VbDateTimeFormat = vbGeneralDate]) _ As String Beschreibung
................................................... Bes c hreibung
Die Funktion FormatDateTime ist eine spezialisierte Variante der Funktion Format. Sie liefert unter Verwendung des in der Systemsteuerung definierten Datums- und Zeitformats eine als Datums- und/oder Zeitangabe formatierte Zeichenfolge. Mittels des optionalen Parameters BenanntesFormat lässt sich das zu verwendende Format vorgeben. Zur Auswahl stehen je ein kurzes und ein langes Format für Zeitangaben und Datumsangaben. Beispiel
................................................... Beis piel
Print FormatDateTime(14345.1223, vbShortTime) ' Ausgabe: "02:56" Print FormatDateTime(14345.1223, vbLongTime) ' Ausgabe: "02:56:07" Print FormatDateTime(14345.1223, vbShortDate) ' Ausgabe: "10.4.39" ' Ausgabe: "Montag, 10 April 1939" Print FormatDateTime(14345.1223, vbLongDate) ' Ausgabe: "10.4.39 02:56:07" Print FormatDateTime(14345.1223, vbGeneralDate) Print FormatDateTime(14345.1223) ' Ausgabe: "10.4.39 02:56:07" Verwandte Befehle
................................................... Verwa ndte Befehle
Format, FormatCurrency, FormatNumber, FormatPercent, Str
74
FormatNumber- Funktion
Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
FormatNumber- Funktion
Beschreibung
................................................... Bes c hreibung
Die Funktion FormatNumber ist eine spezialisierte Variante der Funktion Format. Sie liefert eine Zahlendarstellung in Form einer Zeichenfolge. Der einzige Unterschied zu FormatCurrency besteht darin, dass die Funktion ihre Darstellung ohne Währungssymbol vornimmt. Mittels der fünf optionalen Parameter lassen sich Vorgaben für die Anzahl der Nachkommastellen, die Ergänzung einer führenden Null bei Werten kleiner eins, die Klammerung negativer Zahlen sowie die Ergänzung eines Tausendertrennzeichens treffen. Beispiel
................................................... Beis piel
Print FormatNumber(-143.1253) ' Ausgabe:"-143,13" Print FormatNumber(-143.1253, 3, , vbTrue) ' Ausgabe:"(143,125)" Print FormatNumber(-143.1253, 0, vbFalse, vbFalse) ' Ausgabe:"-143)" Verwandte Befehle
................................................... Verwa ndte Befehle
Format, FormatCurrency, FormatDateTime, FormatNumber, Str Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
FormatPercent- Funktion Function FormatPercent( _ vData, _ [NachkommaStellen As Long = -1], _ [NullVorKommaErgänzen As VbTriState = vbUseDefault], _ [WennNegativKlammernSetzen As VbTriState = vbUseDefault], _ [TausenderTrennzVerwenden As VbTriState = vbUseDefault], _ [ZiffernGruppieren As VbTriState = vbUseDefault)] _ As String Beschreibung
................................................... Bes c hreibung
Die Funktion FormatPercent ist eine spezialisierte Variante der Funktion Format. Sie multipliziert vData mit 100 und liefert das Ergebnis als Prozentangabe mit Prozentzeichen in Form einer Zeichenfolge. Mittels der fünf optionalen Parameter lassen sich Vorgaben für die Anzahl der Nachkommastellen, die Ergänzung einer führenden Null bei Werten kleiner eins, die Klammerung negativer Zahlen sowie die Ergänzung eines Tausendertrennzeichens treffen.
75
Funktionen und Anweisungen für Zeichenfolgen
Function FormatNumber( _ vData, _ [NachkommaStellen As Long = -1], _ [NullVorKommaErgänzen As VbTriState = vbUseDefault], _ [WennNegativKlammernSetzen As VbTriState = vbUseDefault], _ [TausenderTrennzVerwenden As VbTriState = vbUseDefault]) _ [ZiffernGruppieren As VbTriState = vbUseDefault)] _ As String
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
................................................... Beis piel
Print FormatPercent(-143.1253) ' Ausgabe: "-14.312,53%" Print FormatPercent(-143.1253, , , vbTrue) ' Ausgabe: "(14.312,53%)" Print FormatPercent(-143.1253, 0, vbFalse, vbFalse) 'Ausgabe:"-14.313%)" Verwandte Befehle
................................................... Verwa ndte Befehle
Format, FormatCurrency, FormatDateTime, FormatNumber, Str
Funktionen und Anweisungen für Zeichenfolgen
Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
Hex- Funktion Function Hex(vZahl) As String Beschreibung
................................................... Bes c hreibung
Die Funktion Hex interpretiert den Wert vZahl als Ganzzahl und liefert deren hexadezimale Repräsentation als Zeichenfolge. Die Darstellung enthält nicht mehr Stellen als nötig, mithin also keine führenden Nullen oder Leerzeichen. Beispiel
................................................... Beis piel
Print Hex(255) ' Ausgabe: "FF" lWert = 10 Print "&H" Right("0000000"+Hex(lWert) , 8) ' Ausgabe: "&H0000000A" Verwandte Befehle
................................................... Verwa ndte Befehle
Oct
InStr- und InStrB- Funktion Function InStr( [lStart As Long = 1,] _ sDurchsuchterString As String, _ sSuchString As String,_ [vgl As VbCompareMethode = vbBinaryCompare]) _ As Long Function InStrB( [lStart As Long = 1,] _ sDurchsuchterANSIString As String, _ sANSISuchString As String,_ [vgl As VbCompareMethode = vbBinaryCompare]) _ As Long Beschreibung
................................................... Bes c hreibung
Die Funktion InStr durchsucht die Zeichenfolge sDurchsuchterString ab der Zeichenposition lStart (optional mit Vorgabewert 1) nach dem nächsten Vorkommen der Zeichenfolge sSuchString. Ist die Suche erfolgreich, liefert die Funktion ihre Startposition in der durchsuchten Zeichenfolge, ansonsten den Wert 0. Hat der optionale Parameter vgl den Wert vbBinary-
76
InStrRev- Funktion
Compare oder fehlt er, ist die Vergleichsoperation ein zeichenweiser Unicode-Vergleich; hat vgl den Wert vbTextCompare, legt die Funktion der Vergleichsoperation die standardmäßige Sortierordnung der für die auf dem System geltenden Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung. Die Variante InStrB dieser Funktion ist für Zeichenfolgen im ANSI-Code zuständig. Hinweis
................................................... Hinweis
Warnung
................................................... Wa rnung
Das Standardverhalten der Funktion bei fehlendem Parameter vgl kann sich durch eine Option Compare-Anweisung ändern. Beispiel
................................................... Beis piel
Der folgende Code zählt mittels der Zählvariablen iCount, wie oft die Zeichenfolge s1 innerhalb der Zeichenfolge s2 vorkommt. iCount = 0 lPos = 0 Do lPos = InStr(lPos + 1, s1, s2) If lPos Then iCount = iCount +1 Loop While lPos ... ' iCount enthält nun die Anzahl der Vorkommen Verwandte Befehle
................................................... Verwa ndte Befehle
Filter, InStrRev, StrComp
InStrRev- Funktion Function InStrRev( sDurchsuchterString As String, _ sSuchString As String,_ [lStart As Long = -1,] _ [vgl As VbCompareMethod = vbBinaryCompare]) _ As Long Beschreibung
................................................... Bes c hreibung
Die Funktion InStrRev vollbringt die gleiche Aufgabe wie InStr, mit dem feinen Unterschied, dass sie die Zeichenfolge sDurchsuchterString ab der Zeichenposition lStart (optional, mit Vorgabewert -1) rückwärts, also von rechts nach links, durchsucht. Hat der optionale Parameter vgl den Wert vbBinaryCompare oder fehlt er, ist die Vergleichsoperation ein zeichenweiser Unicode-Vergleich; hat vgl den Wert vbTextCompare, legt die Funktion der Vergleichsoperation die standardmäßige Sortierordnung der für die auf dem System geltenden Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung.
77
Funktionen und Anweisungen für Zeichenfolgen
Die mit Visual Basic 6.0 vorliegende Implementation dieser Funktion hat kein Problem damit, wenn Start größer ist als die Länge der durchsuchten Zeichenfolge. Negative Werte sowie ein Wert von 0 führen dagegen zu einem Laufzeitfehler.
Funktionen und Anweisungen für Zeichenfolgen
Hinweis
................................................... Hinweis Die mit Visual Basic 6.0 vorliegende Implementation dieser Funktion hat kein Problem damit, wenn lStart größer ist als die Länge der durchsuchten Zeichenfolge. Werte kleiner gleich 0 (außer dem Sonderwert -1) führen dagegen zu einem Laufzeitfehler. Warnung
................................................... Wa rnung
Das Standardverhalten der Funktion bei fehlendem Parameter vgl kann sich durch eine Option Compare-Anweisung ändern.
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
................................................... Beis piel
Der folgende Code zählt mittels der Zählvariablen iCount, wie oft die Zeichenfolge s1 innerhalb der Zeichenfolge s2 vorkommt. iCount = 0 lPos = -1 Do lPos = InStrRev(s1, s2, lPos) – 1 If lPos >= 0 Then iCount = iCount + 1 Loop While lPos > 0 ... ' iCount enthält nun die Anzahl der Vorkommen Verwandte Befehle
................................................... Verwa ndte Befehle
Filter, InStr, StrComp
J oin- Funktion Function Join( _ StringArray() As String, _ [TrennZeichen As String] = " ") _ As String Beschreibung
................................................... Bes c hreibung
Die Funktion Join ist die Umkehrfunktion zu Split. Sie verkettet die Elemente des Zeichenfolgenarrays StringArray zu einer einzelnen Zeichenfolge und liefert diese zurück. Fehlt der optionale Parameter TrennZeichen, fügt die Funktion zwischen den Elementen ein Leerzeichen ein. Durch Angabe eines Werts lassen sich auch andere Trennzeichenfolgen vorgeben, so etwa die leere Zeichenfolge "", das Tabulatorzeichen vbTab oder Zeilenvorschübe vbCrLf. Beispiel
................................................... Beis piel
Das Projekt JoinDemo initialisiert ein Zeichenfolgenarray mit den Namen der Wochentage und gibt das Ergebnis des nachfolgenden Join-Aufrufs aus: ' Projekt: JoinDemo Private Sub Form_Load() Dim sWochenTage(7) As String, sErgebnis() As String AutoRedraw = True For i = 0 To 6 ' Wochentage generieren sWochenTage(i) = WeekdayName(i + 1) Next i Print Join(sWochenTage, vbCrLf) End Sub
78
LCase- Funktion
Verwandte Befehle
................................................... Verwa ndte Befehle
Filter, Split
LCase- Funktion Function LCase(s As String) As String Beschreibung
................................................... Bes c hreibung
Beispiel
................................................... Beis piel
if LCase(sTest1) = LCase(sTest2) Then
' Schreibweise egal
Verwandte Befehle
................................................... Verwa ndte Befehle
UCase
Left- und LeftB- Funktion Function Left(sUnicode As String, lZeichenAnz As Long) As String Function LeftB(sANSI As String, lZeichenAnz As Long) As String Beschreibung
................................................... Bes c hreibung
Die Funktion Left liefert die ersten lZeichenAnz Zeichen der Zeichenfolge sUnicode als Unicode-Zeichenfolge und die Funktion LeftB die ersten lZeichenAnz Bytes der Zeichenfolge sANSI als ANSI-Zeichenfolge. Ist der Wert von lZeichenAnz größer oder gleich der Länge der Zeichenfolge, gibt die Funktion die vollständige Zeichenfolge zurück. Mit 0 als Wert für lZeichenAnz gibt die Funktion die leere Zeichenfolge zurück. Beispiel
................................................... Beis piel
Die folgende Ausgabeanweisung gibt die Zeichenfolge s linksbündig in einem Feld aus. Ist die Länge der Zeichenfolge s kleiner als 8, werden von rechts her Leerzeichen ergänzt (linksbündige Prokrustes-Zuweisung, vgl. auch »LSet-Anweisung«, S. 80). Const cFeldBreite = 8 Print Left(s + Space(cFeldBreite), cFeldBreite) Verwandte Befehle
................................................... Verwa ndte Befehle
Right, RightB, Mid, MidB, LTrim, RTrim, Trim
Len- und LenB- Funktion Function Len(sUnicode As String) As Long Function LenB(Var As Type) As Long Beschreibung
................................................... Bes c hreibung
Die Funktion Len liefert die Anzahl der Zeichen in der Zeichenfolge sUnicode. Die leere Zeichenfolge Null hat die Länge 0. Die Funktion LenB gibt die Anzahl der Bytes zurück, die zum Speichern des Werts von Var benötigt werden.
79
Funktionen und Anweisungen für Zeichenfolgen
Die Funktion LCase liefert eine Kopie der im Parameter s übergebenen Zeichenfolge in Kleinschreibung zurück. Null wird wieder als Null zurückgegeben.
Funktionen und Anweisungen für Zeichenfolgen
Anwendung
................................................... Anwendung
Wie es die Beschreibung bereits vermuten lässt, verbirgt sich hinter der Funktion LenB so etwas wie der »Längenoperator« der Sprache Visual Basic, den Sie benutzen können, wann immer Sie wissen wollen, wie viele Bytes für die Repräsentation eines bestimmten Werts von einem bestimmten Datentyp erforderlich sind. Achtung jedoch, die Längenangaben von Zeichenfolgen enthalten nicht den Längenbedarf des Deskriptors (vgl. auch »Get-Anweisung«, S. 140). Auf Arrays lässt sich diese Funktion gar nicht anwenden. Beispiel
Funktionen und Anweisungen für Zeichenfolgen
................................................... Beis piel
Siehe Beispiel zu »Chr-, ChrB- und ChrW-Funktion« (S. 67) Verwandte Befehle
................................................... Verwa ndte Befehle
VarType
LSet- Anweisung LSet sString1 = sString2 LSet bdtVar = bdtWert Beschreibung
................................................... Bes c hreibung
Die Anweisung LSet nimmt eine linksbündige Prokrustes-Zuweisung für Zeichenfolgen und benutzerdefinierte Datentypen vor. Auf Zeichenfolgen angewendet, überträgt sie den Wert von sString2 linksbündig in die Variable sString1, ohne deren Länge anzupassen. Dabei wird der Wert von sString2 gegebenenfalls zurechtgestutzt oder um Leerzeichen ergänzt (vgl. Beispiel in »Left- und LeftB-Funktion«, S. 79). Auf benutzerdefinierte Datentypen angewendet, überträgt LSet den Wert bdtWert Byte-weise und linksbündig in die Variable bdtVar, ohne deren Länge anzupassen. Ist bdtWert kürzer als der Wert, den bdtVar erwartet, ergänzt die Anweisung Nullbytes, ist er länger, wird zurechtgestutzt. Anwendung
................................................... Anwendung
Der ursprüngliche Sinn dieser Anweisung war die Bereitstellung einer blockorientierten Zuweisungsoperation für zusammengesetzte bzw. benutzerdefinierte Datentypen. Solche Werte lassen sich im Rahmen einer gewöhnlichen Let-Zuweisung en bloc nämlich nicht mehr übertragen. Ein sehr wichtiger Einsatzbereich von LSet ist daher die Überführung traditionell via Get oder Input gelesener Datensätze in Datensatzvariablen mit benutzerdefinierter Struktur bzw. die Vorbereitung von Datensatzvariablen für die Put-Operation. Aus diesem Grund ist die Typüberprüfung, die Visual Basic LSet angedeihen lässt, nicht sehr rigide. Warnung und Tipp
................................................... Wa rnung
»Nachtigall, ick hör dir trapsen«. Ja, mit LSet lassen sich auf dem Umweg über benutzerdefinierte Datentypen implizite Typumwandlungen ausführen, wie das Beispiel zu diesem Befehl zeigt. Von einer ernsthaften Anwendung im Zusammenhang mit disparaten Datentypen, die über eine Analyse von Repräsentationen bestimmter Datentypen oder Werte hinausgeht, ist jedoch abzuraten, da für gewöhnlich nicht klar ist, welche Speicherausrichtung die Felder benutzerdefinierter Datentypen vom Compiler erhalten.
80
LTrim- Funktion
Beispiel
................................................... Beis piel
Wer die Speicherdarstellung eines spezifischen Werts zu Gesicht bekommen will, muss schon ein wenig tricksen, um der rigiden Typkontrolle von Visual Basic zu entrinnen. Der folgende Code benutzt die als Beispiel zu Chr vorgestellte Funktion StrToHex, um die hexadezimale Repräsentation eines Double-Werts nach einer LSet-Zuweisung zu erhalten. Beachten Sie bei der Interpretation der Hexadezimaldarstellung, dass Intel-Prozessoren mit verkehrter Bytereihenfolge arbeiten und in einem aus mehreren Bytes bestehenden Wert das erste Byte das niederwertige Byte ist. erster benutzerdefinierter Typ
zweiter benutzerdefinierter Typ
bdt2 wie sieht die Repräsentation dieses Werts aus? Zuweisung unter Umgehung der Typprüfung Ausgabe der hexadezimalen Darstellung
Verwandte Befehle
................................................... Verwa ndte Befehle
Get, Let, Put, RSet Verwandte Themen
................................................... Verwandte Them en
Typumwandlung (S. 57)
LTrim- Funktion Function LTrim(s As String) As String Beschreibung
................................................... Bes c hreibung
Die Funktion liefert eine Kopie der Zeichenfolge s zurück, die keine führenden Leerzeichen mehr enthält. Beispiel
................................................... Beis piel
Dim i As Integer i = 121 Print LTrim(Str(i))
' schneidet Leerstelle für Vorzeichen ab
Verwandte Befehle
................................................... Verwa ndte Befehle
RTrim, Trim
Mid- und MidB- Funktion Function Mid(sUnicode As String, lStart As Long _ [, lAnz As Long]) As String Function MidB(sANSI As String, lStart As Long _ [, lAnz As Long]) As String
81
Funktionen und Anweisungen für Zeichenfolgen
Private Type bdt1 ' f As Double End Type Private Type bdt2 ' s As String * 4 End Type Private Sub Form_Load() AutoRedraw = True Dim bt1 As bdt1, bt2 As bt1.f = 2.234E-23 ' LSet bt2 = bt1 ' Print StrToHex(bt2.s) ' End Sub
Funktionen und Anweisungen für Zeichenfolgen
Beschreibung
................................................... Bes c hreibung
Die Funktion Mid liefert lAnz Zeichen der Zeichenfolge sUnicode ab der Position lStart als Unicode-Zeichenfolge zurück. In gleicher Weise liefert die MidB-Funktion lAnz Bytes der Zeichenfolge sANSI ab der Byteposition lStart als Zeichenfolge. Fehlt der optionale Parameter lAnz, liefern beide Funktionen den gesamten Rest der Zeichenfolge ab der Position lStart. Beispiel
................................................... Beis piel
Funktionen und Anweisungen für Zeichenfolgen
Vgl. die Beispiele in »Chr-, ChrB- und ChrW-Funktion« (S. 67) und »Asc-, AscB- und AscW-Funktion« (S. 66).
Mid- und MidB- Anweisung Mid s, lStart [, lAnz] = sErsatz MidB s, lStart [, lAnz] = sErsatz Beschreibung
................................................... Bes c hreibung
Die Mid-Zuweisung kopiert die ersten lAnz Zeichen der Zeichenfolge sErsatz in die Zeichenfolge s ab Position lStart. Ist lAnz größer als die Länge von sErsatz oder fehlt lAnz, wird die gesamte Zeichenfolge sErsatz kopiert. MidB unterscheidet sich von Mid nur darin, dass sie lAnz als Byteanzahl interpretiert und Byte-weise kopiert. Beispiel
................................................... Beis piel
Siehe Beispiel zu »Chr-, ChrB- und ChrW-Funktion« (S. 67) Verwandte Befehle
................................................... Verwa ndte Befehle
Left, LeftB, Right, RightB, LTrim, RTrim, Trim
MonthName- Funktion Function MonthName(lMonat As Long[, bAbk As Boolean = False]) As String Beschreibung
................................................... Bes c hreibung
Die Funktion MonthName liefert den zur Monatszahl lMonat gehörigen Monatsnamen als Zeichenfolge. Hat der optionale Parameter bAbk den Wert False oder fehlt er, gibt die Funktion den vollen Namen zurück, ansonsten seine Abkürzung (drei Buchstaben). Monatszahlen, die nicht zwischen 1 und 12 liegen, führen zu einem Laufzeitfehler. Beispiel
................................................... Beis piel
Print MonthName(Month(Date))
' Name aktueller Monat, ausgeschrieben
Verwandte Befehle
................................................... Verwa ndte Befehle
WeekdayName
Oct- Funktion Function Oct(vOctWert) As Double
82
Option Compare- Anweisung
Beschreibung
................................................... Bes c hreibung
Die Funktion Oct zählt wie Hex nur mittelbar zu den Typumwandlungsfunktionen. Während Hex die hexadezimale Notation seines als Ganzzahl interpretierten Arguments als Zeichenfolge liefert, liefert Oct dessen oktale Notation. Anwendung
................................................... Anwendung
Die Umwandlung in das oktale Zahlensystem mittels Oct findet heutzutage eher selten Anwendung. Sie ist ein Relikt aus vergangenen Zeiten, als das hexadezimale Zahlensystem im Computerbereich noch nicht die alles dominierende Rolle spielte.
................................................... Beis piel
Print Oct(77) Print Oct(&o1234)
' 64+8+5 = "115" ' Oktales Literal: "1234"
Verwandte Befehle
................................................... Verwa ndte Befehle
Hex
Option Compare- Anweisung Option Compare Binary Option Compare Text Beschreibung
................................................... Bes c hreibung
Die Anweisung Option Compare legt fest, welche Art von Zeichenfolgenvergleich bestimmte Zeichenfolgenfunktionen laut Vorgabe (das heißt ohne Angabe des jeweiligen optionalen Parameters) durchführen. Der Vergleichsart Binary liegt ein schlichter Vergleich der binären Repräsentation (zeichenweiser Unicode-Vergleich), der Vergleichsart Text dagegen die standardmäßige Sortierordnung der für die auf dem System geltende Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung. Diese Anweisung darf in einem Modul nicht mehrfach gegeben werden, das heißt, sie gilt immer für das gesamte Modul und muss auf Modulebene stehen. Fehlt die Anweisung, gilt für das jeweilige Modul die Voreinstellung Binary. Eine Option Compare-Anweisung wirkt sich auf die Zeichenfolgenoperatoren <, >, <=, >=, = und <> aus. Weiterhin kann sie sich bei Fehlen des entsprechenden optionalen Parameters auch auf die Funktionen: Filter, InStr, InStrB, InStrRev, Replace, Split, StrComp auswirken. Beispiel
................................................... Beis piel
Option Compare Text ... Print (StrComp("ö", "u", vbBinaryCompare) = -1) = ("ö" < "ü") ' Ausgabe: Falsch
aber Option Compare Binary ' Standardvergleichsart ... Print (StrComp("ö", "u", vbBinaryCompare) = -1) = ("ö" < "ü") ' Ausgabe: Wahr
83
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
Funktionen und Anweisungen für Zeichenfolgen
Verwandte Befehle
................................................... Verwa ndte Befehle
Option Base, Option Explicit, Option Private
Funktionen und Anweisungen für Zeichenfolgen
Replace- Funktion Function Replace( _ sDurchsuchterString As String, _ sSuchString As String,_ sErsatzString As String,_ [lStart As Long = 1], _ [lAnz As Long = -1], [vgl As VbCompareMethode = vbBinaryCompare]) _ As Long Beschreibung
................................................... Bes c hreibung
Die Funktion Replace durchsucht die Zeichenfolge sDurchsuchterString ab der Zeichenposition lStart nach maximal lAnz Vorkommen der Zeichenfolge sSuchString und liefert eine Kopie von sDurchsuchterString ab der Zeichenposition lStart, in der all diese Vorkommen gegen die Zeichenfolge sErsatzString ersetzt sind. Fehlt der optionale Parameter lStart, beginnt die Kopie beim ersten Zeichen. Fehlt der Parameter lAnz, ersetzt die Funktion beliebig viele Vorkommen von sSuchString. Hat der optionale Parameter vgl den Wert vbBinaryCompare oder fehlt er, ist die Vergleichsoperation ein zeichenweiser Unicode-Vergleich; hat vgl den Wert vbTextCompare, legt die Funktion der Vergleichsoperation die standardmäßige Sortierordnung der für die auf dem System geltenden Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung. Hinweis
................................................... Hinweis Die mit Visual Basic 6.0 vorliegende Implementation dieser Funktion hat kein Problem damit, wenn Start größer ist als die Länge der durchsuchten Zeichenfolge; negative Werte sowie ein Wert von 0 führen dagegen zu einem Laufzeitfehler. Warnung
................................................... Wa rnung
Das Standardverhalten der Funktion bei fehlendem Parameter vgl kann sich durch eine Option Compare-Anweisung ändern. Beispiel
................................................... Beis piel
Dim s Print Print Print Print
As String Replace("12222223", Replace("12222223", Replace("12222223", Replace("abbbbbbc",
"22", "22", "22", "BB",
"3") "3", 2, 2) "3", 2 ,0) "C", 2, , vbTextCompare)
Vergleiche auch das Beispiel zu »Print #« (S. 151). Verwandte Befehle
................................................... Verwa ndte Befehle
Filter, InStr, StrComp
84
' ' ' '
"13333" "33223" "2222223" "CCCc"
Partion- Funktion
Partion- Funktion Function Partition(Number As Long, Start As Long, Stop As Long, _ Interval As Long) As String Beschreibung
................................................... Bes c hreibung
Anwendung
................................................... Anwendung
Der Einsatzbereich dieser ziemlich spezialisierten Funktion liegt hauptsächlich im Bereich der Datenbankprogrammierung, wo sie für die Berechnung der Datensatzgruppierung verwendbar ist. Beispiel
................................................... Beis piel
Print Print Print Print
Partition(1, 2, 100, 23) Partition(24, 2, 100, 23) Partition(25, 2, 100, 23) Partition(101, 2, 100, 23)
' ' ' '
Ausgabe: Ausgabe: Ausgabe: Ausgabe:
": 2" "2: 24" "25: 47" "101: "
Right- und RightB- Funktion Function Right(sUnicode As String, lZeichenAnz As Long) As String Function RightB(sANSI As String, lZeichenAnz As Long) As String Beschreibung
................................................... Bes c hreibung
Die Funktion Right liefert die letzten lZeichenAnz Zeichen der Zeichenfolge sUnicode als Unicode-Zeichenfolge und die Funktion RightB die letzten lZeichenAnz Bytes der Zeichenfolge sANSI als ANSI-Zeichenfolge. Ist der Wert von lZeichenAnz größer oder gleich der Länge der Zeichenfolge, gibt die Funktion die vollständige Zeichenfolge zurück. Mit 0 als Wert für lZeichenAnz gibt die Funktion die leere Zeichenfolge Null zurück. Beispiel
................................................... Beis piel
Die folgende Ausgabeanweisung gibt die Zeichenfolge s rechtsbündig in einem Feld aus. Ist die Länge der Zeichenfolge s kleiner als 8, werden von links her Leerzeichen ergänzt (rechtsbündige Prokrustes-Zuweisung, vgl. auch »RSet-Anweisung«, S. 86). Const cFeldBreite = 8 Print Right(Space(cFeldBreite) + s , cFeldBreite) Verwandte Befehle
................................................... Verwa ndte Befehle
Right, RightB, Mid, MidB, LTrim, RTrim, Trim
85
Funktionen und Anweisungen für Zeichenfolgen
Die Funktion Partition ordnet eine gegebene Zahl Number in das zugehörige Intervall einer Intervallfolge ein und liefert dann eine Beschreibung des Intervalls in der Form »UntereGrenze: ObereGrenze«. Die Intervallfolge ist über Start (untere Grenze des ersten Intervalls), Stop (obere Grenze des letzten Intervall) und Interval (Breite der einzelnen Intervalle in der Folge) definiert und enthält die halboffenen (nach oben offen) Intervalle, die sich durch wiederholte Addition der Intervalllänge zum Startwert ergeben. Ist Number kleiner als Start, beschreibt die Funktion das Intervall in der Form: »: UntereGrenze », ist Number größer als Stop, in der Form: »ObereGrenze: «.
Funktionen und Anweisungen für Zeichenfolgen
RSet- Anweisung RSet sString1 = sString2 Beschreibung
................................................... Bes c hreibung
Die Anweisung RSet nimmt eine rechtsbündige Prokrustes-Zuweisung für Zeichenfolgen vor, das heißt, sie kopiert den Wert von sString2 rechtsbündig in die Variable sString1, ohne deren Länge anzupassen. Dabei wird der Wert von sString2 gegebenenfalls vorne zurechtgestutzt oder um Leerzeichen ergänzt.
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
................................................... Beis piel
Dim s As String * 20 RSet s = FormatCurrency(vWert, 2) Verwandte Befehle
................................................... Verwa ndte Befehle
Get, Let, LSet, Put
RTrim- Funktion Function RTrim(s As String) As String Beschreibung
................................................... Bes c hreibung
Die Funktion liefert eine Kopie der Zeichenfolge s zurück, die keine Leerzeichen am Ende enthält. Beispiel
................................................... Beis piel
Dim sFix As String * 100 Dim sVariable As String sFix = "Literaler Wert" ' Prokrustes-Zuweisung sVariable = sFix Print RTrim(sVariable) Verwandte Befehle
................................................... Verwa ndte Befehle
LTrim, Trim
Space- Funktion Function Space(lAnz As Long) As String Beschreibung
................................................... Bes c hreibung
Die Funktion Space liefert eine Unicode-Zeichenfolge der Länge lAnz, die mit Leerzeichen gefüllt ist. Beispiel
................................................... Beis piel
Siehe die Beispiele zu »Chr-, ChrB- und ChrW-Funktion« (S. 67), »Left- und LeftB-Funktion« (S. 79 ) und »Right- und RightB-Funktion« (S. 85). Verwandte Befehle
................................................... Verwa ndte Befehle
LTrim, RTrim
86
Split- Funktion
Split- Funktion Function Split(_ sKombination As String, _ [sTrennzeichen As String = " "], _ [lAnz As Long = -1], _ [vgl As vbCompareMethod = vbBinaryCompare]) _ As String() Beschreibung
................................................... Bes c hreibung
Warnung
................................................... Wa rnung
Das Standardverhalten der Funktion bei fehlendem Parameter vgl kann sich durch eine Option Compare-Anweisung ändern. Beispiel
................................................... Beis piel
cVornamen = "Audra, Petra, Jennifer, Maria, Magdalena" Dim sVornamen() As String sVornamen = Split(cVornamen, ", ") For i = 0 To UBound(sVornamen) ' zeilenweise ausgeben Print sVornamen(i) Next i Print cVornamen = Join(sVornamen, ", ") ' Ausgabe: Wahr Verwandte Befehle
................................................... Verwa ndte Befehle
Filter, Join
Str- Funktion Function Str(lZahl As Long) As String Function Str(dZahl As Double) As String Beschreibung
................................................... Bes c hreibung
Die Funktion Str liefert den Wert von lZahl bzw. dZahl als Unicode-Zeichenfolge im standardmäßigen amerikanischen Zahlenformat. Warnung
................................................... Wa rnung
Leider ist die Str-Funktion von Visual Basic 6.0 nicht fehlersicher implementiert und liefert im Zusammenhang mit der Print-Anweisung gerne mal den Fehler 480, wenn dZahl als literaler Wert angegeben wird. Da dieser Fehler danach selbst bei Angabe korrekter Argumente nicht mehr weg zu bekommen ist, hilft in diesem Fall nur ein Neustart von Visual Basic.
87
Funktionen und Anweisungen für Zeichenfolgen
Als Umkehrfunktion zu Join unterteilt die Funktion Split die Zeichenfolge sKombination in mehrere Zeichenfolgen und gibt diese als Zeichenfolgenarray zurück. Fehlt der optionale Parameter sTrennzeichen, wertet die Funktion standardmäßig jedes erscheinende Leerzeichen als Trennzeichen zwischen zwei Zeichenfolgen, ansonsten den Wert von sTrennzeichen. Fehlt der optionale Parameter lAnz, nimmt die Funktion so viele Unterteilungen vor, wie sie Trennzeichen findet, ansonsten nicht mehr als lAnz. Hat der optionale Parameter vgl den Wert vbBinaryCompare oder fehlt er, ist die Vergleichsoperation ein zeichenweiser Unicode-Vergleich; hat vgl den Wert vbTextCompare, legt die Funktion der Vergleichsoperation die standardmäßige Sortierordnung der für die auf dem System geltenden Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung.
Funktionen und Anweisungen für Zeichenfolgen
Wird die Funktion mit einer literalen Zeichenfolge bzw. einer Konstante als Argument aufgerufen, verwandelt Visual Basic die Zeichenfolge zunächst implizit in eine Zahl vom Typ Long oder Double, um mit Str daraus wieder eine Zeichenfolge zu machen. In Systemen mit deutschem Zahlenformat (Ländereinstellungen) passiert dabei dummerweise Folgendes: Print Str("1234,1234") Print Str(Str("1234,1234"))
' Ausgabe: 1234,1234 ' Ausgabe: 12341234
Fehler, die aus dieser Ungereimtheit heraus entstehen, sind meist recht schwer zu finden (vgl. auch Variableninitialisierung, S. 168).
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
................................................... Beis piel
Der folgende Code geht von einem Formular mit zwei Textfeldern namens Text1 und Text2 aus und übersetzt Eingaben in die Standardnotation. Private Sub Text1_Change() Text2 = Str(Val(Text1)) End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
Val, Round
StrComp- Funktion Function StrComp( _ s1 As String, _ s2 As String, _ [vgl As vbCompareMethod = vbBinaryCompare]) _ As Integer Beschreibung
................................................... Bes c hreibung
Die Funktion StrComp unterzieht die beiden Zeichenfolgen s1 und s2 einer Vergleichsoperation und unterscheidet dabei die vier in der folgenden Tabelle aufgelisteten Fälle. Hat der optionale Parameter vgl den Wert vbBinaryCompare oder fehlt er, ist die Vergleichsoperation ein zeichenweiser Unicode-Vergleich; hat vgl den Wert vbTextCompare, legt die Funktion der Vergleichsoperation die standardmäßige Sortierordnung der für die auf dem System geltenden Landessprache zugrunde – ohne Unterscheidung der Groß- und Kleinschreibung. Funktionswert
Ergebnis des Vergleichs (hängt von Vergleichsoperation ab)
-1
s1 ist »kleiner als« s2
1
s1 ist »größer als« s2
0
s1 ist »gleich« s2
Null
Einer der beiden Vergleichswerte ist Null
Warnung
................................................... Wa rnung
Das Standardverhalten der Funktion bei fehlendem Parameter vgl kann sich durch eine Option Compare-Anweisung ändern.
88
StrConv- Funktion
Beispiel
................................................... Beis piel
Print StrComp("Blöd", "Blut") ' Ausgabe: 1 Print StrComp("Blöd", "Blut", vbTextCompare) ' Ausgabe: -1 Print StrComp("BlOnD", "blond", vbTextCompare) ' Ausgabe: 0 Verwandte Befehle
................................................... Verwa ndte Befehle
Option Compare, <, > =
Function StrConv( _ s As String, _ KonvSchema As VbStrConv, _ [lGebietsschemaID As Long) _ As String Beschreibung
................................................... Bes c hreibung
Die Funktion StrComp liefert eine konvertierte Variante der Zeichenfolge s. Der Wert von KonvSchema (siehe Tabelle) bestimmt, welches Konversionsschema die Funktion der Konversion zugrunde legt. Bestimmte Konversionen sind allerdings nur möglich, wenn im System ein entsprechendes Gebietsschema eingestellt oder im optionalen Parameter lGebietsschemaID spezifiziert ist. Wert für KonvSchema
Verwendetes Konversionsschema
vbUpperCase (1)
Umwandlung in Großschreibung
vbLowerCase (2)
Umwandlung in Kleinschreibung
vbProperCase (3)
Umwandlung in gemischte Groß-/Kleinschreibung, Wortanfang groß, Rest klein
vbWide (4)
Umwandlung von Ein-Byte-Zeichen in Zwei-Byte-Zeichen (DBCS)
vbNarrow (8)
Umwandlung von Zwei-Byte-Zeichen (DBCS) in Ein-Byte-Zeichen
vbKatakana (16)
Umwandlung Hiragana-Zeichen in Katagana-Zeichen
vbHiragana (32)
Umwandlung Katagana-Zeichen in Hiragana-Zeichen
vbUnicode (64)
Umwandlung von systemspezifischem ANSI-Zeichensatz in Unicode unter Verwendung der Zeichenumsetzungstabelle des Systems
vbFromUnicode (128)
Umwandlung von Unicode in systemspezifischen ANSI-Zeichensatz unter Verwendung der Zeichenumsetzungstabelle des Systems
Hinweis
................................................... Hinweis Sie können die in der Tabelle genannten Konstanten für KonvSchema auch kombinieren. Allerdings hängen die sinnvollen Kombinationsmöglichkeiten stark vom geltenden Gebietsschema ab. Der Wert vbUnicode + vbProperCase bewirkt beispielsweise die Umwandlung einer ANSIZeichenfolge in Unicode mit gemischter Groß-/Kleinschreibung. Folgende Zeichen wertet die Funktion als Trennzeichen zwischen Wörtern: Chr(0), Chr(9), Chr(10), Chr(11), Chr(12), Chr(13), Chr(32) – das gilt aber nicht für alle Gebietsschemata.
89
Funktionen und Anweisungen für Zeichenfolgen
StrConv- Funktion
Funktionen und Anweisungen für Zeichenfolgen
Beispiel
................................................... Beis piel
LSET s = StrConv(s, vbFromUnicode) ' ANSI-String für Ausgabe vorbereiten Print StrConv(s1, vbUnicode + vbProperCase) Verwandte Befehle
................................................... Verwa ndte Befehle
Chr, CStr
Funktionen und Anweisungen für Zeichenfolgen
String- Funktion Function String(lAnz As Long, iANSI As Integer) As String Function String(lAnz As Long, sVorgabe As String) As String Beschreibung
................................................... Bes c hreibung
Die Funktion String gibt es in zwei unterschiedlichen Varianten. Beide Varianten liefern eine Unicode-Zeichenfolge der Länge lAnz, die mit einem einzelnen Zeichen aufgefüllt ist. Für die erste Variante wird das Zeichen als ANSI-Code iANSI spezifiziert. Ist iANSI größer als 255, bildet die Funktion den Wert mittels einer Restwertdivision in das Intervall zwischen 0 und 255 ab. Die zweite Variante von String arbeitet mit beliebigen Unicode-Zeichen. In dieser Syntax verwendet die Funktion das erste Unicode-Zeichen der Zeichenfolge sVorgabe. Beispiel
................................................... Beis piel
Print StrToHex(String(2, 300)) ' Ausgabe: "2C 00 2C 00" Print StrToHex(String(2, ChrW(300))) ' Ausgabe: "2C 01 2C 01" Verwandte Befehle
................................................... Verwa ndte Befehle
LTrim, RTrim
StrReverse- Funktion Function StrReverse(s As String) As String Beschreibung
................................................... Bes c hreibung
Die Funktion StrReverse liefert eine Zeichenfolge, in der alle Zeichen der Zeichenfolge s in umgekehrter Reihenfolge enthalten sind. Bei Aufruf mit einer leeren Zeichenfolge ist das Ergebnis des Funktionsaufrufs gleichfalls eine leere Zeichenfolge. Ein Aufruf der Funktion mit Null führt dagegen zu einem Laufzeitfehler. Beispiel
................................................... Beis piel
Print StrReverse("ABCD")
' Ausgabe: "DCBA"
Trim- Funktion Function Trim(s As String) As String Beschreibung
................................................... Bes c hreibung
Die Funktion liefert eine Kopie der Zeichenfolge s zurück, die weder am Anfang noch am Ende Leerzeichen enthält.
90
UCase- Funktion
Beispiel
................................................... Beis piel
Print RTrim(LTrim(" Test ")) = Trim(" Test ") ' Gibt "Wahr" aus Verwandte Befehle
................................................... Verwa ndte Befehle
LTrim, RTrim
UCase- Funktion Function UCase(s As String) As String
................................................... Bes c hreibung
Die Funktion UCase liefert eine Kopie der im Parameter s übergebenen Zeichenfolge in Großschreibung zurück. Die leere Zeichenfolge Null wird wieder als Null zurückgegeben. Beispiel
................................................... Beis piel
If UCase(sTest1) = UCase(sTest2) Then
' Schreibweise egal
Verwandte Befehle
................................................... Verwa ndte Befehle
LCase
Val- Funktion Function Val(sZahl As String) As Double Beschreibung
................................................... Bes c hreibung
Die Funktion Val ist die Umkehrfunktion zu Str. Sie interpretiert die Zeichenfolge sZahl als Zahl in Standardnotation (mit Dezimalpunkt, nicht mit Dezimalkomma, da die Funktion keine Ländereinstellungen berücksichtigt) und liefert den Wert dieser Zahl. Anwendung
................................................... Anwendung
Val liefert auch einen Zahlenwert als Ergebnis, wenn sZahl mit einer Ziffernfolge beginnt und danach Zeichen folgen, die nichts mehr mit der Zahlendarstellung zu tun haben – so macht Val aus »12.34 Abfahrt Hamburg HBF« den Wert 12.34, aus »12,34 Abfahrt Hamburg HBF« jedoch 12. Um festzustellen, ob ein Wert vollständig als Zahl ausgewertet werden kann, steht die Boolean-Funktion IsNumeric zur Verfügung – sie liefert für beide Beispielzeichenfolgen False. Warnung
................................................... Wa rnung
Anders als die anderen Zeichenfolgenfunktionen arbeitet Val nicht mit der länderspezifischen Zahlendarstellung und will einen Punkt als Dezimalsymbol sehen. Dennoch ergeben sich im Zusammenspiel mit Str »seltsame Effekte«: Print Print Print Print
Val("10,1") Val("10.1") Str(10.1) Val(Str(10.1))
' ' ' '
Ausgabe: Ausgabe: Ausgabe: Ausgabe:
10 10,1 "10,1" 10,1 (seltsam,nicht?)
91
Funktionen und Anweisungen für Zeichenfolgen
Beschreibung
Mathematische und finanzmathematische Funktionen und Anweisungen
Beispiel
................................................... Beis piel
Private Sub Text1_Change() Text2.Text = Sqr(Val(Text1.Text)) End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
Mathematische und finanzmathematische Funktionen und Anweisungen
LCase
WeekdayName- Funktion Function WeekdayName( _ lTag As Long, _ [bAbk As Boolean = False], _ [FirstDayOfWeek As VbFirstDayOfWeek = vbUseSystemDayOfWeek]) _ As String Beschreibung
................................................... Bes c hreibung
Die Funktion WeekdayName liefert den zur Tageszahl lTag gehörigen Wochentag als Zeichenfolge. Hat der optionale Parameter bAbk den Wert False oder fehlt er, gibt die Funktion den vollen Namen zurück, ansonsten seine Abkürzung (zwei Buchstaben). Über den optionalen Parameter FirstDayOfWeek lässt sich zudem vorgeben, mit welchem Wochentag die Zählung beginnen soll. Fehlt er, beginnt die Zählung mit dem im System festgelegten Tag, und das ist der Montag. Tageszahlen, die nicht zwischen 1 und 7 liegen, führen zu einem Laufzeitfehler. Beispiel
................................................... Beis piel
Print WeekdayName(Weekday(Date))
' aktueller Wochentag ausgeschrieben
Verwandte Befehle
................................................... Verwa ndte Befehle
MonthName
Mathematische und finanzmathematische Funktionen und Anweisungen Wenn bei den Zeichenfolgen zuvor die Rede davon war, dass die Manipulation derselben schon immer eine der ureigensten Domänen der Programmiersprache Basic war, dann sollte das nicht etwa heißen, dass die Sprache in puncto Mathematik wenig zu bieten habe. Auch für die Formulierung mathematischer und numerischer Problematiken war die Sprache für sich genommen immer schon recht reichhaltig ausgestattet. Insbesondere bot die weitgehend interaktive Programmentwicklung eine enorme Flexibilität bei der Programmierung von On-the-fly-Anwendungen für die Lösung minder komplexer Problematiken, die nicht auf das überlegene Laufzeitverhalten von Compilersprachen angewiesen waren. Als problematisch erwiesen sich allerdings die fehlenden Mittel für eine geeignete Modularisierung und eine Anbindung an bereits bestehende mathematische Bibliotheken. Was die Modularisierbarkeit von Code betrifft, so hat sich Basic mit Visual Basic inzwischen zu einer wahrlich vorbildlichen Programmiersprache entwickelt. Die Möglichkeiten der Anbindung an bestehende mathematische Bibliotheken sind aber nach wie vor eher als lau einzustufen, da solche Bibliotheken (sofern sind nicht in Visual Basic selbst, als ActiveX-Bibliotheken
92
Mathematische und finanzmathematische Funktionen und Anweisungen
Bezeichner
Kurzbeschreibung
Abs
Liefert den Absolutwert (vorzeichenlosen Wert) einer Zahl
Atn
Liefert den Arcustangens einer Zahl als Winkel im Bogenmaß
Cos
Liefert den Cosinus zu einem Winkel im Bogenmaß
DDB
Liefert den Abschreibungswert eines Vermögenswerts über einen bestimmten Zeitraum bei geometrisch degressiver Abschreibung
Exp
Liefert den Wert der Exponentialfunktion (mit Basis e) zu einer Zahl
Fix
Liefert den Vorkommaanteil einer Dezimalzahl als Ganzzahl
FV
Liefert den künftigen Wert einer Annuität (Ansparung oder Kredit) bei konstanter Zahlung, konstantem Zins und fester Laufzeit
Int
Liefert den nächsten ganzzahligen Wert kleiner oder gleich einer Zahl
IPmt
Liefert den Zinsanteil für eine bestimmte Periode bei Abzahlung oder Ansparung mit konstanten Raten und konstantem Zinssatz
IRR
Liefert den internen Ertragssatz für eine Folge regelmäßiger Ein- und Auszahlungen
Log
Liefert den natürlichen Logarithmus einer Zahl
MIRR
Liefert den modifizierten internen Ertragssatz für eine Folge regelmäßiger, mit unterschiedlichen Zinssätzen behafteten Ein- und Auszahlungen
NPer
Liefert die Anzahl der Zeiträume für eine Annuität (Ansparung oder Kredit) bei konstanter Zahlung und konstantem Zins
NPV
Liefert den Nettobarwert einer Investition bei regelmäßigen Aus- und Einzahlungen und konstantem Diskontsatz
Pmt
Liefert den Auszahlungswert (Höhe der Rate bei Kredit) für eine Annuität mit einer festen Anzahl von Zeiträumen, konstanter Zahlung und konstantem Zins
PPmt
Liefert den Kapitalanteil (bei Kredit: Tilgung) eines bestimmten Zeitraums für eine Annuität (Ansparung oder Kredit) mit einer festen Anzahl von Zeiträumen, konstanter Zahlung und konstantem Zins
Mathematische und finanzmathematische Funktionen und Anweisungen
93
Mathematische und finanzmathematische Funktionen und Anweisungen
oder in C implementiert sind, und das sind Bibliotheken aus dem Bereich der Numerischen Mathematik auch heutzutage noch eher nicht, weil da immer noch FORTRAN herumgeistert) von ihrem Aufrufmodell her meist nicht kompatibel sind. Auch wenn es Visual Basic wohl nicht mehr zur lingua franca der numerischen Mathematik bringen wird, ihre mathematische und auch finanzmathematische Grundausstattung ist reichhaltig genug für die meisten Fragestellungen im naturwissenschaftlichen, wirtschaftlichen und informationstechnologischen Bereich, und es spricht inzwischen absolut nichts mehr gegen die Entwicklung eigener mathematischer Bibliotheken als solide Basis für künftige Projekte. Bei einer solchen Bibliothek kann es sich um eine Klassenbibliothek für abstrakte Datentypen handeln, so etwa für die Vektor- und Matrizenrechnung, oder um ein gewöhnliches Bibliotheksmodul, das spezifische Funktionen und Prozeduren etwa für den Bereich Statistik bereitstellt. Nichtsdestoweniger bleibt jede eigene Implementation von Datentypen und Operationen auf das mathematische Inventar der Sprache selbst angewiesen. Die folgende Tabelle gibt einen Überblick über die mathematischen und finanzmathematischen Funktionen und Anweisungen von Visual Basic.
Mathematische und finanzmathematische Funktionen und Anweisungen
Mathematische und finanzmathematische Funktionen und Anweisungen
Bezeichner
Kurzbeschreibung
PV
Liefert den Barwert für eine Annuität (Ansparung oder Kredit) bei konstanter Zahlung, konstantem Zins und fester Laufzeit
Randomize
Initialisiert den Zufallsgenerator mit einem Startwert
Rate
Liefert den Zinssatz zu einer Annuität (Anzahlung oder Kredit) mit einer festen Anzahl von Zeiträumen, konstanter Zahlung und konstantem Zins
Rnd
Liefert eine gleich verteilte Zufallszahl zwischen 0 und 1
Round
Liefert den Wert einer Zahl auf eine bestimmte Dezimalstelle gerundet
Sgn
Liefert das Vorzeichen eines Werts als Faktor (-1, 0 oder 1)
Sin
Liefert den Sinus zu einem Winkel im Bogenmaß
SLN
Liefert den periodischen Abschreibungswert eines Vermögenswerts bei linearer Abschreibung über einen bestimmten Zeitraum
Sqr
Liefert die Quadratwurzel eines positiven Zahlenwerts
SYD
Liefert den Abschreibungswert eines Vermögenswerts für eine bestimmte Periode nach dem Modell der Jahressummengewichtung
Tan
Liefert den Tangens zu einem Winkel im Bogenmaß
Mathematische und finanzmathematische Funktionen und Anweisungen Warnung
................................................... Wa rnung
Die mit Visual Basic 6 (SP3) vorliegende Implementation der finanzmathematischen Funktionen ist alles andere als fehlersicher. So erhält man in nicht klar zu bestimmenden Situationen oder bei Angabe falscher Parameterwerte gerne mal den lästigen Laufzeitfehler 480, »Anwendungsoder objektdefinierter Fehler«, den man im Lauf der aktuellen Visual-Basic-Sitzung nicht mehr los wird – selbst bei Angabe korrekter Parameterwerte. In diesem Fall hilft nur noch ein Neustart von Visual Basic. Tipp
................................................... Tipp
Aufgrund der internen Darstellung gewöhnlicher Zahlenwerte im hexadezimalen Format kommt es bei verschiedenen Funktionen zu Rundungsfehlern, die gerade im finanzmathematischen Bereich, aber auch anderswo für peinliche Fehler (so genannte »Pfennigfuchser-Fehler«) im Bereich der letzten Nachkommastelle sorgen können. Sie vermeiden solche Fehler, indem Sie für Währungsbeträge konsequent den Datentyp Currency und für dezimale Berechnungen mit nachfolgenden Rundungsoperationen den Datentyp Decimal einsetzen. Gegebenenfalls erforderliche Typumwandlungen nimmt Visual Basic dann implizit vor.
Abs- Funktion Function Abs(dZahl As Double) As Double Beschreibung
................................................... Bes c hreibung
Die Funktion Abs liefert den Absolutwert zu der Zahl dZahl, das heißt den Zahlenwert mit positivem Vorzeichen.
94
Atn- Funktion
Beispiel
................................................... Beis piel
DeltaX = Abs(MouseX – X) DeltaY = Abs(MouseY – Y) Verwandte Befehle
................................................... Verwa ndte Befehle
Sgn
Atn- Funktion Beschreibung
................................................... Bes c hreibung
Die zu den trigonometrischen Umkehrfunktionen zählende Arcustangensfunktion Atn ist die Umkehrfunktion der Tangensfunktion (Tan). Sie liefert den Arcustangens zu der Zahl d als Winkel im Bogenmaß. Das Ergebnis der Funktion liegt immer im offenen Intervall ]-π/2; π/2[. Für die Umwandlung in Grad ist der Wert mit 180/π = 57,2957795130823 zu multiplizieren. Anwendung
................................................... Anwendung
Diese Funktion berechnet den Winkel zwischen Hypothenuse und Ankathete eines rechtwinkligen Dreiecks, wenn deren Längen bekannt sind, bzw. den zu einem Tangenswert (Steigung) gehörigen Winkel. Tipp
................................................... Tipp
Da Visual Basic die Zahl π nicht als Konstante kennt, muss ein anderer Weg gefunden werden, an ihren Wert zu kommen. Ein sehr eleganter Weg ist die Berechnung des Werts über die Funktion Atn. Dim Pi As Double Pi = Atn(1) * 4
' 3.14159265358979
Beispiel
................................................... Beis piel
Print Atn(1)
' Ausgabe: 0,785398163397448
Verwandte Befehle
................................................... Verwa ndte Befehle
Cos, Sin, Tan
Cos- Funktion Function Cos(dWinkel As Double) As Double Beschreibung
................................................... Bes c hreibung
Die zu den trigonometrischen Funktionen zählende Cosinusfunktion Cos liefert den Cosinus zu dem im Bogenmaß angegebenen Winkel dWinkel. Das Ergebnis der Funktion liegt immer im Intervall [-1; 1]. Für die Umwandlung eines Gradwerts in das Bogenmaß ist der Wert mit π/180 = 1,74532925199433E-02 zu multiplizieren. Anwendung
................................................... Anwendung
Diese Funktion berechnet aus dem Winkel zwischen Ankathete und Hypothenuse die Ankathete eines rechtwinkligen Dreiecks mit Hypothenuse 1.
95
Mathematische und finanzmathematische Funktionen und Anweisungen
Function Atn(d As Double) As Double
Mathematische und finanzmathematische Funktionen und Anweisungen
Beispiel
................................................... Beis piel
Dim Pi As Double Pi = Atn(1) * 4 Print Cos(Pi / 3)
' 3.14159265358979 ' Ausgabe: 0,5
Verwandte Befehle
................................................... Verwa ndte Befehle
Mathematische und finanzmathematische Funktionen und Anweisungen
Atn, Sin, Tan
DDB- Funktion Function DDB( _ dKosten As Double, _ dRestwert As Double, _ dNutzungsDauer As Double, _ dPeriode As Double, _ [vFaktor As Variant = 2]) _ As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion DDB ermöglicht die Berechnung der Abschreibung einer Investition dKosten mit dem Restwert dRestwert nach der angenommenen Nutzungsdauer dNutzungsDauer für eine bestimmte Periode dPeriode. Fehlt der optionale Parameter vFaktor oder hat er den Wert 2, berechnet die Funktion den Abschreibungswert nach der geometrisch degressiven Methode, ansonsten mit der gleichen Formel, jedoch mit vFaktor als Degressionsfaktor. Anwendung
................................................... Anwendung
dNutzungsDauer und dPeriode muss die gleiche Einheit (Monate oder Jahre) zugrunde liegen. Diese Funktion berücksichtigt den Parameter dRestwert nur insofern, als sie 0 zurückliefert, wenn der Restwert für eine Periode bereits erreicht ist. Mit anderen Worten, die Funktion rechnet nicht mit der üblichen Formel ( Wert(Periode) – Restwert ) ⋅ Faktor DDB = -----------------------------------------------------------------------------------------------Nutzungszeit sondern nach der schlichteren Formel Wert(Periode) ⋅ Faktor DDB = ------------------------------------------------------------Nutzungszeit Das kann zwar verwirren, gestattet aber einen Test, nach wie vielen Perioden eine Investition einen bestimmten Restwert erreicht hat. Beispiel
................................................... Beis piel
Das folgende Codefragment zeigt, wie sich ein Wert von 10.000 € bei Abschreibung nach der geometrisch degressiven Methode und einer Laufzeit von 10 Jahren entwickelt: Laufzeit = 10 AnschaffungsWert = 10000 RestWert = 2000 For Per = 1 to Laufzeit – 1 Print DDB(AnschaffungsWert, RestWert, Laufzeit, Per) Next
96
Exp- Funktion
Verwandte Befehle
................................................... Verwa ndte Befehle
SLN, SYD
Exp- Funktion Function Exp(dZahl As Double) As Double Beschreibung
................................................... Bes c hreibung
Beispiel
................................................... Beis piel
Print Exp(1) Print Exp(Log(10))
' Ausgabe: 2,71828182845905 ' Ausgabe: 10
Verwandte Befehle
................................................... Verwa ndte Befehle
Log
Fix- Funktion Function Fix(dZahl As NumTyp) As NumTyp Beschreibung
................................................... Bes c hreibung
Die Rundungsfunktion Fix liefert den Ganzzahlanteil von dZahl, indem sie alle Nachkommastellen abschneidet. Sie weist damit die gleiche Funktionalität wie CInt auf. Im Gegensatz zu CInt richtet die Funktion den Datentyp des Rückgabewerts aber nach dem Datentyp des Parameters. Warnung
................................................... Wa rnung
Wie das Beispiel zeigt, ist die Dezimalrechnung mit den Datentypen Single und Double nicht immer exakt. Das liegt daran, dass die Repräsentation dieser Werte intern im hexadezimalen bzw. echten binären Zahlenformat erfolgt und viele endliche Dezimalbrüche im binären Zahlensystem nur als unendliche Binärbrüche darstellbar sind. Wenn Sie Exaktheit benötigen, müssen Sie mit einem der Datentypen Currency oder Decimal rechnen! Beispiel
................................................... Beis piel
a = 27.003 Print Fix(a) Print (a – Fix(a))
' Ausgabe: 27 ' Ausgabe: 3,00000000000011E-03
Dim b As Variant b = CDec(a) Print Fix(b) Print (b – Fix(b))
' Ausgabe: 27 ' Ausgabe: 0,003
Verwandte Befehle
................................................... Verwa ndte Befehle
CInt, Int, Round
97
Mathematische und finanzmathematische Funktionen und Anweisungen
Die Wachstumsfunktion Exp ist die Umkehrfunktion zur natürlichen Logarithmusfunktion Log. Sie liefert den Wert der Eulerschen Konstante (2,71828182845905) hoch dZahl.
Mathematische und finanzmathematische Funktionen und Anweisungen
FV- Funktion Function FV( _ dZins As Double, _ dLaufzeit As Double, _ dRate As Double, _ [vJetztWert], _ [vTermin]) _ As Double
Mathematische und finanzmathematische Funktionen und Anweisungen
Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion FV liefert den zukünftigen Wert einer Annuität mit einer Laufzeit von dLaufzeit Zahlungsperioden, konstantem Zins dZins und der Rate dRate. Der optionale Parameter vJetztWert ermöglicht die Angabe eines Ausgangswerts bei bereits erfolgter Ansparung. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Anwendung
................................................... Anwendung
Beachten Sie, dass die Werte für die Parameter dZins und dLaufzeit auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Funktion lässt sich sowohl zur Berechnung von Krediten als auch von Ansparungen verwenden, wird aber vorzugsweise für die Kreditberechnung eingesetzt, da der zukünftige Wert bei Ansparungen meist einen Ausgangswert darstellt. Bei der Kreditberechnung sind dRate und dJetztWert als negative Werte anzugeben, bei der Ansparberechnung als positive Werte. Tipp
................................................... Tipp
Die Funktionen PV und FV liefern mit vertauschten Vorzeichen für dRate und dJetztWert die gleichen Ergebnisse. Beispiel
................................................... Beis piel
Das folgende Codefragment zeigt, wie sich eine Ansparung mit einer monatlichen Rate von 100 € und einem Zinssatz von 10% p.a. mit und ohne eine Starteinlage von 10.000 € über zehn Jahre hin entwickelt: Laufzeit = 10 * 12 MonatsRate = 100 Zins = 0.1 / 12 Starteinlage = 10000 Print FV(Zins, Monatsrate, Laufzeit) ' -18619,84 Print FV(Zins, Monatsrate, Laufzeit, Starteinlage) ' -41550,28
Das gleiche als Kredit: Laufzeit = 10 * 12 MonatsRate = -100 Zins = 0.1 / 12 Starteinlage = -10000
98
Int- Funktion
Print FV(Zins, Monatsrate, Laufzeit) Print FV(Zins, Monatsrate, Laufzeit, Starteinlage)
' 8120,14 ' 12481,15
Verwandte Befehle
................................................... Verwa ndte Befehle
IPmt, IRR, NPer, NPV, Pmt, PPmt, PV
Int- Funktion Function Int(dZahl As NumTyp) As NumTyp Beschreibung
Die Rundungsfunktion Int liefert die nächste Ganzzahl kleiner gleich dZahl. Im Gegensatz zu Fix schneidet die Funktion nicht nur die Nachkommastellen ab, sondern rundet echt. Die Funktion richtet den Datentyp des Rückgabewerts nach dem Datentyp des Parameters. Warnung
................................................... Wa rnung
Wie das Beispiel zeigt, ist die Dezimalrechnung mit den Datentypen Single und Double nicht immer exakt. Das liegt daran, dass die Repräsentation dieser Werte intern im hexadezimalen bzw. echten binären Zahlenformat erfolgt und viele endliche Dezimalbrüche im binären Zahlensystem nur als unendliche Binärbrüche darstellbar sind. Wenn Sie Exaktheit benötigen, müssen Sie mit einem der Datentypen Currency oder Decimal rechnen. Beispiel
................................................... Beis piel
a = -27.002 Print Int(a) Print (a – Int(a))
' Ausgabe: -28 ' Ausgabe: 0,998000000000001
Dim b As Variant b = CDec(a) Print Int(b) Print (b – Int(b))
' Ausgabe: -28 ' Ausgabe: 0,998
Verwandte Befehle
................................................... Verwa ndte Befehle
CInt, Fix, Round
IPmt- Funktion Function IPmt( _ dZins As Double, _ dPeriode As Double, _ dLaufzeit As Double, _ dBarwert As Double, _ [vZukünftigerWert], _ [vTermin]) _ As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion IPmt (engl.: Interest Payment) liefert den Zinsanteil in der Periode dPeriode zu einer Annuität mit einer Laufzeit von dLaufzeit Zahlungsperioden, konstantem Zins dZins und dem Barwert dBarwert (vgl. »PV-Funktion«,
99
Mathematische und finanzmathematische Funktionen und Anweisungen
................................................... Bes c hreibung
Mathematische und finanzmathematische Funktionen und Anweisungen
S. 106). Der optionale Parameter vZukünftigerWert (vgl. »FV-Funktion«, S. 98) ermöglicht die Angabe eines zukünftigen Werts, der den nach der letzten Zahlung erreichten Kontostand angibt. Bei einem Kredit ist dieser Wert im Allgemeinen mit 0 anzugeben, was dem Vorgabewert für den Parameter entspricht. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Anwendung
Mathematische und finanzmathematische Funktionen und Anweisungen
................................................... Anwendung
Beachten Sie, dass die Werte für die Parameter dZins, dPeriode und dLaufzeit auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Funktion wird im Allgemeinen zur Berechnung von Krediten verwendet. Für die Kreditberechnung setzen Sie dBarwert auf die Höhe des Kredits (Zahlungsausgang) und vZukünftigerWert auf 0 (Kredit abbezahlt). Tipp
................................................... Tipp
Die Funktion PPmt liefert den Tilgungs- bzw. Kapitalanteil. Die Summe aus Tilgungs- bzw. Kapitalanteil und Zins entspricht der von der Funktion Pmt gelieferten Rate. Beispiel
................................................... Beis piel
Das Projekt ZinsAnteil zeigt, wie sich Zins und Tilgung prozentual für einen Kredit beliebiger Höhe bei einem Zinssatz von 10% p.a. über zehn Jahre hin entwickeln. ' Projekt: Annuität-Zinsanteil Const Laufzeit = 10 * 12 Const Zins = 0.1 / 12 Const mRate = 100
' 100 Prozent(!)
Private Sub Form_Load() AutoRedraw = True BarWert = PV(Zins, Laufzeit, mRate) ' Barwert in Prozent (!) ' Kreditmodalitäten Print "Laufzeit", Laufzeit; "Monate" Print "Zins p.a.", Zins * 12 * 100; "%" Print "Periode", "Zinsanteil (%)", "Tilgungsanteil (%)" Print String(40, "=") ' prozentualen Zins- und Tilgungsanteil ausgeben. For i = 1 To Laufzeit Step 12 Print i, Round(IPmt(Zins, i, Laufzeit, BarWert), 2), Print Round(PPmt(Zins, i, Laufzeit, BarWert), 2) Next i End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
FV, NPer, NPV, Pmt, PPmt, PV
IRR- Funktion Function IRR(dWerte() As Double[, vErwartet As Variant = 0.1)] As Double
1 00
Log- Funktion
Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion IRR (engl.: Internal Rate of Return) liefert den internen Ertragssatz für eine via dWerte() spezifizierte Folge regelmäßiger Ein- und Auszahlungen (Cash Flows). Fehlt der optionale Parameter vErwartet, rechnet die Funktion mit dem Erwartungswert 0,1, ansonsten mit dem angegebenen Wert. Anwendung
................................................... Anwendung
Beispiel
................................................... Beis piel
Das folgende Codefragment zeigt beispielhaft, wie die Analyse eines Unternehmens aussehen kann: Dim dWerte(9) As Double dWerte(0) = -50000 dWerte(1) = -25000 dWerte(2) = 0 dWerte(3) = 5000 dWerte(4) = -1000 dWerte(5) = 7000 dWerte(6) = 21000 dWerte(7) = 45000 dWerte(8) = 60000 dWerte(9) = 110000 Print Round(IRR(dWerte) * 100, 2)
' ' ' ' ' ' ' ' ' ' '
Investition bei Gründung Unternehmensaufbau Break Even Erster Gewinn im vierten Jahr Verlust wg. schwacher Konjunktur Gewinn im sechsten Jahr Gewinn im siebten Jahr Gewinn im achten Jahr Gewinn im neunten Jahr Gewinn im zehnten Jahr 17,32 Prozent
Verwandte Befehle
................................................... Verwa ndte Befehle
MIRR, Rate
Log- Funktion Function Log(dZahl As Double) As Double Beschreibung
................................................... Bes c hreibung
Die natürliche Logarithmusfunktion Log ist die Umkehrfunktion zur Wachstumsfunktion Exp. Sie liefert den Wert, mit dem man die Eulersche Konstante (2,71828182845905) potenzieren muss, um dZahl zu erhalten.
1 01
Mathematische und finanzmathematische Funktionen und Anweisungen
Der interne Ertragssatz ist der Zinssatz für eine Investition, die aus Ein- und Auszahlungen in regelmäßigen Abständen besteht, wobei sich aber das Verhältnis zwischen Ein- und Auszahlungen mit der Zeit verschieben kann (wie bei einem neuen Unternehmen üblich, das zu Beginn große Investitionen tätigt und seine Einnahmen erst mit der Zeit verbessert, bis der Break-even überschritten ist). Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Elemente des Arrays dWerte enthalten die Werte der Cash Flows. Dabei ist die Reihenfolge eine wichtige Größe. IRR wird iterativ berechnet. IRR verwendet vErwartet als Startwert und wiederholt die Berechnung so lange, bis das Ergebnis auf 0,00001 Prozent genau ist. Wenn nach 20 Versuchen kein Ergebnis gefunden werden kann (im Allgemeinen, weil vErwartet zu schlecht ist), generiert IRR den Laufzeitfehler 5.
Mathematische und finanzmathematische Funktionen und Anweisungen
Beispiel
................................................... Beis piel
Print Log(2.71828182845905) Print Exp(Log(10))
' Ausgabe: 1 ' Ausgabe: 10
Verwandte Befehle
................................................... Verwa ndte Befehle
Exp
Mathematische und finanzmathematische Funktionen und Anweisungen
MIRR- Funktion Function MIRR( _ dWerte() As Double, _ dZinsFinanz As Double, _ dZinsReinv As Double) _ As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion MIRR (engl.: Modified Internal Rate of Return) liefert den modifizierten internen Ertragssatz für eine via dWerte() spezifizierte Folge regelmäßiger Ein- und Auszahlungen (Cash Flows). Im Gegensatz zu IRR rechnet MIRR mit unterschiedlichen Zinssätzen für die Finanzierung ungedeckter Ausgaben (dZinsFinanz) und die Reinvestition von Gewinnen (dZinsReinv). Anwendung
................................................... Anwendung
Die beiden Zinswerte, dZinsFinanz und dZinsReinv, sind als Faktoren (Prozentwert dividiert durch 100) anzugeben. Beispiel
................................................... Beis piel
Das folgende Codefragment zeigt beispielhaft, wie die Analyse eines Unternehmens aussehen kann, wenn für Investitionen ein Zins von 10% und für Reinvestitionen der interne Ertragssatz des Unternehmens angesetzt wird: Dim dWerte(9) As Double dWerte(0) = -50000 ' Investition bei Gründung dWerte(1) = -25000 ' Unternehmensaufbau dWerte(2) = 0 ' Break Even dWerte(3) = 5000 ' Erster Gewinn im vierten Jahr dWerte(4) = -1000 ' Verlust wg. schwacher Konjunktur dWerte(5) = 7000 ' Gewinn im sechsten Jahr dWerte(6) = 21000 ' Gewinn im siebten Jahr dWerte(7) = 45000 ' Gewinn im achten Jahr dWerte(8) = 60000 ' Gewinn im neunten Jahr dWerte(9) = 110000 ' Gewinn im zehnten Jahr Print Round(IRR(dWerte) * 100, 2) ' 17,32 Prozent Print Round(MIRR(dWerte, 0.1, IRR(dWerte)) * 100, 2) ' 17,04 Prozent Verwandte Befehle
................................................... Verwa ndte Befehle
IRR, Rate
1 02
NPer- Funktion
NPer- Funktion Function NPer( _ dZins As Double, _ dRate As Double, _ dBarwert As Double, _ [vZukünftigerWert], _ [vTermin]) _ As Double Beschreibung
Die zu den finanzmathematischen Funktionen zählende Funktion NPer (engl.: Number of Periods) liefert die Laufzeit (Anzahl der Zahlungsperioden) einer Annuität mit konstantem Zins dZins und dem Barwert dBarwert (vgl. die Funktion »PV-Funktion« S. 106). Der optionale Parameter vZukünftigerWert (vgl. »FV-Funktion«, S. 98) ermöglicht die Angabe eines zukünftigen Werts, der den nach der letzten Zahlung erreichten Kontostand angibt. Bei einem Kredit ist dieser Wert im Allgemeinen mit 0 anzugeben, was dem Vorgabewert für den Parameter entspricht. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Anwendung
................................................... Anwendung
Beachten Sie, dass die Werte für die Parameter dZins, dRate auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen, wie der von der Funktionen erwartete Wert. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Wird die Funktion zur Berechnung eines Kredits eingesetzt, ist für dBarwert die Kredithöhe als negativer Wert zu spezifizieren. Wird die Funktion zur Berechnung einer Ansparung eingesetzt, ist für dBarwert der augenblickliche Wert der Ansparung als positiver Wert anzugeben und für vZukünftigerWert das Sparziel als negativer Wert. Beispiel
................................................... Beis piel
Das folgende Codefragment berechnet die Laufzeit für einen Kredit über 7.000 € zu 10% p.a. sowie die Laufzeit einer Ansparung zu denselben Bedingungen: Print NPer(0.1 / 12, 100, -7000) Print NPer(0.1 / 12, 100, 0, -7000)
' Laufzeit f. Kredit: 106 ' Laufzeit f. Ansparung: 55
Auf dieselben Ergebnisse kommt man auch mittels: Print -NPer(0.1 / 12, 100, 0, 7000) Print -NPer(0.1 / 12, 100, 7000)
' Laufzeit f. Kredit: 106 ' Laufzeit f. Ansparung: 55
Warnung
................................................... Wa rnung
Die Funktion liefert einen Laufzeitfehler, wenn die Kreditlaufzeit bei gegebenem Zins und gegebener Rate über alle Grenzen wachsen würde, sprich: die Rate zu klein ist, als dass jemals eine Tilgung erfolgen könnte. (Solche Kredite würden Banken natürlich am liebsten geben: Man zahlt ein Leben lang, und die Schulden werden immer größer.) Print NPer(0.1 / 12, 100, -20000)
' Laufzeitfehler
1 03
Mathematische und finanzmathematische Funktionen und Anweisungen
................................................... Bes c hreibung
Mathematische und finanzmathematische Funktionen und Anweisungen
Verwandte Befehle
................................................... Verwa ndte Befehle
FV, IPmt, NPV, Pmt, PPmt, PV
NPV- Funktion Function NPV(dDiskontsatz As Double Werte() As Double) As Double Beschreibung
Mathematische und finanzmathematische Funktionen und Anweisungen
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion NPV (engl.: Net Present Value) liefert den Nettobarwert einer Investition für eine via dWerte() spezifizierte Folge regelmäßiger Ein- und Auszahlungen (Cash Flows) bei festem Diskontsatz dDiskontsatz. Anwendung
................................................... Anwendung
Der Nettobarwert einer Investition ist der aktuelle Wert einer Folge zukünftiger regelmäßiger Aus- und Einzahlungen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Elemente des Arrays dWerte enthalten die Werte der erwarteten Cash Flows. Dabei ist die Reihenfolge eine wichtige Größe. Die Investition beginnt mit dem Zeitraum des ersten CashFlow-Werts und endet mit dem Auftreten des letzten Cash-Flow-Werts. Im Gegensatz zur Funktion PV, die den Barwert einer Folge von Zahlungen unveränderlicher Höhe bei konstantem Zins und konstanter Laufzeit berechnet, erlaubt NPV Zahlungen unterschiedlicher Höhe (und Vorzeichen) und ermittelt die Laufzeit selbstständig aus der Anzahl der Werte. Die Funktion geht davon aus, dass die Zahlungen jeweils zum Ende der Zahlungsperioden erfolgen. Bezieht sich der erste Cash Flow auf den Beginn des ersten Zeitraums, so muss die Folge mit der zweiten Zahlung beginnen und die erste Zahlung gesondert zum Ergebnis von NPV addiert werden. Beispiel
................................................... Beis piel
Das folgende Codefragment zeigt beispielhaft, wie die NPV-Analyse für ein Unternehmen aussehen kann: Dim dWerte(9) As Double dWerte(0) = -50000 dWerte(1) = -25000 dWerte(2) = 0 dWerte(3) = 5000 dWerte(4) = -1000 dWerte(5) = 7000 dWerte(6) = 21000 dWerte(7) = 45000 dWerte(8) = 60000 dWerte(9) = 110000 Print NPV(0.1, dWerte) Verwandte Befehle
' ' ' ' ' ' ' ' ' ' '
................................................... Verwa ndte Befehle
MIRR, Rate
1 04
Investition bei Gründung Unternehmensaufbau Break Even Erster Gewinn im vierten Jahr Verlust wg. schwacher Konjunktur Gewinn im sechsten Jahr Gewinn im siebten Jahr Gewinn im achten Jahr Gewinn im neunten Jahr Gewinn im zehnten Jahr 40254
Pmt- Funktion
Pmt- Funktion Function Pmt( _ dZins As Double, _ dLaufzeit As Double, _ dBarwert As Double, _ [vZukünftigerWert], _ [vTermin]) _ As Double Beschreibung
Die zu den finanzmathematischen Funktionen zählende Funktion Pmt (engl.: Payment) liefert die zu zahlende Rate zu einer Annuität mit einer Laufzeit von dLaufzeit Zahlungsperioden, konstantem Zins dZins und dem Barwert dBarwert (vgl. die Funktion »PV-Funktion«, S. 106). Der optionale Parameter vZukünftigerWert (vgl. die Funktion »FV-Funktion«, S. 98) ermöglicht die Angabe eines zukünftigen Werts, der den nach der letzten Zahlung erreichten Kontostand angibt. Bei einem Kredit ist dieser Wert im Allgemeinen mit 0 anzugeben, was dem Vorgabewert für den Parameter entspricht. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Anwendung
................................................... Anwendung
Beachten Sie, dass die Werte für die Parameter dZins und dLaufzeit auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Für die Kreditberechnung setzen Sie dBarwert auf die Höhe des Kredits (Zahlungsausgang) und vZukünftigerWert auf 0 (Kredit abbezahlt). Tipp
................................................... Tipp
Die Funktionen IPmt und PPmt liefern den Zinsanteil und den Kapitalanteil zu einer bestimmten Periode. Die Summe aus Kapitalanteil und Zinsanteil entspricht der von Pmt gelieferten Rate. Beispiel
................................................... Beis piel
Sie wollen einen Kredit über 250.000 € mit einer Laufzeit von 20 Jahren und einem festen Zinssatz von 8,3% aufnehmen. Die monatliche Rate berechnet sich dann zu: Print Pmt(.083 / 12, 20 * 12, -250000)
' Ausgabe: 2138
Die gleichen 250.000 € im Rahmen einer Lebensversicherung mit 4,6% Kapitalverzinsung angespart, ergibt eine monatliche Rate von: Print Pmt(.046 / 12, 20 * 12, 0, -250000)
' Ausgabe: 636,82
Man sieht, Geben ist eben doch billiger denn Nehmen. Verwandte Befehle
................................................... Verwa ndte Befehle
FV, IPmt, NPer, NPV, PPmt, PV
1 05
Mathematische und finanzmathematische Funktionen und Anweisungen
................................................... Bes c hreibung
Mathematische und finanzmathematische Funktionen und Anweisungen
PPmt- Funktion
Mathematische und finanzmathematische Funktionen und Anweisungen
Function PPmt( _ dZins As Double, _ dPeriode As Double, _ dLaufzeit As Double, _ dBarwert As Double, _ [vZukünftigerWert], _ [vTermin]) _ As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion PPmt (engl.: Principal Payment) liefert den Kapitalanteil in der Periode dPeriode zu einer Annuität mit einer Laufzeit von dLaufzeit Zahlungsperioden, konstantem Zins dZins und dem Barwert dBarwert (vgl. »PVFunktion«, S. 106). Der optionale Parameter vZukünftigerWert (vgl. »FV-Funktion«, S. 98) ermöglicht die Angabe eines zukünftigen Werts, der den nach der letzten Zahlung erreichten Kontostand angibt. Bei einem Kredit ist dieser Wert im Allgemeinen mit 0 anzugeben, was dem Vorgabewert für den Parameter entspricht. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Anwendung
................................................... Anwendung
Beachten Sie, dass die Werte für die Parameter dZins, dPeriode und dLaufzeit auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Funktion wird im Allgemeinen zur Berechnung von Krediten eingesetzt und liefert dann den Tilgungsanteil zu einer bestimmten Periode. Für die Kreditberechnung setzen Sie dBarwert auf die Höhe des Kredits (Zahlungsausgang) und vZukünftigerWert auf 0 (Kredit abbezahlt). Tipp
................................................... Tipp
Die Funktion IPmt liefert den Zinsanteil. Die Summe aus Tilgungs- bzw. Kapitalanteil und Zins entspricht der von der Funktion Pmt gelieferten Rate. Beispiel
................................................... Beis piel
Vgl. das Beispiel in »IPmt-Funktion« (S. 99). Verwandte Befehle
................................................... Verwa ndte Befehle
FV, IPmt, NPer, NPV, Pmt, PV
PV- Funktion Function PV( _ dZins As Double, _ dLaufzeit As Double, _ dRate As Double, _ [vJetztWert], _ [vTermin]) _ As Double
1 06
Randomize- Anweisung
Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion PV (engl.: Payment Value) liefert den Barwert einer Annuität mit einer Laufzeit von dLaufzeit Zahlungsperioden, konstantem Zins dZins und der Rate dRate. Der optionale Parameter vJetztWert ermöglicht die Angabe eines Ausgangswerts bei bereits erfolgter Ansparung. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Anwendung
Beachten Sie, dass die Werte für die Parameter dZins und dLaufzeit auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Funktion lässt sich sowohl zur Berechnung von Krediten als auch von Ansparungen verwenden, wird aber vorzugsweise für die Ansparberechnung eingesetzt, da der Barwert bei Krediten üblicherweise einen Ausgangswert darstellt. Bei der Kreditberechnung sind dRate und dJetztWert als positive Werte anzugeben, bei der Ansparberechnung als negative Werte. Tipp
................................................... Tipp
Die Funktionen PV und FV liefern mit vertauschten Vorzeichen für dRate und dJetztWert die gleichen Ergebnisse. Beispiel
................................................... Beis piel
Das folgende Codefragment ermittelt den Barwert einer auf 100.000 € abgeschlossenen Lebensversicherung mit einer Laufzeit von 35 Jahren und einem Zinssatz von 4,45%: Zins = 0.045/12 Laufzeit = 35 * 12 Ansparung = -100000 Raten = Pmt(Zins, Laufzeit, 0, Ansparung) Barwert = PV(Zins, Laufzeit, Raten) ZukWert = FV(Zins, Laufzeit, Raten)
' 99,33 ' 21126,98 ' 100000 Probe stimmt!
Verwandte Befehle
................................................... Verwa ndte Befehle
FV, IPmt, IRR, NPer, NPV, Pmt, PPmt
Randomize- Anweisung Sub Randomize ([vSeed]) Beschreibung
................................................... Bes c hreibung
Die Anweisung Randomize initialisiert den Zufallsgenerator mit einem Startwert (engl.: Seed). Ausgehend von diesem Startwert lässt sich mittels der Zufallsfunktion Rnd eine gleich verteilte Sequenz von Zufallszahlen berechnen. Zu einem bestimmten Startwert liefert der Zufallsfunktion Rnd immer die gleiche Folge. Dabei benutzt sie jeweils den zuletzt gelieferten Wert als neuen Startwert. Fehlt vSeed, nimmt die Anweisung den von der Funktion Timer gelieferten Wert als Startwert.
1 07
Mathematische und finanzmathematische Funktionen und Anweisungen
................................................... Anwendung
Mathematische und finanzmathematische Funktionen und Anweisungen
Anwendung
................................................... Anwendung
Mathematische und finanzmathematische Funktionen und Anweisungen
Eine wirklich zufällige Initialisierung des Zufallsgenerators lässt sich erreichen, indem man den Wert der Funktion Timer als Startwert benutzt, der die Anzahl der seit Mitternacht (Systemzeit) vergangenen Sekunden liefert. Wird Randomize in einem Programm dagegen gar nicht ausgeführt, arbeitet Visual Basic mit dem Vorgabewert 0 als Startwert. Um im gleichen Programmlauf mehrere Folgen von Zufallszahlen mit deterministischem Startwert zu erzeugen, übergeben Sie der Funktion Rnd jeweils bei Berechnung des letzten Folgenelements einen negativen Wert und rufen danach Randomize mit dem Startwert der nächsten Folge auf. Beispiel
................................................... Beis piel
Der Startwert 10 sorgt dafür, dass Rnd reproduzierbar die folgende »Zufallsfolge« {0,5749933; 0,2375866; 0,5295308; 0,2520258} generiert: Randomize 10 Print Rnd(1), Rnd(1), Rnd(1), Rnd(1) Rnd(-1) Randomize Timer Print Rnd(1), Rnd(1), Rnd(1), Rnd(1)
' Folge für Startwert 10 ' Randomize vorbereiten ' wirklich zufällige Folge
Verwandte Befehle
................................................... Verwa ndte Befehle
Rnd
Rate- Funktion Function Rate( _ dLaufzeit As Double, _ dRate As Double, _ dBarWert As Double, _ [vZukünftigerWert], _ [vTermin]) _ [vSchätzung As Variant = 0.1] As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion Rate liefert den Zinssatz einer Annuität mit dem Barwert (vgl. »PV-Funktion«, S. 106) dBarWert, einer Laufzeit von dLaufzeit Zahlungsperioden und der Zahlungsrate dRate. Der optionale Parameter vZukünftigerWert (vgl. »FV-Funktion«, S. 98) ermöglicht die Angabe eines zukünftigen Werts, der den nach der letzten Zahlung erreichten Kontostand angibt. Bei einem Kredit ist dieser Wert im Allgemeinen mit 0 anzugeben, was dem Vorgabewert für den Parameter entspricht. Umgekehrt ist bei einer Ansparung dBarWert mit 0 anzugeben. Fehlt der optionale Parameter vTermin oder ist er 0, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Ende einer Periode erfolgt; ist der Wert dagegen 1, geht die Funktion davon aus, dass die Ratenzahlung jeweils zu Beginn einer Periode erfolgt. Da die Funktion das Ergebnis mit einem iterativen Verfahren berechnet, benötigt sie für den Start der Iteration einen Schätzwert vSchätzung. Fehlt dieser optionale Parameter, arbeitet die Funktion mit dem Vorgabewert 0,1.
1 08
Rnd- Funktion und Rnd- Anweisung
Anwendung
................................................... Anwendung
Beachten Sie, dass die Werte für die Parameter dRate und dLaufzeit auf denselben Einheitszeitraum (meist Monat oder Jahr) bezogen sein müssen. Für alle finanzmathematischen Funktionen gilt, dass Zahlungsausgänge durch negative Zahlen und Zahlungseingänge durch positive Zahlen dargestellt werden. Die Funktion lässt sich sowohl bei der Berechnung von Krediten als auch von Ansparungen verwenden. Bei der Kreditberechnung ist dBarwert als negativer Wert anzugeben, bei der Ansparberechnung dBarwert als 0 und dZukünftigerWert als negativer Wert. Beispiel
................................................... Beis piel
dLaufzeit = 35 * 12 dZukWert = -250000 dRate = 250 Print Rate(dLaufzeit, dRate, 0, dZukWert) * 1200; "%" ' Ausgabe: 4,42 % Verwandte Befehle
................................................... Verwa ndte Befehle
FV, IPmt, NPer, NPV, Pmt, PPmt, PV
Rnd- Funktion und Rnd- Anweisung Function Rnd [(vSchalter)] As Single Sub Rnd ([vSchalter]) Beschreibung
................................................... Bes c hreibung
Rnd lässt sich sowohl als Funktion als auch als Anweisung verwenden. Die Anweisung unterscheidet sich von der Funktion nur insoweit, als sie keinen Wert liefert. Die Zufallsfunktion Rnd ermittelt ausgehend von einem Startwert eine Zufallszahl mit dem Datentyp Single, die dem halboffenen Intervall [0; 1[ entstammt. Die Berechnung ist gleichverteilt, das heißt, jede der im Intervall als Single darstellbaren Zahlen wird mit gleicher Wahrscheinlichkeit ermittelt. Der Wert des optionalen Parameters vSchalter bestimmt, wie die Funktion mit dem Startwert verfährt. Fehlt der Parameter oder ist sein Wert größer als 0, berechnet die Funktion jeweils die nächste Zufallszahl aus der vorangegangenen, indem sie diese als Startwert verwendet. Damit liefert Rnd eine deterministische Folge von Zufallszahlen, die durch den ersten Startwert ausgewählt wird. Standardmäßig initialisiert Visual Basic den Startwert für jeden Programmlauf auf 0, so dass Rnd ohne weitere Vorkehrungen in der Tat die immer gleiche Folge liefert. Um eine andere Folge auszuwählen, muss der Startwert zuvor mittels der Anweisung Randomize explizit gesetzt werden. Hat der Parameter vSchalter den Wert 0, liefert Rnd erneut die vorangegangene Zufallszahl. Ist vSchalter dagegen ein negativer Wert, legt die Funktion dem nächsten Aufruf den durch Randomize (erneut) gesetzten Startwert zugrunde. Anwendung
................................................... Anwendung
Im Allgemeinen wird man vor dem ersten Rnd-Aufruf einen Randomize-Aufruf setzen, der für eine Auswahl der Zufallsfolge sorgt. Eine wirklich zufällige Initialisierung des Zufallsgenerators lässt sich erreichen, indem man den Wert der Funktion Timer, die die Anzahl der seit Mittnacht (Systemzeit) vergangenen Sekunden liefert, als Startwert einsetzt. Dazu reicht es, Randomize ohne Angabe eines Parameters auszuführen. Um im gleichen Programmlauf mehrere Folgen von Zufallszahlen mit deterministischem Startwert zu erzeugen, setzen Sie vor jeden Randomize-Aufruf die Anweisung Rnd(-1).
1 09
Mathematische und finanzmathematische Funktionen und Anweisungen
Das folgende Codefragment ermittelt den Zins in Prozent für eine Ansparung über 250.000 € mit einer Laufzeit von 35 Jahren und einer monatlichen Rate von 250 €:
Mathematische und finanzmathematische Funktionen und Anweisungen
Beispiel
................................................... Beis piel
Vgl. das Beispiel zu »Randomize-Anweisung« (S. 107). Verwandte Befehle
................................................... Verwa ndte Befehle
Randomize Verwandte Themen
................................................... Verwandte Them en
Mathematische und finanzmathematische Funktionen und Anweisungen
Zeitgeber-Steuerelement (Timer) (S. 432)
Round- Funktion Function Round(dZahl As NumTyp, [iDezStellen As Integer = 0]) As NumTyp Beschreibung
................................................... Bes c hreibung
Die Rundungsfunktion Round führt eine Kaufmannsrundung durch. Fehlt der Parameter iDezimalstellen oder hat der den Wert 0, liefert die Funktion die nächste Ganzzahl in der Umgebung von dZahl und führt dabei – im Gegensatz zu Fix und Int – eine echte Kaufmannsrundung durch. Jeder andere positive Wert für iDezimalstellen benennt eine Dezimalstelle hinter dem Komma, an der die Rundung stattfinden soll. Die Funktion richtet den Datentyp des Rückgabewerts nach dem Datentyp des Parameters. Warnung
................................................... Wa rnung
Wie das Beispiel zeigt, ist die Dezimalrechnung mit den Datentypen Single und Double nicht immer exakt. Das liegt daran, dass die Repräsentation dieser Werte intern im hexadezimalen bzw. echten binären Zahlenformat erfolgt und viele endliche Dezimalbrüche im binären Zahlensystem nur als unendliche Binärbrüche darstellbar sind. Im Zusammenhang mit der Funktion Round kann das zu peinlichen Fehlern führen. Wenn Sie Exaktheit benötigen, müssen Sie mit einem der Datentypen Currency oder Decimal rechnen. Beispiel
................................................... Beis piel
Print Print Print Print Print Print
Round(14.005, Round(14.015, Round(14.025, Round(14.035, Round(14.045, Round(14.055,
2) 2) 2) 2) 2) 2)
' ' ' ' ' '
14 14,02 14,02 14,04 14,04 14,06
(erwartet: 14,01) (korrekt) (erwartet 14,03) (korrekt) (erwartet 14,03) (korrekt)
Verwandte Befehle
................................................... Verwa ndte Befehle
CInt, Fix, Int
Sgn- Funktion Function Sgn(dZahl As NumTyp) As Integer Beschreibung
................................................... Bes c hreibung
Die Vorzeichenfunktion Sgn liefert das Vorzeichen des Werts dZahl als Faktor. Das Ergebnis ist 1, wenn dZahl positiv ist, 0, wenn dZahl 0 ist, und -1, wenn dZahl negativ ist.
110
Sgn- Funktion
Anwendung
................................................... Anwendung
Die Funktion Sgn ist zuweilen nützlich, wenn es darum geht, Laufzeitoptimierungen vorzunehmen und If-Anweisungen durch geschicktere Formulierung logischer Ausdrücke zu vereinfachen oder ganz zu vermeiden. Beispiel
................................................... Beis piel
Die folgende Zeile wird erheblich schneller verarbeitet als die auskommentierte If-Anweisung (allerdings haben die beiden Formulierungen nicht die gleiche Semantik, da Nullwerte nicht mitgezählt werden):
In der folgenden, dem Projekt Apfelmann entstammenden Routine führt die Formulierung der zeitaufwändigen If-Abfrage mit den Funktionen Abs und Sgn zu einer Laufzeitverbesserung um immerhin ca. 30 %. Messen Sie es nach, indem Sie einmal die eine und einmal die andere Zeile auskommentieren! Private Sub Apfel(m_x1, m_x2, m_y1, m_y2, step_x, step_y) Dim r1 As Double, re As Double, im As Double Dim zr As Double, zi As Double, it As Long Zeit = Timer For zr = m_x1 To m_x2 Step step_x ' alle Spalten in x-Richtung For zi = m_y1 To m_y2 Step step_y ' alle Punkte in Spalte zr re = 0 ' Realteil initialisieren im = 0 ' Imaginärteil initialisieren For it = 0 To cMaxIterat ' Iteration für Punkt r1 = re * re – im * im + zr im = 2 * re * im + zi re = r1 ' If re < -cGrenze Or re > cGrenze Or im < -cGrenze Or im > cGrenze Then If Sgn(cGrenze – Abs(re)) + Sgn(cGrenze – Abs(im)) = -2 Then PSet (zr, zi), it * 16 ' Punkt ausgeben Exit For End If Next it Next zi Next zr Caption = Timer – Zeit End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
CInt, Fix, Int
111
Mathematische und finanzmathematische Funktionen und Anweisungen
Dim lZähler As Long Zeit = Timer ' Laufzeitmessung beginnen For i = 1 To 1000000 zv = Rnd – 0.5 lZähler = lZähler + Sgn(zv) ' If zv > 0 Then lZähler = lZähler + 1 Else lZähler = lZähler – 1 Next Caption = Timer – Zeit ' Laufzeit als Titelzeile ausgeben
Mathematische und finanzmathematische Funktionen und Anweisungen
Sin- Funktion Function Sin(dWinkel As Double) As Double Beschreibung
................................................... Bes c hreibung
Die zu den trigonometrischen Funktionen zählende Sinusfunktion Sin liefert den Sinus zu dem im Bogenmaß angegebenen Winkel dWinkel. Das Ergebnis der Funktion liegt immer im Intervall [-1; 1]. Für die Umwandlung eines Gradwerts in das Bogenmaß ist der Wert mit π/180 = 1,74532925199433E-02 zu multiplizieren.
Mathematische und finanzmathematische Funktionen und Anweisungen
Anwendung
................................................... Anwendung
Diese Funktion berechnet aus dem Winkel zwischen Ankathete und Hypothenuse die Gegenkathete eines rechtwinkligen Dreiecks mit Hypothenuse 1. Beispiel
................................................... Beis piel
Dim Pi As Double Pi = Atn(1) * 4 Print Sin(Pi / 6)
' 3.14159265358979 ' Ausgabe: 0,5 [= Sin(30°)]
Verwandte Befehle
................................................... Verwa ndte Befehle
Atn, Cos, Tan
SLN- Funktion Function SLN( _ dAnschaffungsKosten As Double, _ dRestwert As Double, _ dNutzungsDauer As Double) _ As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion SLN (engl.: Straight Line Depreciation) berechnet die periodische Abschreibung einer Investition dAnschaffungsKosten mit dem Restwert dRestwert über die Nutzungsdauer dNutzungsDauer nach dem linearen (arithmetischen) Abschreibungsmodell. Anwendung
................................................... Anwendung
Der von SLN gelieferte Wert bezieht sich auf die gleiche Einheit (Monate oder Jahre) wie dNutzungsDauer. Er errechnet sich wie folgt: Anschaffungswert – Endwert SLN = --------------------------------------------------------------------------Nutzungsdauer Beispiel
................................................... Beis piel
Print SLN(10000, 100, 10) Verwandte Befehle
' Ausgabe 990
................................................... Verwa ndte Befehle
DDB, SYD
112
Sqr- Funktion
Sqr- Funktion Function Sqr(dPositiveZahl As Double) As Double Beschreibung
................................................... Bes c hreibung
Die Wurzelfunktion Sqr liefert die Quadratwurzel von dPositiveZahl. Ist der Wert von dPositiveZahl negativ, meldet die Funktion einen Laufzeitfehler. Beispiel
................................................... Beis piel
det = (b * b – 4 * a * c) If det < 0 Then Print "Keine Lösung" If det = 0 Then Print "x1, x2 = "; -b / 2 / a If det > 0 Then Print "x1 = "; (-b + det) / 2 / a Print "x2 = "; (-b – det) / 2 / a End If Verwandte Befehle
................................................... Verwa ndte Befehle
^ (Operator)
SYD- Funktion Function SYD( _ dAnschaffungsKosten As Double, _ dRestwert As Double, _ dNutzungsDauer As Double_ dPeriode As Double) _ As Double Beschreibung
................................................... Bes c hreibung
Die zu den finanzmathematischen Funktionen zählende Funktion SYD (engl.: Sum of Years Depreciation) berechnet die periodische Abschreibung einer Investition dAnschaffungsKosten mit dem Restwert dRestwert über die Nutzungsdauer dNutzungsDauer für die Periode dPeriode nach dem Abschreibungsmodell der Jahressummengewichtung. Beispiel
................................................... Beis piel
Der folgende Code zeigt eine alternative Implementation der Funktion SYD: Function MySYD(Wert, Rest, Nutzung, per) d = Nutzung * (Nutzung + 1) / 2 MySYD = (Wert – Rest) / d * (Nutzung + 1 – per) End Function
Beide Funktionen liefern die gleichen Werte: For per = 1 To 10 Print SYD(10000, 100, 10, per), Print MySYD(10000, 100, 10, per) Next
' 1800, 1620, 1440, 1260,... ' 1800, 1620, 1440, 1260,...
113
Mathematische und finanzmathematische Funktionen und Anweisungen
Das folgende Codefragment berechnet die Lösung(en) der allgemeinen quadratischen Gleichung ax² + bx +c = 0:
Funktionen und Anweisungen für Datums- / Zeitwerte
Verwandte Befehle
................................................... Verwa ndte Befehle
DDB, SLN
Tan- Funktion Function Tan(dWinkel As Double) As Double Beschreibung
Funktionen und Anweisungen für Datums- / Zeitwerte
................................................... Bes c hreibung
Die zu den trigonometrischen Funktionen zählende Tangensfunktion Tan liefert den Tangens zu dem im Bogenmaß angegebenen Winkel dWinkel. Die Umkehrfunktion zu Tan ist Atn. Für die Umwandlung von Grad in das Bogenmaß ist der Wert mit π/180 = 1,74532925199433E-02 zu multiplizieren. Anwendung
................................................... Anwendung
Diese Funktion berechnet aus dem Winkel zwischen Ankathete und Hypothenuse die Steigung der Hypothenuse, welche ihrerseits als Quotient zwischen Ankathete und Gegenkathete definiert ist. Beispiel
................................................... Beis piel
Dim Pi As Double Pi = Atn(1) * 4 Print Sin(Pi / 4) / Cos(Pi / 4) Print Tan(Pi / 4)
' 3.14159265358979 ' 1 ' 1
Verwandte Befehle
................................................... Verwa ndte Befehle
Atn, Cos, Sin
Funktionen und Anweisungen für Datums- / Zeitwerte Mit der zunehmenden Bedeutung von Visual Basic als Programmiersprache für Front-endAnwendungen im Datenbankbereich versteht es sich beinahe von selbst, dass die Sprache insbesondere für solche Datentypen Äquivalente anbietet, die bei der Datenbankprogrammierung gemeinhin als grundlegende Datentypen gehandelt werden. Die Welt der Datums-/Zeitwerte und ihrer Operationen stellt nicht zuletzt aus diesem Grund neben der Welt der Zeichenfolgen und der Welt der numerischen Datentypen eine eigene Kategorie dar, um die Visual Basic die Sprache Basic bereichert hat. Werte des Typs Date repräsentiert Visual Basic als 64-Bit-Gleitkommazahlen (8 Bytes) nach IEEE und kann somit Datumsangaben im Bereich zwischen dem 1. Januar 100 und dem 31. Dezember 9999 sowie Uhrzeiten im Bereich von 0:00:00 bis 23:59:59 unterscheiden. Datumswerte können Datumsangaben und Zeitangaben kombinieren, aber auch je einzeln ausdrücken. Der Notation literaler Datums- und Zeitangaben liegt das amerikanische Format zugrunde, das heißt, in Datumsangaben wird der Monat vor dem Tag notiert, die Abtrennung erfolgt durch das Zeichen »/«, und Zeitangaben sind in 12-StundenDarstellung gefolgt von »PM« oder »AM« zu treffen. Zudem ist die Darstellung durch ein führendes und ein abschließendes #-Zeichen einzuschließen. An Operationen für den Datentyp Date hält Visual Basic eine ganze Latte parat, die mehr oder weniger etwas mit der Konvertierung unter Berücksichtigung verschiedener Notationen oder mit der Extraktion einer bestimmten Teilinformation zu tun haben. Die folgende Tabelle gibt einen Überblick über alle für diesen Datentyp relevanten Funktionen und Anweisungen:
114
Funktionen und Anweisungen für Datums- / Zeitwerte
Kurzbeschreibung
CDate
Interpretiert eine Zeichenfolge oder einen Zahlenwert als Datums-/Zeitwert
Date
Liefert das aktuelle Systemdatum als Datums-/Zeitwert
Date
Setzt den Datumsanteil von Datums-/Zeitwert als aktuelles Systemdatum
DateAdd
Berechnet die Summe aus einem Datums-/Zeitwert und einem Zeitintervall, das wahlweise in Sekunden, Minuten, Stunden, Tage etc. anzugeben ist
DateDiff
Berechnet das Zeitintervall zwischen zwei Datums-/Zeitwerten und liefert das Ergebnis wahlweise in einer der Einheiten Sekunden, Minuten, Stunden, Tage etc.
DatePart
Liefert eine Teilinformation aus einem Datums-/Zeitwert, wahlweise Sekunden, Minuten, Stunden, Tage etc.
DateSerial
Setzt einen Datums-/Zeitwert aus Ganzzahlwerten (Tag, Monat und Jahr) zusammen
DateValue
Interpretiert eine Zeichenfolge oder einen Zahlenwert als Datumsanteil von Datums-/Zeitwert
Day
Liefert den Tag aus einem Datums-/Zeitwert als Zahlenwert (1 bis 31)
FileDateTime
Liefert den Zeitpunkt der Erstellung bzw. letzten Änderung einer Datei als Datums-/Zeitwert
FormatDateTime
Liefert die Darstellung eines Datums-/Zeitwerts als Zeichenfolge im spezifizierten Format
Hour
Liefert die Stunde aus einem Datums-/Zeitwert als Zahlenwert (0 bis 23)
Minute
Liefert die Minute aus einem Datums-/Zeitwert als Zahlenwert (0 bis 59)
Month
Liefert den Monat aus einem Datums-/Zeitwert als Zahlenwert (1 – 12)
MonthName
Liefert für einen Zahlenwert zwischen 1 und 12 den Monatsnamen als Zeichenfolge
Now
Liefert Systemdatum und -zeit als Datums-/Zeitwert
Second
Liefert die Sekunde aus einem Datums-/Zeitwert als Zahlenwert (0 bis 59)
Time
Liefert die aktuelle Systemzeit als Datums-/Zeitwert
Time
Setzt den Zeitanteil von Datums-/Zeitwert als aktuelle Systemzeit
Timer
Liefert den Wert des System-Timers (Sekunden seit Mitternacht)
TimeSerial
Setzt einen Datums-/Zeitwert aus Ganzzahlwerten (Sekunde, Minute, Stunde) zusammen
TimeValue
Interpretiert eine Zeichenfolge oder einen Zahlenwert als Zeitanteil eines Datums-/Zeitwerts
WeekDay
Liefert den Wochentag aus einem Datums-/Zeitwert als Zahl (1 bis 7)
WeekDayName
Liefert den Wochentag als Zeichenfolge für Werte zwischen 1 und 7
Year
Liefert das Jahr aus einem Datums-/Zeitwert als Zahlenwert
Auf Datum und Zeit bezogene Funktionen und Anweisungen
115
Funktionen und Anweisungen für Datums- / Zeitwerte
Bezeichner
Funktionen und Anweisungen für Datums- / Zeitwerte
CDate- Funktion Function CDate(vWert) As Date Siehe »Typumwandlung« (S. 57).
Date- Funktion und Date- Anweisung Function Date() As Date Date = datDatum Beschreibung
Funktionen und Anweisungen für Datums- / Zeitwerte
................................................... Bes c hreibung
Als Funktion liefert Date das aktuelle Systemdatum und als Anweisung setzt Date das aktuelle Systemdatum (dauerhaft). Beispiel
................................................... Beis piel
Immer häufiger spielen sich Shareware-Programme als Timeware-Programme auf, indem sie nach einer gewissen Zeit überraschend die Arbeit einstellen und einen so dazu »überreden« wollen, sich für die Vollversion registrieren zu lassen. Für die Übergangszeit bietet sich ein kleines Visual-Basic-Programm namens SharewareTrick an, das kurz am Systemdatum dreht: Dim datSystem As Date Private Sub Form_Load() datSystem = Date Date = "1.1.00" Zeitware = Shell("notepad.exe", vbNormalFocus) Timer1.Interval = 10000 End Sub Private Sub Timer1_Timer() Timer1.Interval = 0 Date = datSystem End End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
Now, Time
DateAdd- Funktion Function DateAdd(Interval As String, Number As Double, Date) As Date Beschreibung
................................................... Bes c hreibung
Die Funktion DateAdd addiert zu einem gegebenen Datums-/Zeitwert Date ein Zeitintervall Number, dem die Einheit Interval zugrunde gelegt ist. Wert für Interval
Beschreibung
"yyyy"
Die Funktion interpretiert Number als Jahre
"q"
Die Funktion interpretiert Number als Quartale
"m"
Die Funktion interpretiert Number als Monate
116
DateDiff- Funktion
Wert für Interval
Beschreibung
"ww"
Die Funktion interpretiert Number als Wochen
"d", "w", "y"
Die Funktion interpretiert Number als Tage
"h"
Die Funktion interpretiert Number als Stunden
"n"
Die Funktion interpretiert Number als Minuten
"s"
Die Funktion interpretiert Number als Sekunden
Anwendung
Der Datentyp Date verwendet für die interne Darstellung von Datums-/Zeitwerten einen Wert vom Typ Double, der sich nicht so ohne Weiteres in seine Bestandteile (Sekunden, Minuten, Stunden, Tage, Wochen, Monate Jahre) zerlegen lässt. Mit der Funktion DateAdd stellt Visual Basic ein bequemes Mittel für das Rechnen mit Zeitwerten zur Verfügung. Beachten Sie, dass der Wertebereich von Date auf Datums-/Zeitwerte zwischen dem 1.1.100 und dem 31.12.9999 beschränkt ist. Beispiel
................................................... Beis piel
Die folgende Zeile berechnet den Datums-/Zeitwert für ein Ereignis, das NewInterval Sekunden in der Zukunft gelegen ist. m_TriggerTime = DateAdd("s", NewInterval, Now)
Ein praxisnahes Beispiel für die Anwendung dieser Funktion ist das im Praxisteil vorgestellte Projekt LongTimer (vgl. »LongTimer – der Timer mit Ausdauer«, S. 599). Verwandte Befehle
................................................... Verwa ndte Befehle
DateDiff, DatePart, DateSerial, DateValue, TimeSerial
DateDiff- Funktion Function DateDiff(Interval As String, Date1, Date2, [FirstDayOfWeek As VbFirstDayOfWeek = vbSunday], _ [FirstWeekOfYear As VbFirstWeekOfYear = vbFirstJan1]) _ As Long Beschreibung
................................................... Bes c hreibung
Die Funktion DateDiff bildet die Differenz aus den beiden Datums-/Zeitwerten Date2 und Date1 und liefert das Ergebnis als Ganzzahl in der Einheit Interval. Die optionalen Parameter FirstDayOfWeek und FirstWeekOfYear beziehen sich auf exotische Formen der Datumsdarstellung und können im Allgemeinen getrost weggelassen werden. Wert für Interval
Beschreibung
"yyyy"
Funktion liefert das Ergebnis in der Einheit »Jahre»
"q"
Funktion liefert das Ergebnis in der Einheit »Quartale»
"m"
Funktion liefert das Ergebnis in der Einheit »Monate»
"w", "ww"
Funktion liefert das Ergebnis in der Einheit »Wochen»
117
Funktionen und Anweisungen für Datums- / Zeitwerte
................................................... Anwendung
Funktionen und Anweisungen für Datums- / Zeitwerte
Wert für Interval
Beschreibung
"d", "y"
Funktion liefert das Ergebnis in der Einheit »Tage»
"h"
Funktion liefert das Ergebnis in der Einheit »Stunden»
"n"
Funktion liefert das Ergebnis in der Einheit »Minuten»
"s"
Funktion liefert das Ergebnis in der Einheit »Sekunden»
Anwendung
Funktionen und Anweisungen für Datums- / Zeitwerte
................................................... Anwendung
Der Datentyp Date verwendet für die interne Darstellung von Datums-/Zeitwerten einen Wert vom Typ Double, der sich nicht so ohne Weiteres in seine Bestandteile (Sekunden, Minuten, Stunden, Tage, Wochen, Monate Jahre) zerlegen lässt. Mit der Funktion DateDiff stellt Visual Basic ein bequemes Mittel für das Rechnen mit Zeitwerten zur Verfügung. Beachten Sie, dass der Wertebereich von Date auf Datums-/Zeitwerte zwischen dem 1.1.100 und dem 31.12.9999 beschränkt ist. Warnung
................................................... Wa rnung
Die Reihenfolge der Parameter Date1 und Date2 ist leider kontraintuitiv gewählt. DateDiff rechnet: Date2 – Date1. Beispiel
................................................... Beis piel
Die folgende Zeile berechnet die Anzahl der Sekunden, die seit der Geburtsstunde des Autors verstrichen sind: Print DateDiff("s", #3/3/1959 11:32:00 PM#, Now)
Ein praxisnahes Beispiel für die Anwendung dieser Funktion ist das im Praxisteil vorgestellte Projekt LongTimer (vgl. »LongTimer – der Timer mit Ausdauer«, S. 599). Verwandte Befehle
................................................... Verwa ndte Befehle
DateAdd, DatePart, DateSerial, DateValue, TimeSerial
DatePart- Funktion Function DatePart( _ Interval As String, Date, [FirstDayOfWeek As VbFirstDayOfWeek = vbSunday], _ [FirstWeekOfYear As VbFirstWeekOfYear = vbFirstJan1]) _ As Long Beschreibung
................................................... Bes c hreibung
Die Funktion DatePart extrahiert den über den Parameter Interval spezifizierten Bestandteil des Datums-/Zeitwerts Date und liefert ihn als Wert vom Typ Long. Die optionalen Parameter FirstDayOfWeek und FirstWeekOfYear beziehen sich auf exotische Formen der Datumsdarstellung und können im Allgemeinen getrost weggelassen werden.
118
DateSerial- Funktion
Wert für Interval
Beschreibung
"yyyy"
Funktion extrahiert die Information »Jahre»
"q"
Funktion extrahiert die Information »Quartale»
"m"
Funktion extrahiert die Information »Monate»
"ww"
Funktion extrahiert die Information »Wochen»
"w"
Funktion extrahiert die Information »Tag der Woche» Funktion extrahiert die Information »Tag im Jahr» Funktion extrahiert die Information »Tag im Monat»
"h"
Funktion extrahiert die Information »Stunden»
"n"
Funktion extrahiert die Information »Minuten»
"s"
Funktion extrahiert die Information »Sekunden»
Anwendung
................................................... Anwendung
Der Datentyp Date verwendet für die interne Darstellung von Datums-/Zeitwerten einen Wert vom Typ Double, der sich nicht so ohne Weiteres in seine Bestandteile (Sekunden, Minuten, Stunden, Tage, Wochen, Monate Jahre) zerlegen lässt. Mit der Funktion DatePart stellt Visual Basic ein bequemes Mittel für das Zerlegen von Datums-/Zeitwerten zur Verfügung. Beispiel
................................................... Beis piel
Print "Diese Woche ist die " & DatePart("ww", Now) & ". Kalenderwoche" Verwandte Befehle
................................................... Verwa ndte Befehle
Day, Hour, Minute, Month, MonthName, Second, WeekDay, Year
DateSerial- Funktion Function DateSerial( _ iJahr As Integer, iMonat As Integer, iTag As Integer) As Date Beschreibung
................................................... Bes c hreibung
Die Funktion DateSerial generiert aus den Ganzzahlwerten iTag, iMonat und iJahr einen Datums-/Zeitwert. Anwendung
................................................... Anwendung
Die Funktion prüft die Werte der Parameter nicht, das heißt, sie löst auch keinen Laufzeitfehler aus, wenn die Komponenten kein reelles Datum ergeben. Wichtig ist nur das Resultat: Es darf sich kein Datum vor dem 1.1.100 und nach dem 31.12.9999 ergeben. Auf diese Weise gestattet die Funktion sehr schön das Rechnen mit relativen Zeitangaben wie: heute, vor zwei Jahren, drei Monaten, vier Tagen. Wenn Sie versuchen, dies allgemein »zu Fuß« auszurechnen, werden Sie merken, dass Sie schnell in des Teufels Küche geraten, da die Monate unterschiedlich lang sind und unser Gregorianische Kalender eine nicht unkomplizierte Schaltregel hat.
119
Funktionen und Anweisungen für Datums- / Zeitwerte
"y" "d"
Funktionen und Anweisungen für Datums- / Zeitwerte
Beispiel
................................................... Beis piel
Funktionen und Anweisungen für Datums- / Zeitwerte
Mit DateSerial gerät die Lösung des genannten Problems zum Einzeiler. Probieren Sie es aus; für den 1.1.2001 stimmt die alternative Lösung, für den 1.1.2000 dagegen nicht. d = Date Date = "1.1.2000" ' Date = "1.1.2001" Print DateSerial(Year(Date) – 2, Month(Date) – 3, Day(Date) – 4) Print Date – 2 * 365 – 3 * 31 – 4 ' alternative Lösung Date = d
Ein praxisnahes Beispiel für die Anwendung dieser Funktion ist das Projekt FormatDemo (vgl. »Format-Funktion«, S. 69), das einen Halbjahreskalender ausgibt. Verwandte Befehle
................................................... Verwa ndte Befehle
TimeSerial
DateValue- Funktion Function DateValue( sDatum As String) As Date Beschreibung
................................................... Bes c hreibung
Die Funktion DateValue interpretiert die Zeichenfolge sDatum als Datum und generiert daraus einen Datums-/Zeitwert. Falls die Zeichenfolge auch Zeitangaben enthält, werden diese nicht berücksichtigt. Anwendung
................................................... Anwendung
Was die Notation des Datums betrifft, ist DateValue weitgehend tolerant. So ergänzt die Funktion bei fehlendem Jahr das aktuelle Jahr aus dem Systemdatum des Computers und akzeptiert darüber hinaus neben dem kurzen und dem langen Datumsformat (entsprechend den auf dem System geltenden Datumseinstellungen) auch mittlere Datumsformate, in denen der Monat mit mindestens drei Buchstaben abgekürzt ist und Tag und Monat gegebenenfalls vertauscht sind. Tipp
................................................... Tipp
CDate und TimeValue unterscheiden sich insofern, als CDate auch Werte anderer Datentypen als String in einen Datums-/Zeitwert umsetzt und zusätzlich auch einen Zeitanteil berücksichtigt. Beispiel
................................................... Beis piel
Viele Wege führen nach Rom! Print Print Print Print Print Print Print Print Print
1 20
DateValue("1.2") DateValue("1. Feb") DateValue("1. Febr.") DateValue("1. Februar 00") DateValue("Feb, 1 00") DateValue("00, Feb 01 ") DateValue("1.2.00") DateValue("1.2.2000 ") DateValue("1. Feb")
' ' ' ' ' ' ' ' '
"01.02.2000" "01.02.2000" "01.02.2000" "01.02.2000" "01.02.2000" "01.02.2000" "01.02.2000" "01.02.2000" "01.02.2000"
Day- Funktion
Verwandte Befehle
................................................... Verwa ndte Befehle
TimeSerial, CDate
Day- Funktion Function Day(datWert As Date) As Integer Beschreibung
................................................... Bes c hreibung
Beispiel
................................................... Beis piel
Siehe »Format-Funktion« (S. 69) und das dort vorgestellte Projekt FormatDemo. Verwandte Befehle
................................................... Verwa ndte Befehle
DatePart, Hour, Minute, Month, Second, Year
FileDateTime- Funktion Function FileDateTime(sPfad As String) As Date Siehe »FileDateTime-Funktion« (S. 139 ).
FormatDateTime- Funktion Function FormatDateTime(vData, _ BenanntesFormat As VbDateTimeFormat = vbGeneralDate]) _ As String Siehe »FormatDateTime-Funktion« (S. 74 ) und »Format-Funktion« (S. 69).
Hour- Funktion Function Hour(datWert As Date) As Integer Beschreibung
................................................... Bes c hreibung
Die Funktion Hour liefert den Stundenanteil des Datums-/Zeitwerts datWert als Ganzzahl zwischen 0 und 23. Beispiel
................................................... Beis piel
Print "Es ist"; Minute(Time); " Minuten und "; Second(Time); _ "Sekunden nach"; Hour(Time) Verwandte Befehle
................................................... Verwa ndte Befehle
DatePart, Day, Minute, Month, Second, Year
Minute- Funktion Function Minute(datWert As Date) As Integer
1 21
Funktionen und Anweisungen für Datums- / Zeitwerte
Die Funktion Day liefert den Tagesanteil des Datums-/Zeitwerts datWert als Ganzzahl zwischen 1 und 31.
Funktionen und Anweisungen für Datums- / Zeitwerte
Beschreibung
................................................... Bes c hreibung
Die Funktion Minute liefert den Minutenanteil des Datums-/Zeitwerts datWert als Ganzzahl zwischen 0 und 59. Beispiel
................................................... Beis piel
Print "Es ist"; Minute(Time); " Minuten und "; Second(Time); _ "Sekunden nach"; Hour(Time)
Funktionen und Anweisungen für Datums- / Zeitwerte
Verwandte Befehle
................................................... Verwa ndte Befehle
DatePart, Day, Hour, Month, Second, Year
Month- Funktion Function Month(datWert As Date) As Integer Beschreibung
................................................... Bes c hreibung
Die Funktion Month liefert den Monatsanteil des Datums-/Zeitwerts datWert als Ganzzahl zwischen 1 und 12. Beispiel
................................................... Beis piel
Siehe »Format-Funktion« (S. 69) und das dort vorgestellte Projekt FormatDemo. Verwandte Befehle
................................................... Verwa ndte Befehle
DatePart, Day, Hour, Minute, Second, Year
MonthName- Funktion Function MonthName(lMonat As Long, bAbk As Boolean = False) As String Siehe »MonthName-Funktion« (S. 82).
Now- Funktion Function Now() As Date Beschreibung
................................................... Bes c hreibung
Die Funktion Now liefert die aktuelle Systemzeit mit Datums- und Zeitanteil. Beispiel
................................................... Beis piel
Print Now Verwandte Befehle
................................................... Verwa ndte Befehle
Time, Date
Second- Funktion Function Second(datWert As Date) As Integer
1 22
Time- Funktion und Time- Anweisung
Beschreibung
................................................... Bes c hreibung
Die Funktion Second liefert den Sekundenanteil des Datums-/Zeitwerts datWert als Ganzzahl zwischen 0 und 59. Beispiel
................................................... Beis piel
Print "Es ist"; Minute(Time); " Minuten und "; Second(Time); _ "Sekunden nach"; Hour(Time) Verwandte Befehle
DatePart, Day, Hour, Month, Minute, Year
Time- Funktion und Time- Anweisung Function Time() As Date Time = datZeit Beschreibung
................................................... Bes c hreibung
Als Funktion liefert Time die aktuelle Systemzeit und als Anweisung setzt Time den Datums-/ Zeitwert datZeit als aktuelle Systemzeit (dauerhaft). Anwendung
................................................... Anwendung
Wer nicht gerade eine Uhr programmiert, dürfte sehr gut ohne diese Funktion bzw. Anweisung auskommen. Es kommt zwar häufiger vor, dass man die aktuelle Systemzeit ausgeben muss – so etwa beim Drucken oder wenn Datensätze mit Zeitstempeln versehen werden müssen, im Allgemeinen wird dann aber die Funktion Now die bessere Lösung sein, da sie den Zeit- und den Datumsanteil der Systemzeit ermittelt. Wenn es dagegen um die Bestimmung von Zeiträumen innerhalb eines Tages geht, so etwa für Laufzeitmessungen, wird die Funktion Timer die bessere Wahl sein. Anwendung
................................................... Anwendung
Wer kennt das nicht? Das Dokument ist erst in der Nacht fertig geworden, und der Empfänger braucht das nicht unbedingt zu wissen. Anstatt umständlich auf den Zeitstempel der Datei loszugehen, ist es geschickter, der Anwendung eine Zeit lang eine falsche Zeit vorzugaukeln, während sie die Datei abspeichert. Genau das macht das Beispielprojekt ZeitStempel. ' Projekt: Zeitstempel Const cVerzögerung = 10 Const cZivilZeit = #3:59:00 PM# Dim datSysZt As Date
' Sekunden ' Kurz vor Feierabend
Private Sub Form_Load() datSysZt = Time Time = cZivilZeit Timer1.Interval = cVerzögerung * 1000 End Sub
' aktuelle Zeit merken ' Kurz vor Feierabend ... ' Timer setzen
Private Sub Timer1_Timer() Timer1.Interval = 0 t = Time
1 23
Funktionen und Anweisungen für Datums- / Zeitwerte
................................................... Verwa ndte Befehle
Funktionen und Anweisungen für Datums- / Zeitwerte
Time = datSysZt + (t – cZivilZeit) If Time < datSysZt Then Date = Date + 1 End End Sub
' Zeit richtig korrigeren ' Mitternachtskorrektur ' und Tschüss
Verwandte Befehle
................................................... Verwa ndte Befehle
Now, Date
Funktionen und Anweisungen für Datums- / Zeitwerte
Timer- Funktion Function Timer() As Single Beschreibung
................................................... Bes c hreibung
Die Funktion Timer liefert die seit Mitternacht (Systemzeit) vergangene Zeit in Sekunden mit Nachkommaanteil als Fließkommawert einfacher Genauigkeit (Windows 9x: in 18tel Sekundenschritten; Windows NT: in 50stel Sekundenschritten). Beispiel
................................................... Beis piel
Siehe die Beispiele zu »Sgn-Funktion« (S. 110). Verwandte Befehle
................................................... Verwa ndte Befehle
Time, Date
TimeSerial- Funktion Function TimeSerial( _ iStd As Integer, iMin As Integer, iSek As Integer) As Date Beschreibung
................................................... Bes c hreibung
Die Funktion TimeSerial generiert aus den Ganzzahlwerten iStd, iMin und iSek einen Datums-/ Zeitwert. Anwendung
................................................... Anwendung
Die Funktion prüft die Werte der Parameter nicht, das heißt, sie löst auch keine Laufzeitfehler aus, wenn die Komponenten keine reelle Zeit ergeben. Ergibt die akkumulierte Zeit einen Wert größer #23:59:59# oder kleiner #0:00:00#, liefert die Funktion gleichzeitig einen Datumsoffset bezogen auf das Referenzdatum 30.12.1899. Auf diese Weise gestattet die Funktion sehr schön das Rechnen mit relativen Zeitangaben wie: »vor 22 Stunden, 97 Minuten und 123 Sekunden«. Beispiel
................................................... Beis piel
cZt = #11:11:11# For iSek = 0 to 400 Step 10 Print TimeSerial(Hour(cZt), Minute(cZt), Second(cZt) + iSek) next iSek Verwandte Befehle
................................................... Verwa ndte Befehle
DatePart, DateSerial
1 24
TimeValue- Funktion
TimeValue- Funktion Function TimeValue(sZeit As String) As Date Beschreibung
................................................... Bes c hreibung
Die Funktion DateValue interpretiert die Zeichenfolge sZeit als Zeitangabe und generiert daraus einen Datums-/Zeitwert. Falls die Zeichenfolge auch Datumsangaben enthält, werden diese nicht berücksichtigt. Anwendung
................................................... Anwendung
Tipp
................................................... Tipp
CDate und TimeValue unterscheiden sich insofern, als CDate auch Werte anderer Datentypen als String in einen Datums-/Zeitwert umsetzt und zusätzlich einen Datumsanteil berücksichtigt. Beispiel
................................................... Beis piel
Alle Zeitangaben notieren die gleiche Zeit: Print Print Print Print Print Print Print
TimeValue("13:0") TimeValue("13:00:00") TimeValue("1 pm") TimeValue("13 pm") TimeValue("13 am") TimeValue("1 PM") TimeValue("13 AM")
' ' ' ' ' ' '
"13:00:00" "13:00:00" "13:00:00" "13:00:00" "13:00:00" "13:00:00" "13:00:00"
Verwandte Befehle
................................................... Verwa ndte Befehle
DateValue, CDate
Weekday- Funktion Function Weekday( _ datDatum As Date, _ [FirstDayOfWeek As VbDayOfWeek = vbSunday]) _ As Integer Beschreibung
................................................... Bes c hreibung
Die Funktion Weekday interpretiert den Datums-/Zeitwert datDatum als Zeitangabe und liefert dazu den Wochentag als Ganzzahl zwischen 1 und 7. Fehlt der optionale Parameter FirstDayOfWeek oder hat er den Wert vbSunday, interpretiert die Funktion den Sonntag als ersten Tag der Woche, ansonsten den Tag, den die Konstante ausdrückt. Warnung
................................................... Wa rnung
Microsoft hat den Standardwert für den Parameter FirstDayOfWeek nicht richtig gewählt, da der Aufruf Weekday(Now) ein falsches Ergebnis liefert. In unseren Sphären gilt der Montag als erster Tag der Woche – wohl aufgrund der biblischen Devise »und am Siebten Tage ruhte der Herr«. Es empfiehlt sich daher, die Funktion mit dem Wert vbMonday für ErsteTagWoche aufzurufen.
1 25
Funktionen und Anweisungen für Datums- / Zeitwerte
Was die Notation der Zeit betrifft, ist TimeValue weitgehend tolerant, solange nur das Trennzeichen »:« erscheint und die Zeitangabe reell ist. So interpretiert die Funktion fehlende Minutenund Sekundenanteile als »00« und kommt auch mit den Zusätzen »am«, »AM«, »pm« und »PM« zurecht, wenn die Zeit in 12-Stunden-Darstellung notiert ist.
Dateiorientierte Funktionen und Anweisungen
Beispiel
................................................... Beis piel
Alle Zeitangaben notieren die gleiche Zeit: Print WeekdayName(Weekday(Now)) Print WeekdayName(Weekday(Now, vbMonday))
' Falscher Wochentag!!! ' Richtiger Wochentag
Verwandte Befehle
................................................... Verwa ndte Befehle
Dateiorientierte Funktionen und Anweisungen
DatePart, DateValue, CDate
WeekdayName- Funktion Function WeekdayName( _ lTag As Long, _ [bAbk As Boolean = False], _ [FirstDayOfWeek As VbFirstDayOfWeek = vbUseSystemDayOfWeek]) _ As String Siehe »WeekdayName-Funktion« (S. 92).
Year- Funktion Function Year(datWert As Date) As Integer Beschreibung
................................................... Bes c hreibung
Die Funktion Year liefert den Jahresanteil des Datums-/Zeitwerts datWert als Ganzzahl zwischen 100 und 9999. Beispiel
................................................... Beis piel
Siehe »Format-Funktion« (S. 69) und das dort vorgestellte Projekt FormatDemo. Verwandte Befehle
................................................... Verwa ndte Befehle
DatePart, Day, Hour, Minute, Month, Second
Dateiorientierte Funktionen und Anweisungen Um es gleich vorwegzunehmen: Visual Basic weist nicht mehr die ursprüngliche Geschlossenheit der Sprache Basic gegenüber dem Dateisystem und der dateibezogenen Ein- und Ausgabe auf. Die Sache ist komplizierter geworden, denn verloren gegangen ist eher wenig, hinzugekommen dagegen viel. Freilich sind da noch die traditionellen Mittel, wohlbekannte Befehle wie Open, Input, Print#, Get, Put und Close, mit denen sich letztlich jeder Datei zu Leibe rücken lässt und die auch eine gesunde Basis für das delikate Thema der Abwärtskompatibilität darstellen. Zudem sind die dateisystembezogenen Befehle ChDir, ChDrive, MkDir, RmDir, Name weiterhin vorhanden. Ja, sie haben sogar noch Gesellschaft in Form recht nützlicher Befehle wie Dir, FileCopy, FileLen, GetAttr und SetAttr usw. erhalten, die man sich zu Zeiten von QBasic etwa noch als entsprechende DOS-Kommandos mit Zeichenfolgenoperationen selbst zusammenbasteln und über die Shell-Anweisung ausführen musste. Darüber hinaus versteht es sich schon fast von selbst, dass Dateinamen inzwischen lang und Pfadangaben UNC-konform (engl.: Universal Naming Convention, dazu gleich mehr) sein können, was letztlich Tür und Tor für den netzwerkweiten Zugriff auf Dateien öffnet, ohne auf logische Laufwerke oder andere Krücken aus der DOSZeit angewiesen zu sein. Damit lässt sich schon was anfangen.
1 26
Dateiorientierte Funktionen und Anweisungen
Bezeichner
Kurzbeschreibung
ChDir
Ändert das aktuelle Arbeitsverzeichnis
ChDrive
Setzt das aktuelle logische Laufwerk
Auf Dateioperationen bezogene Funktionen und Anweisungen
1 27
Dateiorientierte Funktionen und Anweisungen
Komplett neu ist dagegen alles, was der Sprache von der objektorientierten Seite her an Potenzial zuteil geworden ist. So beispielsweise das FileSystemObject-Objekt, das als operative Grundlage des Windows-Explorers ein wahres Füllhorn an Möglichkeiten darstellt, wenn es darum geht, etwas über das Dateisystem in Erfahrung zu bringen, Manipulationen darin vorzunehmen oder auch nur mit Textdateien zu arbeiten. Zudem ist das Tor weit offen für beliebige Erweiterungen in dieser Richtung – es steht Ihnen frei, Ihre ganz persönliche Klassenbibliothek für dateibezogenene Operationen zu schreiben und fortan alle Dateizugriffe über die darin definierten Objekte abzuwickeln. Das könnte beispielsweise den Vorteil haben, dass diese Objekte Ihren Anwendungen den ganzen Ballast logistischer und formaler Natur abnehmen, den bestimmte Dateiformate so mit sich bringen. Paradebeispiel für diesen Ansatz sind die Anweisungen LoadPicture, SavePicture, Load und Unload. (Wer genau hinsieht, wird erkennen, dass zumindest die ersten drei Anweisungen in BLoad und BSave ihre Vorläufer hatten). So bequem solche Operationen auch sind, ihre Implementation – und da beißt die Maus keinen Faden ab – lebt letztlich wieder von den erwähnten traditionellen Mitteln des Dateizugriffs, es sei denn, man kann dafür von entsprechenden – zumeist in C oder C++ geschriebenen – Bibliotheksroutinen profitieren oder gar von Betriebssystemroutinen aus der reichhaltigen Windows API (vgl. hierzu »Routinen aus DLLs und der Windows-API einsetzen«, S. 185). Ein etwas konsequenterer Ansatz, der der Idee der objektorientierten Programmierung näher steht, besteht darin, die im Programm verwendeten Datenstrukturen selbst als Objekte zu verpacken und ihnen Operationen wie SaveMyObject und LoadMyObject zu spendieren. Ein komplexes Objekt, das seinerseits verschiedene Objekte als Elemente enthält, wird in seiner SaveMethode dann schlicht die Save-Methoden dieser Objekte aufrufen usw. Wann immer aber – und das gilt auf letzter Ebene für alle Objektrepräsentationen – die Werte elementarer Datentypen zu speichern sind, geht es ans »Eingemachte«, und die traditionellen Mittel sind wieder gefragt. Das alles ist aber noch nicht genug. Tatkräftige Unterstützung gibt es auch noch vonseiten der Steuerelemente. Da wären schon mal die Standardsteuerelemente der Klassen FileListBox und DriveListBox, die eine interaktive Auswahl von Dateien und logischen Laufwerken ermöglichen. Da wären die Standarddialoge, die eine große Hilfe beim Öffnen und Speichern von Dateien darstellen und eine Fülle von Operationen so ganz nebenbei und kostenlos mit sich bringen (vgl. »Standarddialoge-Steuerelement (CommonDialog)«, S. 444). Und nicht zuletzt wäre da auch noch die schier unerschöpfliche Fülle an Möglichkeiten, mittels so genannter Datenquellen (Data-Steuerelement, RemoteData-Steuerelement, ADO-Daten-Steuerelement, ADORecordset-Objekte) sowie DAO- und ADO-Objekten mit Daten zu hantieren, die in Datenbanken organisiert sind. Nicht nur weil die historische Entwicklung der Sprache Basic es so hervorgebracht hat, sondern auch weil es der Aufbau dieses Buches so will, geht es erst im Kapitel »Objekte und Klassen« (S. 195) um die Dateioperationen von Objekten – und da eher nur am Rande. Ein wenig über den Umgang mit Datenbanken finden Sie im Abschnitt »Data-Datensteuerelement (Data)« (S. 402). Wer aber die in diesem Abschnitt vorgestellte traditionelle Grundlage aller Dateioperationen kennt und verstanden hat, wird auf der objektorientierten Seite keine Not haben, beides miteinander zu verheiraten. Die folgende Tabelle gibt einen Überblick über die traditionellen Funktionen und Anweisungen, die unmittelbar oder mittelbar etwas mit Dateizugriffen zu tun haben.
Dateiorientierte Funktionen und Anweisungen
Dateiorientierte Funktionen und Anweisungen
Bezeichner
Kurzbeschreibung
Close
Schließt eine oder mehrere zuvor geöffnete Dateien
CurDir
Liefert das aktuelle Arbeitsverzeichnis auf dem angegebenen logischen Laufwerk
Dir
Liefert den nächsten Dateinamen, der auf ein Suchmuster passt
Environ
Liefert eine oder alle Umgebungsvariablen
EOF
Testet, ob das Dateiende erreicht ist
FileAttr
Ermittelt den Öffnungsmodus einer Datei
FileCopy
Kopiert eine Datei
FileDateTime
Liefert den Zeitpunkt der Erstellung bzw. letzten Änderung einer Datei als Datums-/Zeitwert
FileLen
Liefert die Länge einer Datei in Bytes
FreeFile
Liefert die nächste freie Dateinummer
Get
Liest Daten aus einer indexsequenziellen Datei oder Binärdatei
GetAttr
Liefert die Attribute einer Datei oder eines Ordners bzw. Verzeichnisses
Input
Liest die angegebene Anzahl an Zeichen aus einer Datei und liefert diese als Unicode-Zeichenfolge
Input #
Liest den Wert einer oder mehrerer Variablen aus einer Textdatei
InputB
Liest die angegebene Anzahl an Bytes aus einer Datei und liefert diese als Bytearray (ANSI-Zeichenfolge)
Kill
Löscht alle Dateien, die auf das angegebene Suchmuster passen
Line Input #
Liest eine Zeile aus einer geöffneten sequenziellen Datei in eine Variable vom Typ String ein
Loc
Liefert die aktuelle Schreib- bzw. Leseposition (Byte-Nummer) einer geöffneten Datei
Lock
Regelt die Zugriffsmöglichkeiten anderer Programme auf eine bereits geöffnete Datei
LOF
Liefert die Länge einer Datei in Bytes
LSet
Zuweisungsoperation, die Daten beliebiger Datentypen für die Ausgabe in eine Datei als Zeichenfolge aufbereitet
MkDir
Generiert ein neues Verzeichnis
Name
Benennt eine Datei um oder verschiebt diese in ein anderes Verzeichnis
Open
Öffnet eine Datei zum Lesen oder Schreiben
Print#
Schreibt Daten im gebietsspezifischen Format in eine sequenzielle Datei
Put
Schreibt Daten in eine indexsequenzielle Datei oder Binärdatei
Reset
Schließt alle geöffneten Dateien
RmDir
Löscht ein Verzeichnis
Seek
Liefert die aktuelle Schreib- oder Leseposition in einer geöffneten Datei
Auf Dateioperationen bezogene Funktionen und Anweisungen
1 28
Dateiorientierte Funktionen und Anweisungen
Bezeichner
Kurzbeschreibung
Seek
Setzt die aktuelle Schreib- oder Leseposition in einer geöffneten Datei
SetAttr
Setzt ein oder mehrere Attribute für eine Datei oder ein Verzeichnis
Shell
Startet eine andere Anwendung und liefert deren Task-ID
Unlock
Regelt die Zugriffsmöglichkeiten anderer Programme auf eine bereits geöffnete Datei
Write#
Schreibt Daten in standardisiertem Format in eine sequenzielle Datei
UNC- Pfad und Laufwerkspfad Ein wichtige Größe im Umgang mit Dateien ist ihre Position im lokalen Dateisystem respektive im Netzwerk. Um eine irgendwo im Netzwerk (das kann auch auf dem lokalen System sein) gelegene Datei anzusprechen, geben Sie den UNC-Pfad der Datei an, der nach folgendem Schema notiert wird: \\Server\Freigabe\[Verzeichnis ... \]Dateiname.Erw
Liegt die Datei dagegen auf dem lokalen Computer oder existiert für seine im Netzwerk gelegene Position eine Netzlaufwerkverbindung, die der betreffenden Freigabe einen Laufwerksbuchstaben Laufw zuordnet, lässt sie sich auch über ihren traditionellen Laufwerkspfad ansprechen. Laufw:\[Verzeichnis ... \]Dateiname.Erw
Beide Pfadangaben können nach allen Regeln der Kunst absolut oder relativ zum jeweils aktuellen Arbeitsverzeichnis sein; der Unterschied zwischen beiden besteht eigentlich nur darin, dass der absolute Laufwerkspfad einen Laufwerksbuchstaben mit nachfolgenden Doppelpunkt hat, wo der absolute UNC-Pfad einen Servernamen und eine Freigabe enthält.
Fehler und deren Behandlung »Wo gehobelt wird, fallen Späne«. Da Dateioperationen sozusagen aus der geschlossenen Welt eines Programms hinausführen und mit anderen Programmen am Gerangel um Gemeingut (gemeinsam genutzte Ressourcen) teilnehmen, ist es völlig normal, dass zur Laufzeit Fehler auftreten können, die zur Entwurfszeit nicht absehbar waren. Die zu solchen Fehlern führenden Konstellationen sind recht vielfältig, so dass man sich beim Programmentwurf einer stattlichen Anzahl möglicher Laufzeitfehler gegenüber sieht, die es einzukalkulieren gilt. Hier einige der Ursachen für häufige Fehler: Nr.
Fehlermeldung
Mögliche Ursachen
52
Dateiname oder -nummer Der Dateiname einer anzulegenden Datei entspricht nicht falsch der Konvention für Dateinamen. Ihr Programm hat nicht das Recht, die Datei auf einer Freigabe anzulegen, (z.B. weil das Kennwort nicht richtig ist). Die verwendete Dateinummer wurde entweder durch eine Close-Anweisung bereits freigegeben oder nie im Rahmen einer Open-Anweisung vergeben, etwa weil diese gescheitert ist.
Häufige Laufzeitfehler im Zusammenhang mit Dateioperationen
1 29
Dateiorientierte Funktionen und Anweisungen
Auf Dateioperationen bezogene Funktionen und Anweisungen
Dateiorientierte Funktionen und Anweisungen
Dateiorientierte Funktionen und Anweisungen
Nr.
Fehlermeldung
Mögliche Ursachen
53
Datei nicht gefunden
Die Datei kann nicht geöffnet werden, weil sie nicht existiert.
55
Datei bereits geöffnet
Die Datei kann nicht geöffnet werden, weil sie bereits geöffnet ist. Passiert bei Open, Name, FileCopy, SetAttr, Kill.
57
Fehler beim Lesen von/ Schreiben auf Gerät
Das Ein- bzw. Ausgabegerät enthält einen defekten Datenträger oder die Netzwerkverbindung ist während der Dateioperation zusammengebrochen.
58
Datei existiert bereits
Sie versuchen, eine Datei mit Name umzubenennen, der angegebene Dateiname ist aber bereits an eine andere Datei vergeben.
61
Datenträger voll
Der freie Platz auf einer Diskette, Festplatte oder Netzwerkfreigabe reicht für die Durchführung der Operation nicht aus.
62
Einlesen hinter Dateiende
Die Dateioperation passt nicht zu dem Modus, in dem die Datei geöffnet wurde. Beispielsweise dürfen Sie EOF nicht im Modus Binary und die Funktion Input nicht im Modus Input verwenden.
70
Zugriff verweigert
Sie haben versucht, auf eine Datei oder einen Datensatz zuzugreifen, die bzw. der von einem anderen Prozess gesperrt wurde, oder es fehlt das Schreibrecht, um auf dem entsprechenden Datenträger zu schreiben.
71
Datenträger nicht bereit
Im angegebenen Laufwerk befindet sich kein Datenträger oder das Laufwerk wurde nicht verriegelt.
75
Fehler beim Zugriff auf Pfad/Datei
Das Format der Pfadangabe ist nicht korrekt, das Ausgabegerät unterstützt keine Schreiboperationen oder die Datei ist schreibgeschützt.
76
Pfad nicht gefunden
Der angegebene Pfad existiert nicht oder der Server, der ihn freigibt, ist nicht am Netz.
Häufige Laufzeitfehler im Zusammenhang mit Dateioperationen
In Form der On Error GoTo-Anweisung stellt Basic ein Mittel bereit, solchen Laufzeitfehlern zu begegnen. Mehr darüber finden Sie im Abschnitt »Fehlerbehandlung« (S. 43).
Dateien Um in Visual Basic eine Datei mit traditionellen Mitteln bearbeiten zu können, muss sie zunächst durch eine Open-Anweisung geöffnet werden – ein Vorgang, der unter anderem die Zugriffsrechte anderer Prozesse auf diese Datei einschränken kann und ihr eine logische Dateinummer zuordnet. Diese Dateinummer ist für alle folgenden Operationen anzugeben, die mit dieser Datei in Zusammenhang stehen. Die Zugriffsrechte auf die Datei oder Teile der Datei lassen sich auch danach noch mittels Lock- und Unlock-Anweisungen entsprechend den Erfordernissen handhaben. Sobald kein weiterer Zugriff auf die Datei mehr erfolgt, kann sie mittels Close geschlossen werden. Diese Operation schreibt gegebenenfalls noch nicht geschriebene Pufferinhalte und gibt die Dateinummer wieder frei.
1 30
ChDir- Anweisung
ChDir- Anweisung ChDir sPfad Beschreibung
................................................... Bes c hreibung
Windows kennt und pflegt in der Systemumgebung eines Programms für jedes Laufwerk ein aktuelles Arbeitsverzeichnis. Das standardmäßige Arbeitsverzeichnis (vgl. »CurDir-Funktion«, S. 134) ist das aktuelle Arbeitsverzeichnis auf dem standardmäßigen Laufwerk (vgl. »ChDriveAnweisung«, S. 132). Die Anweisung ChDir setzt sPfad als neues aktuelles Arbeitsverzeichnis auf dem in sPfad spezifizierten Laufwerk. Enthält sPfad keine Laufwerksspezifikation, setzt die Funktion das standardmäßige Arbeitsverzeichnis auf sPfad. Anwendung
................................................... Anwendung
Ist der in sPfad spezifizierte Pfad nicht existent, löst die Funktion den Laufzeitfehler 76, »Pfad nicht gefunden« aus. Solange das standardmäßige Arbeitsverzeichnis lokal auf dem Computer liegt, zeigt ChDir bei Angabe eines UNC-Pfads für sPfad keine Wirkung – meldet aber auch keinen Fehler. Ergibt sich dagegen die Situation, dass das standardmäßige Arbeitsverzeichnis auf einem anderen Computer liegt (vgl. »CurDir-Funktion«, S. 134) und somit bereits ein UNCPfad ist, kommt ChDir auch bei Angabe eines UNC-Pfads seiner Aufgabe nach. Warnung
................................................... Wa rnung
Mit dem UNC-Pfad ist das so eine Sache. Wie unter CurDir näher ausgeführt, besteht zwar die Möglichkeit, das standardmäßige Arbeitsverzeichnis von vornherein als UNC-Pfad zu erhalten, Visual Basic sieht aber keine Mittel vor, das standardmäßige Arbeitsverzeichnis, sofern es einmal auf ein lokales Verzeichnis gesetzt wurde, wieder auf einen anderen Computer (etwa einen File Server) im Netzwerk zu verlagern, sprich: in einen UNC-Pfad umzuwandeln. Damit könnte man natürlich leben, wenn sich ChDir darauf beschränken würde, ein UNC-Arbeitsverzeichnis bei Angabe eines UNC-Pfades als UNC-Arbeitsverzeichnis beizubehalten. Leider ist das jedoch
1 31
Dateiorientierte Funktionen und Anweisungen
Was die Dateioperationen betrifft, so ist zu beachten, dass Basic traditionell drei Dateikonzepte unterstützt, die sich darin unterscheiden, welche Art von Information gespeichert wird und wie der Zugriff auf diese Information erfolgt: die sequenzielle Datei (auch Textdatei genannt), die indexsequenzielle Datei und die Binärdatei. Für jede dieser Dateiarten gibt es spezifische Operationen, die speziell auf ihren Zweck zugeschnitten sind. Sequenzielle Dateien enthalten durch spezifische Trennzeichen voneinander abgetrennte Zeichenfolgen, die textuelle Repräsentationen von Werten unterschiedlicher Datentypen darstellen. Zum Schreiben dieser Werte verwendet man die Anweisungen Print# und Write#, wobei erstere die gebietsspezifische Zeichenfolgendarstellung eines Werts generiert und letztere die internationale. Das Lesen besorgt dagegen die Anweisung Input# oder – wenn auch die Trennzeichen gelesen werden sollen – die Funktion Input. Im speziellen Fall von Textdateien ermöglicht die Anweisung Line Input# das zeilenweise Lesen. Indexsequenzielle Dateien enthalten eine Folge von Datensätzen. Da alle Datensätze eine feste Länge aufweisen, kann Basic die Position eines bestimmten Datensatzes aus der Datensatznummer und der Datensatzlänge errechnen, so dass keine Trennzeichen notwendig sind. Das Schreiben von Datensätzen besorgt die Anweisung Get und das Lesen die Anweisung Put. Binärdateien liegt dagegen a priori keine bestimmte Interpretation zugrunde. Sie werden als einfache Aneinanderreihung von Bytes behandelt, und es unterliegt der Verantwortung des Programms, sie zu einzelnen Werten für Variablen der unterschiedlichen Datentypen zu gruppieren. Als Leseoperationen stehen dafür die Funktion Input und die Anweisung Get zur Verfügung und als Schreiboperation die Anweisung Put.
Dateiorientierte Funktionen und Anweisungen
nicht so: ChDir setzt bei Angabe eines UNC-Pfads, der in das Dateisystem des lokalen Computers führt, ungefragt den Laufwerkspfad. Beispiele
................................................... Beis piele
Dateiorientierte Funktionen und Anweisungen
Angenommen das Programm, das den folgenden Code enthält, ist im Verzeichnis C:\VB-Programme gelegen und wird über den Explorer gestartet: Print App.Path Print CurDir ChDir ".." Print CurDir ChDir "Windows" Print CurDir ChDir "C:\VB-Programme" Print CurDir ChDir "D:\Eigene Dateien" Print CurDir ChDrive "D" Print CurDir
' ' ' ' ' ' ' ' ' ' ' '
C:\VB-Programme C:\VB-Programme (wie App.Path) Ein Verzeichnis höher C:\ relativer Pfad C:\Windows absoluter Pfad auf Standardlaufwerk C:\VB-Programme absoluter Pfad auf Nicht-Standardlaufwerk C:\VB-Programme (C ist Standardlaufwerk) erst jetzt ändert sich Standardlaufwerk D:\Eigene Dateien (D ist Standardlaufwerk)
Angenommen das Programm, das den folgenden Code enthält, liegt im Verzeichnis \\Adler\c\VB-Programme\ und wird über die Netzwerkumgebung des Explorers gestartet: Print Print ChDir Print ChDir Print ChDir Print
App.Path CurDir ".." CurDir "Windows" CurDir "C:\VB-Programme" CurDir
' ' ' ' ' ' ' '
\\Adler\c\VB-Programme\ \\Adler\c\VB-Programme\ (wie App.Path) Ein Verzeichnis höher \\Adler\c\ relativer Pfad \\Adler\c\windows UNC-Pfad ist ab jetzt verloren C:\VB-Programme
Verwandte Befehle
................................................... Verwa ndte Befehle
ChDrive, CurDir
ChDrive- Anweisung Sub ChDrive (sLaufw As String) Beschreibung
................................................... Bes c hreibung
Windows kennt und pflegt in der Systemumgebung eines Programms für jedes Laufwerk ein aktuelles Arbeitsverzeichnis. Die Anweisung ChDrive setzt das erste Zeichen von sLaufw als neues aktuelles Laufwerk. Das aktuelle Arbeitsverzeichnis auf diesem Laufwerk wird damit zum standardmäßigen Arbeitsverzeichnis. Anwendung
................................................... Anwendung
Ist sLaufw eine leere Zeichenfolge, ändert ChDrive das aktuelle Laufwerk nicht, meldet aber auch keinen Fehler. Existiert das erste Zeichen von sLaufw nicht als logisches Laufwerk, löst die Funktion den Laufzeitfehler 68, »Gerät nicht verfügbar«, aus.
1 32
Close- Anweisung
Warnung
................................................... Wa rnung
Ergibt sich die Situation, dass das standardmäßige Arbeitsverzeichnis auf einem anderen Computer liegt (vgl. »CurDir-Funktion«, S. 134) und somit durch einen UNC-Pfad beschrieben wird, geht dieser mit dem nächsten Aufruf von ChDrive unwiederbringlich verloren, das heißt, als standardmäßiges Arbeitsverzeichnis lassen sich fortan nur noch Verzeichnisse einstellen, auf die der Zugriff über ein logisches Laufwerk erfolgen kann. Beispiel
................................................... Beis piel
Siehe das Beispiel zu »ChDir-Anweisung« (S. 131).
................................................... Verwa ndte Befehle
ChDir, CurDir
Close- Anweisung Close [#]iDateiNr[, [#]DateiNr1, ...] Beschreibung
................................................... Bes c hreibung
Die Anweisung Close schließt die unter den Dateinummern iDateiNr, iDateiNr1 usw. (mittels Open) geöffneten Dateien oder Geräte. Gegebenenfalls existierende Schreibpuffer werden zuvor herausgeschrieben. Wird der Befehl ohne Parameter aufgerufen, schließt er alle mit Dateinummern assoziierten Dateien und Geräte. Anwendung
................................................... Anwendung
Bevor ein Programm mit traditionellen Mitteln auf eine Datei oder ein Gerät zugreifen kann, muss es eine Open-Anweisung durchführen, die der Datei eine Dateinummer zuordnet und gegebenenfalls Pufferspeicher organisiert. Aus Gründen der Effizienz puffert Visual Basic alle Schreib- und Leseoperationen für Dateien, die im Input-, Output- oder Append-Modus geöffnet wurden, und führt sie blockweise aus. Das hat unter anderem die Folge, dass Schreiboperationen wie Print# ihre Daten nicht direkt auf den Datenträger schreiben, sondern immer erst, wenn der Schreibpuffer voll ist. Der Befehl Close hat nun folgende Funktionen: Er bewirkt für jede genannte Dateinummer ein explizites Herausschreiben gegebenenfalls noch gefüllter Schreibpuffer mit nachfolgender Freigabe des Puffers und der Dateinummer. Die Freigabe einer Dateinummer durch Close hebt gleichzeitig alle Zugriffsbeschränkungen auf, die für die betreffende Datei mittels Open und Lock getroffen wurden. Entgegen anders lautenden Informationen in der Online-Hilfe zu Visual Basic entfernt Close alle Sperren, die mit Lock gesetzt und nicht explizit mit Unlock freigegeben wurden. Tipp
................................................... Tipp
Zwar schließt ein Visual-Basic-Programm bei Beendigung von sich aus alle Dateien und Geräte durch einen impliziten Close-Aufruf, dennoch ist es guter defensiver Programmierstil, eine Datei unmittelbar, nachdem der letzte Zugriff darauf erfolgt ist, wieder zu schließen. Das verkürzt die Einschränkungen, denen andere Programme in Bezug auf diese Datei ausgesetzt sind, auf ein Minimum. Beispiel
................................................... Beis piel
Der folgende Code lässt sich in einem Programm einsetzen, dessen Aufrufe protokolliert werden sollen:
1 33
Dateiorientierte Funktionen und Anweisungen
Verwandte Befehle
Dateiorientierte Funktionen und Anweisungen
Open "Aufrufe.log" For Append As 1 Print #1, "Aufruf am "; Now Close 1 Verwandte Befehle
................................................... Verwa ndte Befehle
Open
CurDir- Funktion
Dateiorientierte Funktionen und Anweisungen
Function CurDir[(sLaufw As String)] As String Beschreibung
................................................... Bes c hreibung
Windows kennt und pflegt in der Systemumgebung eines Programms für jedes Laufwerk ein aktuelles Arbeitsverzeichnis und ein aktuelles Laufwerk. Im Allgemeinen ist das standardmäßige Arbeitsverzeichnis dann das aktuelle Arbeitsverzeichnis auf dem aktuellen Laufwerk. Die Funktion CurDir liefert das aktuelle Arbeitsverzeichnis auf dem Laufwerk sLaufw. Fehlt der optionale Parameter sLaufw, liefert die Funktion das standardmäßige Arbeitsverzeichnis. Anwendung
................................................... Anwendung
Unmittelbar nach Programmstart entspricht das standardmäßige Arbeitsverzeichnis dem Verzeichnis, aus dem heraus der Start erfolgt ist. Erfolgt der Start direkt durch Aufruf der ausführbaren Datei aus einem Fenster des Explorers heraus, deckt sich das Arbeitsverzeichnis mit dem Programmverzeichnis (vgl. »App.Path-Eigenschaft«, S. 264). Wird der Programmstart dagegen von einem anderen Programm veranlasst, erbt das Visual-Basic-Programm schlicht das standardmäßige Arbeitsverzeichnis des Aufrufers. Das ist so, wenn der Aufruf aus einem Kommandozeileninterpreter oder Scripting-Host heraus erfolgt, wenn er von einem anderen Visual-Basic-Programm aus mittels einer Shell-Anweisung erfolgt oder wenn er über eine Verknüpfung führt, in deren Eigenschaften unter AUSFÜHREN IN ein anderer Pfad als das Programmverzeichnis eingetragen ist. Das ist aber auch so, wenn das standardmäßige Arbeitsverzeichnis des Aufrufers auf einem anderen Computer im Netzwerk liegt. In diesem Fall lässt sich das standardmäßige Verzeichnis nur als UNC-Pfad notieren, wenn es kein logisches Laufwerk für die entsprechende Freigabe gibt. Warnung
................................................... Wa rnung
Ist das standardmäßige Verzeichnis einmal ein Laufwerkspfad, lassen sich fortan nur noch solche Verzeichnisse als standardmäßiges Arbeitsverzeichnis setzen, die über ein logisches Laufwerk ansprechbar sind. UNC-Pfade sind nicht mehr möglich. Tipp
................................................... Tipp
Beim Öffnen von Dateien, für die kein absoluter Pfad spezifiziert ist, bezieht sich Visual Basic auf das ererbte Arbeitsverzeichnis. Das aber kann mal so und mal so aussehen, je nach dem, ob das Programm in der Entwicklungsumgebung, als kompilierte Fassung, über eine Verknüpfung oder aus einem Explorer-Fenster heraus gestartet wurde. Als probates Mittel, um einen definierten und situationsunabhängigen Ausgangspunkt für das Laden von Hilfsdateien zu erhalten, empfiehlt es sich, entsprechende Pfadangaben auf die Exe-Datei zu beziehen und das standardmäßige Arbeitsverzeichnis via ChDir auf den Wert von App.Path zu setzen. Beispiel
................................................... Beis piel
Siehe »ChDir-Anweisung« (S. 131)
1 34
Dir- Funktion
Verwandte Befehle
................................................... Verwa ndte Befehle
ChDir, ChDrive
Dir- Funktion Function Dir [(sSuchmuster As String, _ [Attributvkt As VbFileAttribute = vbNormal])] As String Beschreibung
................................................... Bes c hreibung
Anwendung
................................................... Anwendung
Die überaus nützliche Funktion Dir vereinigt in sich das Funktionsschema der Win32-APIFunktionen FindFirstFile, FindNextFile und FindClose. Um alle Dateinamen in einem Verzeichnis zu erhalten, die auf ein gegebenes Suchmuster passen und darüber hinaus bestimmte Attribute aufweisen, legen Sie mit dem ersten Aufruf von Dir das Suchmuster und gegebenenfalls den Attributvektor fest und rufen Dir ab dann so oft parameterlos auf, bis die Funktion die leere Zeichenfolge liefert. Das Suchmuster besteht aus einem Pfadanteil (absolut oder relativ notiert) und einem Dateianteil, wobei der Pfadanteil das Verzeichnis spezifiziert, das durchsucht wird, und der Dateianteil ein Dateinamensmuster, das auch die Platzhalter »?« (Zeichen an dieser Stelle wird nicht unterschieden) und »*« (Zeichen ab dieser Stelle werden nicht unterschieden) enthalten kann. Fehlt der Pfadanteil oder ist er relativ notiert, bezieht die Funktion den Pfad auf das standardmäßige Arbeitsverzeichnis (vgl. »CurDir-Funktion«, S. 134). Um den Namen eines Datenträgers zu erfahren, geben Sie das Stammverzeichnis des Laufwerks als Suchmuster an (z.B. C:\) und die Konstante vbVolume als Attributvektor. In anderen Pfaden hat vbVolume keine Wirkung. Die in der VbFileAttribute-Aufzählung enthaltene Konstante vbAlias ist für zukünftige Zwecke definiert. Unter Visual Basic 6.0 (SP3) löst sie einen Laufzeitfehler aus. Warnungen
................................................... Wa rnungen Da diese Funktion in der von Microsoft stammenden Dokumentation recht lieblos abgehandelt wurde, ist viel Falsches darüber zu lesen, insbesondere was den Attributvektor betrifft. Richtig ist: Die Funktion schränkt die Ergebnismenge nicht auf Dateien mit bestimmten Attributen ein, sondern sie erweitert die zu vbNormal gehörige Ergebnismenge um die Dateien, die eines der im Attributvektor genannten zusätzlichen Attribute tragen. Die mit Visual Basic vorliegende Implementation von Dir ist nicht für den rekursiven Aufruf geeignet. Das Beispiel zu »RmDir-Anweisung» (S. 155) zeigt einen Work-around. Ein Beispiel für eine alternative Implementation, die speziell für rekursive Prozeduren geeignet ist, finden Sie im Abschnitt »Routinen aus DLLs und der Windows-API einsetzen« (S. 185).
1 35
Dateiorientierte Funktionen und Anweisungen
Die Funktion Dir kennt zwei unterschiedliche Arbeitsmodi. Wird sie unter Angabe eines Werts für den optionalen Parameter sSuchmuster aufgerufen, interpretiert sie diesen als Suchmuster für Dateinamen und liefert den ersten Dateinamen, der passt. Passt das Suchmuster auf keinen Dateinamen, gibt sie die leere Zeichenfolge zurück. Wird die Funktion Dir, nachdem sie einmal mit Suchmuster aufgerufen wurde, ohne den optionalen Parameter sSuchmuster aufgerufen, liefert sie den jeweils nächsten Dateinamen, der auf das Suchmuster passt. Der zweite optionale Parameter Attributvkt ermöglicht die Angabe eines Attributvektors, der die Ergebnismenge um Dateien mit entsprechenden Attributen erweitert(!).
Dateiorientierte Funktionen und Anweisungen
Tipp
................................................... Tipp
Falls Sie sich nur für Dateien mit bestimmten Attributen interessieren, übergeben Sie Dir diese Attribute als Attributvektor und filtern dann die gewünschten Dateien mittels GetAttr aus der von Dir gelieferten Ergebnismenge selbst heraus. Beispiel
................................................... Beis piel
Dateiorientierte Funktionen und Anweisungen
Das folgende Codefragment liefert alle Dateien im Verzeichnis C:\Eigene Dateien, deren Dateiname mit »T« beginnt, mindestens zwei Zeichen enthält und die Erweiterung »txt« trägt: sDatName = Dir("C:\Eigene Dateien\T?*.txt") While sDatName <> "" Print sDatName Dir Wend
Und dieses Codefragment liefert nur die Dateien aus dem Verzeichnis C:\, die verborgen und schreibgeschützt sind: Attr = vbHidden + vbReadOnly Pfad = "C:\" sDatName = Dir(Pfad + "*.*", Attr) While sDatName <> "" If (GetAttr(Pfad + sDatName) And Attr) = Attr Then ' Filter Print sDatName End If sDatName = Dir Wend Verwandte Befehle
................................................... Verwa ndte Befehle
ChDir, CurDir, FileDateTime, GetAttr Verwandte Themen
................................................... Verwandte Them en
Routinen aus DLLs und der Windows-API einsetzen (S. 185)
Environ- Funktion Function Environ(sEnvVar As String) Function Environ(iEnvIndex As Integer) Beschreibung
................................................... Bes c hreibung
Wird die Funktion Environ mit einer Zeichenfolge als Parameter aufgerufen, spezifiziert sEnvVar den Namen einer Umgebungsvariablen. Environ liefert dann den Wert dieser Umgebungsvariablen oder die leere Zeichenfolge, wenn diese nicht bekannt ist. Bei Aufruf der Funktion mit einem Zahlenwert liefert die Funktion dagegen die durch iEnvIndex spezifizierte Zeile aus der Umgebungsdefinition oder die leere Zeichenfolge, falls die Umgebungsdefinition weniger Zeilen umfasst.
1 36
EOF- Funktion
Anwendung
................................................... Anwendung
Auch wenn diese Funktion nicht unmittelbar etwas mit Dateizugriffen zu tun hat, mittelbar hat sie es schon, weil sie Informationen über vordefinierte Pfade (PATH, TEMP, TMP, windir, winbootdir usw.) liefert. Beispiel
................................................... Beis piel
Der folgende Code gibt die gesamte Umgebungsinformation eines Programms aus:
Vgl. auch das Beispiel zu »Kill-Anweisung« (S. 144).
EOF- Funktion Function EOF(iDateiNummer As Integer) As Boolean Beschreibung
................................................... Bes c hreibung
Die Funktion EOF liefert True, wenn das Dateiende einer unter der Nummer iDateiNummer geöffneten Datei beim Lesen erreicht ist, ansonsten False. Anwendung
................................................... Anwendung
Leseoperationen auf Dateien können nur so lange durchgeführt werden, bis das Dateiende erreicht ist. Um festzustellen, ob dies der Fall ist, wird die Funktion EOF eingesetzt. Bei Dateien, die mit dem Zugriffsmodus Input geöffnet wurden, liefert sie False, wenn die letzte Leseoperation (meist Line Input #) durch das Ende der Datei beendet wurde. Im Zusammenhang mit den Zugriffsmodi Binary und Random liefert sie True, wenn die letzte Leseoperation (Input bzw. Get) aufgrund des Dateiendes nicht oder nicht vollständig ausgeführt werden konnte. Warnung
................................................... Wa rnung
Die Online-Hilfe zu EOF bezichtigt diese Funktion, Laufzeitfehler zu produzieren, wenn sie im Zugriffsmodus Binary für die Kontrolle der Input-Funktion benutzt wird. Das ist falsch. Input ist so implementiert, dass es im Modus Binary generell keinen Laufzeitfehler auslöst. Zu einem Laufzeitfehler kann es dagegen kommen, wenn EOF im Zugriffsmodus Input für die Kontrolle der Funktion Input benutzt wird und diese mehr als ein Zeichen je Aufruf liest. Beispiel
................................................... Beis piel
Der folgende Code liest die Textdatei Scandisk.log zeilenweise für die Ausgabe durch Print: Open "c:\scandisk.log" For Input As 1 While Not EOF(1) Line Input #1, sZeile Print sZeile Wend Close 1
1 37
Dateiorientierte Funktionen und Anweisungen
i = 1 While Environ(i) <> "" Print Environ(i) i = i + 1 Wend
Dateiorientierte Funktionen und Anweisungen
Verwandte Befehle
................................................... Verwa ndte Befehle
LOF, Loc, Get, Input, Line Input, Open, Seek
FileAttr- Funktion Function FileAttr(iDateiNummer As Integer[, iTyp As Integer = 1]) Beschreibung
Dateiorientierte Funktionen und Anweisungen
................................................... Bes c hreibung
Die Funktion FileAttr liefert eine Aussage darüber, in welchem Modus die zu der Dateinummer iDateiNummer gehörige Datei geöffnet wurde. Es sind folgende Funktionswerte möglich: 1 steht für Input, 2 für Output, 4 für Random, 8 für Append und 32 für Binary. Anwendung
................................................... Anwendung
Der zweite, optionale Parameter wird nur noch aus Kompatibilitätsgründen mitgeschleppt. Er hatte eine Bedeutung, als es noch 16-Bit-Systeme gab. Auf 32-Bit-Systemen muss er 1 sein. Beispiel
................................................... Beis piel
Open sDatei For Binary As 2 Print FileAttr(2) Close2
' Ausgabe: 32
Verwandte Befehle
................................................... Verwa ndte Befehle
Open
FileCopy- Anweisung Sub FileCopy(sQuellDatei As String, sZielDatei As String) Beschreibung
................................................... Bes c hreibung
Die Anweisung FileCopy erstellt eine Kopie der Datei sQuellDatei als sZielDatei. Anwendung
................................................... Anwendung
Es versteht sich, dass sQuellDatei einen gültigen Pfad zu einer existierenden Datei und sZielDatei einen gültigen Pfad mit gültigem Dateinamen enthalten müssen. Die Funktion löst verschiedene Laufzeitfehler aus – so den Laufzeitfehler 76, wenn mit den Pfaden etwas nicht in Ordnung ist, den Laufzeitfehler 53, wenn die Datei nicht existiert, und den Laufzeitfehler 55, wenn die Datei zum Schreiben geöffnet wurde. Warnung
................................................... Wa rnung
Sollte unter dem Dateinamen sZielDatei bereits eine andere Datei existieren, wird diese kommentarlos überschrieben. Beispiel
................................................... Beis piel
FileCopy sQuellDatei, sZieldatei Verwandte Befehle
................................................... Verwa ndte Befehle
Kill, Name
1 38
FileDateTime- Funktion
FileDateTime- Funktion Function FileDateTime(sDatei As String) As Date Beschreibung
................................................... Bes c hreibung
Die Funktion FileDateTime liefert das letzte Änderungsdatum bzw. das Erstellungsdatum der Datei oder des Verzeichnisses sDatei als Datums-/Zeitwert. Beispiel
................................................... Beis piel
Print FileDateTime ("C:\Windows")
' Datum der Windows-Installation
................................................... Verwa ndte Befehle
FileLen, GetAttr
FileLen- Funktion Function FileLen(sDatei As String) As Long Beschreibung
................................................... Bes c hreibung
Die Funktion FileDateTime liefert die Länge der Datei sDatei in Bytes. Spezifiziert sDatei ein Verzeichnis, gibt die Funktion den Wert 0 zurück. Anwendung
................................................... Anwendung
Ein Aufruf dieser Funktion für eine zum Schreiben geöffnete Datei liefert die Länge der Datei, bevor diese zum Schreiben geöffnet wurde. Die aktuelle Länge einer bereits geöffneten Datei ermittelt die Funktion LOF. Beispiel
................................................... Beis piel
Print FileLen("C:\Msdos.sys")
' muss größer 1024 Bytes sein
Verwandte Befehle
................................................... Verwa ndte Befehle
FileDateTime, GetAttr, LOF
FreeFile- Funktion Function FreeFile[(iBereich As Integer)] Beschreibung
................................................... Bes c hreibung
Die Funktion FreeFile liefert jeweils die kleinste freie Dateinummer im Block iBereich. Fehlt der optionale Parameter iBereich oder hat er den Standardwert 0, entstammt die gelieferte Dateinummer dem Block 0 bis 255, ansonsten dem Block 256 bis 512. Anwendung
................................................... Anwendung
Nachdem Dateinummern globale Größen in einem Modul sind, ist es in größeren Programmen oft schwierig, den Überblick darüber zu behalten, welche bereits vergeben sind und welche nicht. Indem Sie sich neue Dateinummern von FreeFile zuteilen lassen, entlasten Sie sich von der gesamten Problematik.
1 39
Dateiorientierte Funktionen und Anweisungen
Verwandte Befehle
Dateiorientierte Funktionen und Anweisungen
Beispiel
................................................... Beis piel
iBer = FreeFile Open sDatei For Input As iBer ... Close iBer
Vgl. auch das Beispiel im Abschnitt »Fehlerbehandlung« (S. 43). Verwandte Befehle
Dateiorientierte Funktionen und Anweisungen
................................................... Verwa ndte Befehle
Open
Get- Anweisung Get [#]iDateiNr, [lSatzNr], Variable Beschreibung
................................................... Bes c hreibung
Die Anweisung Get ist das Gegenstück zur Anweisung Put. Sie liest Daten aus der Datei mit der Dateinummer iDateiNr und weist diese der Datensatzvariablen Variable als Wert zu. Bei Angabe einer Satznummer lSatzNr liest die Anweisung im Modus Random den entsprechenden Datensatz unter Berücksichtigung der bei der Open-Anweisung vereinbarten Datensatzlänge und im Modus Binary ab der Byteposition lSatzNr. Fehlt lSatzNr, liest die Anweisung jeweils den nächsten Datensatz (Random) bzw. ab der aktuellen Leseposition (Binary) und aktualisiert danach den Datensatzzeiger bzw. die aktuelle Leseposition. Die Datensatzvariable kann einen beliebigen Typ tragen. Objekte lassen sich mittels Get jedoch nicht en bloc einlesen. Anwendung
................................................... Anwendung
Wenn es um das Schreiben und Lesen von Dateiformaten ging, waren Get und Put schon immer die Arbeitspferde der Sprache Basic. Die Arbeitsweise dieser Anweisungen ist traditionell auf indexsequenzielle Dateien zugeschnitten, deren Bearbeitung im Modus Random erfolgt. Get und Put werden aber auch – jedoch mit leicht modifizierter Arbeitsweise – im Modus Binary eingesetzt.
Der Modus Random Beim Öffnen von Dateien im Modus Random wird normalerweise eine Datensatzlänge in Bytes festgelegt, die fortan bestimmt, wie viele Byte mit jeder Get- bzw. Put-Operation je Datensatz gelesen bzw. geschrieben werden. Die Zählung der Datensätze beginnt bei 1. Den Bytebedarf der elementaren Datentypen entnehmen Sie der Tabelle im Abschnitt »Elementare Datentypen« (S. 49); den von Datentypen mit fester Länge sowie von benutzerdefinierten Datentypen ermittelt man am besten mittels LenB, da die Speicherausrichtung der Datenfelder noch eine zusätzliche Rolle spielt. Trägt die Datensatzvariable einen Typ variabler Länge (bzw. einen Typ, der Felder variabler Länge enthält), muss der Datensatz einen Deskriptor (lies: Längenangabe) enthalten. Dabei gilt, dass ein Deskriptor dem Wert unmittelbar vorausgeht. Mithin muss also der Längenbedarf eines oder mehrerer Deskriptoren bei der Berechnung der Datensatzlänge berücksichtigt werden. Für Zeichenfolgen variabler Länge schlagen dabei 2 Längenbyte (!) zu Buche, für Variant-Variablen gleichfalls zunächst 2 Bytes für den VarType-Typ plus gegebenenfalls weitere Längenbyte für Wertanteile mit variablen Längen. Dynamische Arrays schlagen mit 2 Bytes für den Array-Deskriptor zu Buche plus 8 Bytes je Dimension. Die maximale Datensatzlänge beträgt 32.767.
1 40
Get- Anweisung
Die Wertzuweisung an Variablen mit Datentypen fester Länge erfolgt als linksbündige Prokrustes-Zuweisung (vgl. »LSet-Anweisung«, S. 80), wenn die Datensatzlänge nicht dem Längenbedarf der Variablen entspricht.
Der Modus Binary
Warnung
................................................... Wa rnung
Get liest ANSI-Zeichenfolgen als Unicode und Put schreibt Unicode-Zeichenfolgen als ANSICode. Beispiel
................................................... Beis piel
Der folgende Code schreibt eine Zeichenfolge und einen Double-Wert in eine indexsequenzielle Datei und liest diese Werte dann einmal im Modus Random und einmal im Modus Binary: ' Schreiben der Daten Open "Test.Idx" For Random As 1 Len = 8 Dim sDatenSatz As String ' Zeichenfolge (Unicode!) Dim a As Double ' Double-Wert sDatenSatz = "abc" ' Initialisierung a = 2.1E-122 Put 1, , sDatenSatz ' erster Datensatz wird geschrieben Put 1, 17, a ' 17ter Datensatz Close 1 ' Lesen der Daten im Modus Random sDatenSatz = "" a = 0 Open "Test.Idx" For Random As 1 Len Get 1, , sDatenSatz Print Len(sDatenSatz); sDatenSatz Get 1, 17, a Print a Close 1 ' Lesen der Daten im Modus Binary sDatenSatz = Space(3) a = 0 Open "Test.Idx" For Binary As 1 Get 1, 3, sDatenSatz Print Len(sDatenSatz), sDatenSatz Get 1, (17 – 1) * 8 + 1, a Print a Close 1
' Initialisierung = 8 ' erster Datensatz wird gelesen ' Ausgabe: "3 abc" (Deskriptor!) ' Doublewert braucht 8 Bytes! ' Ausgabe: 2,1E-122
' drei Unicodezeichen sind zu lesen ' Initialisierung ' ' ' '
Deskriptoranteil überspringen! Ausgabe: "3 abc" (Deskriptor!) Datensatzlänge 8 einberechnen Ausgabe: 2,1E-122
1 41
Dateiorientierte Funktionen und Anweisungen
Für den Modus Binary gilt im Wesentlichen dasselbe, mit folgenden Abweichungen: Eine Datensatzlänge wird nicht berücksichtigt, und die Anweisung liest ab der aktuellen Position bzw. der Position lSatzNr so viele Bytes, wie für den Wert der Datensatzvariablen erforderlich sind. Zeichenfolgen variabler Länge behandelt Get daher wie Zeichenfolgen fester Länge und liest nur so viele Zeichen, wie der Wert der String-Variablen aktuell enthält – ein Deskriptoranteil entfällt somit. Analoges gilt auch für Arrays. Im Zusammenhang mit benutzerdefinierten Datentypen finden Deskriptoranteile einzelner Datenfelder jedoch sehr wohl Berücksichtigung.
Dateiorientierte Funktionen und Anweisungen
Verwandte Befehle
................................................... Verwa ndte Befehle
Input, Input#, Line Input#, Open, LenB, LSet, Print#, Put Verwandte Themen
................................................... Verwandte Them en
Elementare Datentypen (S. 49); Benutzerdefinierte Datentypen (S. 60)
GetAttr- Funktion
Dateiorientierte Funktionen und Anweisungen
Function GetAttr(sPfad As String) As Integer Beschreibung
................................................... Bes c hreibung
Die Funktion GetAttr liefert die Attribute der Datei oder des Verzeichnisses sPfad als Attributvektor. Anwendung
................................................... Anwendung
Um festzustellen, ob in dem Attributvektor ein bestimmtes Attribut (als Bit) gesetzt ist, führen Sie eine And-Operation mit dem für das Attribut definierten Wert durch. Als Element des Aufzählungstyps VbFileAttribute ist für ihn eine Konstante definiert. Zur Auswahl stehen: Konstante
Wert
Beschreibung
vbNormal
0
Keines der Bits im Attributvektor ist gesetzt. Es handelt sich um eine gewöhnliche Datei.
vbReadOnly
1
Datei/Verzeichnis ist schreibgeschützt.
vbHidden
2
Datei/Verzeichnis ist verborgen.
vbSystem
4
Datei ist Systemdatei bzw. Verzeichnis ist Systemverzeichnis.
vbVolume
8
Logischer Datenträger (wird von GetAttr nicht geliefert)
vbDirectory
16
Verzeichnis
vbArchive
32
Datei wurde seit der letzten Datensicherung geändert
Konstanten für Dateiattribute Beispiel
................................................... Beis piel
Dim Attribut As VbFileAttribut Attribut = vbHidden If Attribut And GetAttr(sDatei) Then
' Datei ist verborgen
Wie man das Vorhandensein mehrerer Attribute prüft, zeigt das Beispiel zur »Dir-Funktion« (S. 135). Verwandte Befehle
................................................... Verwa ndte Befehle
Dir, FileAttr, SetAttr
Input- und InputB- Funktion Function Input(lZeichenAnz, [#]iDateiNr) As String Function InputB(lBytes, [#]iDateiNr) As String
1 42
Input #- Anweisung Beschreibung
................................................... Bes c hreibung
Die Funktion Input liest lBytes Bytes aus der unter der Dateinummer iDateiNr im Modus Input oder Binary geöffneten Datei und liefert diese als Unicode-Zeichenfolge, wobei aus jedem Byte ein Unicode-Zeichen wird. In Abweichung dazu liefert InputB ein echtes Byte-Array in Form einer ANSI-Zeichenfolge. Anwendung
................................................... Anwendung
Warnung
................................................... Wa rnung
Fallen Sie nicht darauf herein, dass Input einzelne Bytes in Unicode-Zeichen umwandelt – und somit aus einem Byte zwei Bytes macht. Um wirklich die gelesene Bytefolge zu erhalten, müssen Sie mit InputB arbeiten. Wenn Sie Input oder InputB beim Lesen einer Textdatei mittels EOF kontrollieren wollen, riskieren Sie einen Laufzeitfehler, sobald die Funktion mehr als ein Byte auf einmal lesen muss. Man arbeitet in diesem Fall besser mit dem Wert von LOF bzw. der Differenz aus den Werten von LOF und Seek. Beispiel
................................................... Beis piel
Open sTextDatei For Input As 1 sGesamteDatei = Input(LOF(1), 1) Close 1 Open sBinärDatei For Binary As 1 sGesamteDatei = InputB(LOF(1), 1) Close 1
' Textdatei ' Gesamte Datei auf einmal lesen ' Binärdatei ' Gesamte Datei als Bytearray lesen
Verwandte Befehle
................................................... Verwa ndte Befehle
Get, Print#, Put, LOF, EOF
Input #- Anweisung Input #iDateiNr, Variable[, Variable ...] Beschreibung
................................................... Bes c hreibung
Die Anweisung Input# liest den im literalen Standardformat repräsentierten Wert einer oder mehrerer Variablen aus einer sequenziellen Datei, die im Modus Input oder Binary geöffnet wurde. Als Trennzeichen zwischen zwei aufeinander folgenden Werten wertet die Anweisung ein Komma oder ein Wagenrücklaufzeichen Chr(13) bzw. vbCr sowie die Kombination Chr(13)+Chr(10) bzw. vbCrLf. Führende und abschließende Leerzeichen sowie doppelte Anführungszeichen schneidet die Anweisung ab.
1 43
Dateiorientierte Funktionen und Anweisungen
Traditionell ist Input (heute InputB genannt) die Leseoperation für Binärdateien (Modus: Binary), Get die Leseoperation für indexsequenzielle Dateien (Modus: Random) und Input# die Leseoperation für Textdateien (Modus: Input). Binärdateien lassen sich aber genauso gut auch mit Get lesen und Textdateien mit Input. Im Gegensatz zu Input# liefert Input alle gelesenen Zeichen, einschließlich Kommas, Wagenrücklaufzeichen (Chr(13) bzw. vbCr), Zeilenvorschubzeichen (Chr(10) bzw. vbLf), Anführungszeichen und führende Leerzeichen.
Dateiorientierte Funktionen und Anweisungen
Anwendung
................................................... Anwendung
Der traditionelle Zweck der Anweisung Input# ist, Daten aus sequenziellen Dateien zu lesen, denen unterschiedliche Datentypen zugrunde gelegt sind. Die Anweisung nimmt daher beim Lesen des Werts für eine Variable eines bestimmten Datentyps von sich aus eine entsprechende Typumwandlung vor. Warnung
Dateiorientierte Funktionen und Anweisungen
................................................... Wa rnung
Im Unterschied zu Line Input# interpretiert Input# auch Kommas als Trennzeichen, wenn diese nicht von Anführungszeichen eingeschlossen sind. Daher hat die Funktion insbesondere Schwierigkeiten mit dem Einlesen von Dezimalzahlen mit Nachkommaanteil sowie Datumswerten, wenn diese mit Print# geschrieben wurden. Print# legt der textuellen Darstellung von Zahlen- und Datumswerten nämlich das gebietsspezifische Format zugrunde. Für das Gebietsschema »Deutsch (Standard)« ist das Dezimaltrennzeichen ein Komma, und das Datumsformat ist komplett anders als das amerikanische. Sie sollten die Daten daher mit der Write#-Anweisung in die Datei schreiben, weil diese grundsätzlich das internationale Standardformat benutzt, das auch für die Notation von Literalen im Quelltext verwendet wird. Beispiel
................................................... Beis piel
' Daten schreiben Open "test.seq" For Output As 1 Write #1, 270; "Er sagte, ""Hi!""" ' Die Anweisung schreibt 2 Werte (!) Close 1 ' Daten lesen Dim i As Integer, a As String, b As String Open "test.seq" For Input As 1 Print Input(24, 1) ' So steht es in der Datei: 270,"Er sagte, ""Hi!""" Seek 1, 1 ' Lesezeiger wieder an den Anfang Input #1, i, a, b ' Die Anweisung liest drei Werte (!), wegen " Print i, a, b ' Ausgabe: 270 Er sagte, Hi! Verwandte Befehle
................................................... Verwa ndte Befehle
EOF, Get, Line Input#, Input, Print#, Put, Write# Verwandte Themen
................................................... Verwandte Them en
Literale und Konstanten (S. 27)
Kill- Anweisung Sub Kill(sSuchmuster As String) Beschreibung
................................................... Bes c hreibung
Die Anweisung Kill löscht alle Dateien, deren Dateiname auf das Suchmuster sSuchmuster passt. Anwendung
................................................... Anwendung
Das Suchmuster besteht aus einem Pfadanteil (absolut oder relativ notiert) und einem Dateianteil, wobei der Pfadanteil das Verzeichnis spezifiziert, das durchsucht wird, und der Dateianteil ein Dateinamensmuster, das auch die Platzhalter »?« (Zeichen an dieser Stelle wird nicht unter-
1 44
Line Input #- Anweisung schieden) und »*« (Zeichen ab dieser Stelle werden nicht unterschieden) enthalten kann. Fehlt der Pfadanteil oder ist er relativ notiert, bezieht die Anweisung den Pfad auf das standardmäßige Arbeitsverzeichnis (vgl. »CurDir-Funktion«, S. 134). Beispiel
................................................... Beis piel
sPfad = Environ("Temp") if sPfad <> "" Then Kill(sPfad + "*.tmp") Verwandte Befehle
................................................... Verwa ndte Befehle
Line Input #- Anweisung Line Input #iDateiNr, sVariable Beschreibung
................................................... Bes c hreibung
Die Anweisung Line Input# liest eine Textzeile aus einer sequenziellen Datei, die im Modus Input oder Binary geöffnet wurde, und weist diese der Zeichenfolgenvariablen sVariable als Wert zu. Als Trennzeichen zwischen zwei aufeinander folgenden Textzeilen wertet die Anweisung das Wagenrücklaufzeichen Chr(13) bzw. vbCr sowie die Kombination Chr(13)+Chr(10) bzw. vbCrLf. Anwendung
................................................... Anwendung
Der traditionelle Zweck der Anweisung Line Input# ist, Zeichenfolgen für die Textverarbeitung aus sequenziellen Dateien zu lesen. Im Unterschied zu Input# behandelt Line Input# weder Kommas als Trennzeichen, noch schneidet die Anweisung Leerzeichen und doppelte Anführungszeichen ab. Zum Schreiben der Daten, die mit Line Input# gelesen werden sollen, verwenden Sie am besten Print#. Beispiel
................................................... Beis piel
Der folgende Code liest eine Textdatei zeilenweise in ein dynamisches Zeichenfolgenarray. Dim sZeilen() As String Dim lZeilen As Long Open "Textdatei.txt" For Input As 1 While Not EOF(1) ReDim Preserve sZeilen(lZeilen + 1) As String Line Input #1, sZeilen(UBound(sZeilen)) lZeilen = UBound(sZeilen) Wend Verwandte Befehle
................................................... Verwa ndte Befehle
EOF, Get, Input, Input#, Print#, Put, Write#
1 45
Dateiorientierte Funktionen und Anweisungen
RmDir
Dateiorientierte Funktionen und Anweisungen
Loc- Funktion Function Loc(iDateiNr As Integer) As Long Beschreibung
................................................... Bes c hreibung
Die Funktion Loc liefert abhängig vom Modus, in dem die Datei mit der DateiNr geöffnet wurde, die Nummer des zuletzt bearbeiteten Datensatzes oder die Position des zuletzt gelesenen oder geschriebenen Bytes. Anwendung
Dateiorientierte Funktionen und Anweisungen
................................................... Anwendung
Visual Basic verwaltet für jede Datei einen Dateizeiger, der die aktuelle Schreib-/Leseposition angibt. Den »nackten« Wert dieses Zeigers liefert die Funktion Seek als Byte-Nummer, gleich in welchem Modus eine Datei geöffnet wurde. Loc liefert dagegen den logischen Dateizeiger. Im Modus Binary unterscheidet sich der Wert des logischen Dateizeigers von dem des gewöhnlichen Dateizeigers dahingehend, dass er um 1 kleiner ist als dieser. Im Modus Random hat der logische Dateizeiger dagegen den Wert des zuletzt gelesenen oder geschriebenen Datensatzes. Es gilt die Formel: ( Dateizeiger – 1 ) Datensatznummer = ---------------------------------------------Datensatzlänge Mithin liefert Loc vor der ersten Dateioperation den Wert 0. Warnung
................................................... Wa rnung
Loc liefert für sequenzielle Dateien zwar einen Wert, dieser ist aber unbrauchbar, da er auf eine Datensatzlänge von 128 gemünzt ist. Sie arbeiten in diesem Fall besser mit Seek. Beispiel
................................................... Beis piel
Open "test.idx" For Random As 1 Len = Datensatzlänge For i = 1 To iDatensätze Put 1, , bdt(i) Next Print Loc(1) ' Wert von iDatensätze Close1 Verwandte Befehle
................................................... Verwa ndte Befehle
EOF, LOF, Seek
Lock- Anweisung Sub Lock([#]iDateiNr As Integer[, lDatensatz As Long]) Sub Lock([#]iDateiNr As Integer, [lStartNr As Long] To lEndNr As Long) Beschreibung
................................................... Bes c hreibung
Die Anweisung Lock sperrt einen einzelnen Datensatz lDatensatz oder einen Bereich von Datensätzen lStartNr bis lEndNr in der Datei mit der Dateinummer iDateiNr vor dem Zugriff durch andere Prozesse. Fehlt bei Gebrauch der ersten Syntax der optionale Parameter lDatensatz, verhängt die Anweisung die Sperre über die gesamte Datei. Fehlt bei Gebrauch der zweiten Syntax der optionale Parameter lStartNr, sperrt die Anweisung alle Datensätze von der Nummer 1 bis zur Nummer lEndNr. Bei Dateien, die im Modus Binary geöffnet wurden, beziehen sich die Bereichsangaben auf Positionen des Dateizeigers.
1 46
LOF- Funktion
Anwendung
................................................... Anwendung
Wenn in einem System oder in einem Netzwerk mehrere Programme gleichzeitig Schreibzugriffe auf dieselbe Datei durchführen, kann das recht unangenehme Inkonsistenzen zur Folge haben. Das Anweisungspaar Lock/Unlock ermöglicht es einem Programm, sich temporär die Exklusivrechte für das Beschreiben eines gewissen Teils der Datei zu sichern. Lock löst den Laufzeitfehler 70, »Zugriff verweigert«, aus, wenn ein anderes Programm bereits eine Sperre auf einen Bereich hält, der mit dem angegebenen Bereich überlappt. Warnung
................................................... Wa rnung
Beispiel
................................................... Beis piel
Der folgende Code schreibt eine Reihe von Datensätzen in die gemeinsame genutzte Datei Kunden.idx: Open "Kunden.idx" For Random As 1 Len = Datensatzlänge On Error GoTo Fehler70 Lock 1, lStartBereich To lEndBereich ' Sperre errichten On Error GoTo 0 For i = lStartBereich To lEndBereich Put 1, i, bdt(i) Next Unlock 1, lStartBereich To lEndBereich ' Sperre aufheben Close 1 Verwandte Befehle
................................................... Verwa ndte Befehle
Open, Unlock Verwandte Themen
................................................... Verwandte Them en
Fehlerbehandlung (S. 43)
LOF- Funktion Function LOF(iDateiNummer As Integer) As Long Beschreibung
................................................... Bes c hreibung
Die Funktion LOF liefert die Länge der unter der Nummer iDateiNummer geöffneten Datei in Bytes. Anwendung
................................................... Anwendung
Wo immer die Länge einer geöffneten Datei eine Rolle spielt, beispielsweise wenn es darum geht, eine Datei en bloc mittels Input einzulesen oder die Anzahl der bereits geschriebenen Bytes (nicht jedoch Datensätze) zu ermitteln, ist LOF das Mittel zum Zweck.
1 47
Dateiorientierte Funktionen und Anweisungen
Bei Lock/Unlock-Anweisungen für sequenzielle Dateien (Input, Output, Append) ignoriert Visual Basic Bereichsangaben und sperrt immer die gesamte Datei. Entgegen anders lautenden Informationen in der Online-Hilfe zu Visual Basic 6.0 entfernt Close (respektive das Programmende) jedoch alle Sperren, die mit Lock gesetzt und nicht explizit mit Unlock freigegeben wurden. Sie sollten aber dennoch darauf achten, jede Lock-Anweisung mit einer Unlock-Anweisung zu paaren, um errichtete Sperren zum frühestmöglichen Zeitpunkt wieder aufzuheben.
Dateiorientierte Funktionen und Anweisungen
Tipp
................................................... Tipp
Die Länge einer noch nicht geöffneten Datei ermittelt die Funktion FileLen. Beispiel
................................................... Beis piel
Der folgende Code liest die unter der Dateinummer 1 geöffnete Datei in einem Stück: sDatei = Input(LOF(1), 1) Verwandte Befehle
Dateiorientierte Funktionen und Anweisungen
................................................... Verwa ndte Befehle
Loc, FileLen, Get, Input, Line Input, Open, Seek
LSet- Anweisung LSet sString1 = sString2 LSet bdtVar = bdtWert Siehe »LSet-Anweisung« (S. 80).
MkDir- Anweisung Sub MkDir(sVerzeichnisname As String) Beschreibung
................................................... Bes c hreibung
Die Anweisung MkDir legt unter dem Namen sVerzeichnisname ein neues Verzeichnis an. Anwendung
................................................... Anwendung
Der Wert des Parameters sVerzeichnisname kann ein (absoluter oder relativer) UNC-Pfad oder Laufwerkspfad sein. Enthält sVerzeichnisname keinen Pfadanteil, legt die Anweisung das Verzeichnis als Unterverzeichnis des standardmäßigen Verzeichnisses an (vgl. »CurDir-Funktion«, S. 134). Falls das Verzeichnis bereits existiert oder die Rechte für das Anlegen des Verzeichnisses nicht ausreichen, löst die Anweisung den Laufzeitfehler 75, »Fehler beim Zugriff auf Pfad/ Datei«, aus. Beispiel
................................................... Beis piel
MkDir "C:\Visual-Basic-Daten\MeineDaten" ' Laufwerkspfad MkDir "\\Tiger\c\Visual-Basic-Daten\MeineDaten" ' UNC-Pfad Verwandte Befehle
................................................... Verwa ndte Befehle
ChDir, CurDir, RmDir
Name- Anweisung Name sAlterDateiname As sNeuerDateiname Beschreibung
................................................... Bes c hreibung
Die Anweisung Name ändert den Namen der Datei oder des Verzeichnisses sAlterDateiname in sNeuerDateiname. Falls sich die Pfadanteile von sAlterDateiname und sNeuerDateiname unterscheiden, wird die Datei bzw. das Verzeichnis verschoben.
1 48
Open- Anweisung
Anwendung
................................................... Anwendung
Die Werte der Parameter sAlterDateiname und sNeuerDateiname können (absolute oder relative) UNC-Pfade oder Laufwerkspfade sein. Fehlt ein Pfadanteil, bezieht sich die Anweisung auf das standardmäßige Verzeichnis (»CurDir-Funktion«, S. 134). Name lässt sich nur auf einzelne Dateien und Verzeichnisse anwenden, Platzhalterzeichen wie »*« oder »?« kann die Anweisung nicht interpretieren – sie lösen den Laufzeitfehler 52, »Dateiname oder -Nummer falsch«, aus. Falls die Datei oder das Verzeichnis sAlterDateiname nicht existiert, löst die Anwendung den Laufzeitfehler 53, »Datei nicht gefunden«, aus. Existiert dagegen sNeuerDateiname bereits als Datei oder Verzeichnis, kommt es zum Laufzeitfehler 58, »Datei existiert bereits«.
................................................... Beis piel
Kill sPfad + "Daten.dat" Name sPfad + "Daten.tmp" As sPfad + "Daten.dat Verwandte Befehle
................................................... Verwa ndte Befehle
Kill
Open- Anweisung Open sName For Modus [Access Zugriffsart] [Sperre] As [#] iNr [Len = lDatensatzlänge] Beschreibung
................................................... Bes c hreibung
Die Anweisung Open öffnet die Datei sName und ordnet ihr für den weiteren Zugriff die Dateinummer iNr zu. Zugleich legt die Anweisung einen Bearbeitungsmodus Modus fest, der als Input, Output, Random oder Binary anzugeben ist. Mittels des optionalen Schlüsselwortes Access gefolgt von Read, Write oder Read Write für Zugriff lässt sich zudem die Art des Zugriffs genauer festlegen. Darüber hinaus besteht die Möglichkeit, für den indexsequenziellen Zugriff im Modus Random eine Datensatzlänge lDatensatzlänge zwischen 1 und 32767 als Len-Zusatz anzugeben. Anwendung
................................................... Anwendung
Für den schreibenden oder lesenden Zugriff auf eine Datei ist es erforderlich, diese zuvor mit Open unter Angabe des entsprechenden UNC- oder Laufwerkspfades zu öffnen. Dabei kann es sich um einen absoluten oder relativen Pfad handeln. Ist sName nur als Dateiname ohne Pfadanteil spezifiziert, geht die Anweisung davon aus, dass die Datei im standardmäßigen Verzeichnis zu finden ist. Als Dateinummer iNr lässt sich ein Wert zwischen 1 und 511 wählen, der fortan als Alias der Datei für jegliche Zugriffe fungiert, bis diese mittels Close wieder geschlossen wird. Bei der Vergabe der Dateinummer ist zu beachten, dass diese nicht bereits einer anderen Datei zugeordnet wurde (vgl. »FreeFile-Funktion«, S. 139). Open ordnet der Datei je nach Bearbeitungsmodus und Zugriffsart auch einen Schreib- und/oder Lesepuffer sowie einen Dateizeiger zu, wobei der Dateizeiger die jeweils aktuelle Position für die nächste Dateioperation wiedergibt, falls diese nicht explizit die Angabe einer Startposition enthält. Für Modus kennt Visual Basic als reine Textmodi Input, Output und Append, wobei mit Input nur ein lesender Zugriff möglich ist und mit Output und Append nur ein schreibender. Ein AccessZusatz für diese Modi ergibt keinen Sinn, da die Zugriffsart ja bereits feststeht. Daneben gibt es noch den indexsequenziellen Zugriffsmodus Random für den rein datensatzorientierten Zugriff sowie den binären Zugriffsmodus Binary, der als flexibelster Modus sowohl für den textorien-
1 49
Dateiorientierte Funktionen und Anweisungen
Beispiel
Dateiorientierte Funktionen und Anweisungen
Dateiorientierte Funktionen und Anweisungen
tierten als auch für den datensatzorientierten Zugriff geeignet ist. Dateioperationen finden im Allgemeinen mit Bezug auf eine Byteposition statt, einzig Operationen im Modus Random liegt eine Datensatznummer zugrunde, bei der die Datensatzlänge lDatensatzlänge eine Rolle spielt. Der Dateizeiger gibt in diesem Fall die Datensatznummer an und nicht die Byteposition. In allen anderen Modi hat die Angabe einer Datensatzlänge keinen Effekt. Für den Modus Append setzt Open den Dateizeiger an das Ende der Datei, ansonsten an den Anfang. Wird eine Datei im Modus Binary oder Random mit dem Zusatz Access Read geöffnet, führt jeder Versuch, eine Schreiboperation darauf auszuführen, zu dem Laufzeitfehler 75, »Fehler bei Zugriff auf Datei«. Analoges gilt für den Zusatz Access Write und Lesezugriffe. Lautet der Zusatz Access Read Write oder fehlt der Access-Zusatz, öffnet Open die Datei in diesen beiden Modi für den Schreib- und Lesezugriff. Ein- und Ausgabeoperationen beziehen sich in diesem Fall auf den gleichen Puffer und den gleichen Dateizeiger. Eine Datei lässt sich auch mehrfach öffnen, sofern sie nicht in einem der Modi Input, Output oder Append geöffnet wird. In diesem Fall verwendet Visual Basic für die zugehörigen Dateinummern den gleichen Puffer, so dass zu jeder Zeit über jede der Dateinummern ein und derselbe Dateiinhalt verfügbar ist. Dateizeiger gibt es aber je Dateinummer einen eigenen (vgl. Beispiel). Gleich, in welchem Modus Sie eine Datei öffnen, Visual Basic verwendet standardmäßig die Zugriffsart Shared, denn diese Zugriffsart erlegt Programmen die geringsten Einschränkungen für den gemeinsamen Zugriff auf dieselbe Datei auf. Vom Prinzip her ist das zwar erwünscht, im Einzelfall kann es aber dazu führen, dass sich Programme gegenseitig ins Handwerk pfuschen, weil ihre Puffer unter ungünstigen Bedingungen unterschiedliche Versionen des gleichen Datensatzes oder des gleichen Dateibereichs enthalten können. Es gibt drei Möglichkeiten, dem entgegenzuwirken: Die erste ist das härteste Geschütz und besteht darin, die Datei gleich beim Öffnen durch Angabe einer der Zugriffsarten Lock Read, Lock Write oder Lock Read Write für den exklusiven Lesezugriff, Schreibzugriff oder Schreib-/Lesezugriff zu öffnen. Die zweite besteht darin, sich die gesamte Datei unmittelbar vor einem Schreib- bzw. Lesezugriff mittels Lock für den exklusiven Zugriff zu reservieren. Diese beiden Techniken können natürlich scheitern, wenn ein anderes Programm seinerseits eine Sperre auf die Datei errichtet hat – sei es auch nur eine Sperre für einen einzelnen Datensatz respektive für einen kleinen Bereich der Datei. Die dritte und moderateste Möglichkeit, auf einen bestimmten Datensatz oder Dateibereich ungestört zugreifen zu können, ist das Sperren genau dieses Datensatzes oder Bereichs mittels Lock und das sofortige Entsperren mittels Unlock nach dem Zugriff. Die Wahrscheinlichkeit, dass diese Technik scheitert, ist am geringsten, da es nur dann zu dem Laufzeitfehler 70, »Zugriff verweigert«, kommt, wenn ein anderes Programm eine Sperre auf die gesamte Datei oder auf genau denselben Datensatz bzw. Dateibereich errichtet hat. Insbesondere, wenn auch die anderen Programme mit der gleichen Technik arbeiten, sind kaum Kollisionen zu befürchten – was natürlich eine Fehlerbehandlung nicht entbehrlich macht. Auch wenn Visual Basic bei Programmende offene Dateien automatisch schließt, sollten Sie generell darauf achten, eine Datei unmittelbar nach der letzten Dateioperation mittels Close zu schließen. Das gibt die Dateinummer und den Puffer frei und ermöglicht anderen Programmen wieder den uneingeschränkten Zugriff auf die Datei. Insbesondere entfernt Close auch alle Sperren, die mit Lock gesetzt und nicht explizit mit Unlock freigegeben wurden. Beispiel
................................................... Beis piel
Der folgende Codeauszug demonstriert zum einen die Fehlerbehandlung im Zusammenhang mit der Open-Anweisung und verschiedenen Dateioperationen. Die Variable sDateipfad enthält die leere Zeichenfolge als Wert. Daher scheitern alle dateibezogenen Operationen. Der Benutzer kann den Vorgang abbrechen, wiederholen oder überspringen (ignorieren). Letzteres ist zu empfehlen, um die verschiedenen Fehlermeldungen zu erhalten. Löscht man das erste Kommen-
1 50
Print #- Anweisung tarzeichen in der zweiten Zeile, läuft der Code fehlerlos und demonstriert, wie es sich mit den Dateizeigern verhält, wenn eine Datei im Modus Binary zweimal geöffnet wird. sDateipfad = "" ' Als Dateiname nicht erlaubt! ' sDateipfad = "Test1" ' Dateiname ist OK On Error GoTo OpenFehler ' Fehlerbehandlung einrichten Open sDateipfad For Binary As 1 Open sDateipfad For Binary As 2
1 5 5 1
OpenFehler: ' Routine für Fehlerbehandlung sFehler = "Fehler" + Str(Err.Number) + ": " + Err.Description Select Case MsgBox(sFehler, vbAbortRetryIgnore, "Fehler") Case vbAbort: Error 1001 Case vbRetry: Resume Case vbIgnore: Resume Next End Select
Vgl. auch die Beispiele in »Close-Anweisung« (S. 133), »EOF-Funktion« (S. 137), »FileAttrFunktion« (S. 138), »FreeFile-Funktion« (S. 139), »Get-Anweisung« (S. 140), »Input- und InputB-Funktion« (S. 142), »Input #-Anweisung« (S. 143) und »Loc-Funktion« (S. 146) sowie das Beispiel im Abschnitt »Fehlerbehandlung« (S. 43). Verwandte Befehle
................................................... Verwa ndte Befehle
Close, FreeFile
Print #- Anweisung Print #iDateiNr[, Ausdr1[Trennz [Ausdr2] ... ]] Beschreibung
................................................... Bes c hreibung
Die Anweisung Print # führt Ausgaben im gebietsspezifischen Format in die unter der Dateinummer iDateiNr geöffnete sequenzielle Datei durch. Die auf die Dateinummer folgende Parameterliste Ausdr1, Ausdr2 usw. darf Werte beliebiger Standardtypen enthalten. Print # gibt diese Werte unter Beachtung des jeweils zwischen den Parametern stehenden Trennzeichens Trennz aus. Anwendung
................................................... Anwendung
Während Print nur noch als Methode eines Form-, UserControl- und Debug-Objekts verfügbar und somit sozusagen zur objektorientierten Seite von Visual Basic übergelaufen ist, ist Print#
1 51
Dateiorientierte Funktionen und Anweisungen
Put 1, 1, "abcd" Print Seek(1), Seek(2) ' Dateizeiger #1 = 5, #2 = Put 2, 1, StrReverse(Input(LOF(2), 2)) Print Seek(1), Seek(2) ' Dateizeiger #1 = 5, #2 = Seek 1, 1 ' Dateizeiger #1 = 1, #2 = Seek 2, 1 ' Dateizeiger #1 = 1, #2 = Print LOF(1), Input(LOF(1), 1) ' Ausgabe: 4, "dcba" Print LOF(2), Input(LOF(2), 2) ' Ausgabe: 4, "dcba" On Error GoTo 0 ' Fehlerbehandlung beenden Close 1, 2 Exit Sub
Dateiorientierte Funktionen und Anweisungen
Dateiorientierte Funktionen und Anweisungen
nach wie vor auf der traditionellen Seite der Sprache verblieben. Charakteristikum für die Ausgabe von Print# im Gegensatz zu Write# ist, dass die literale Darstellung der Werte im Allgemeinen im gebietsspezifischen Format erfolgt. »Im Allgemeinen« deshalb, weil es auch Werte gibt, die ungeachtet des Gebietsschemas nicht übersetzt werden. So die Werte True und False des Datentyps Boolean und das Wort »Error« in der Ausgabe eines Error-Werts. Und obwohl die Anweisung Null als »Null« in eine Datei schreibt, gibt sie den Wert Empty als leere Zeichenfolge und somit gar nicht aus. Als Trennzeichen Trennz sind das Semikolon und das Komma erlaubt. Bei Angabe eines Semikolons setzt die Anweisung den folgenden Wert unmittelbar hinter den vorigen, wie bei der Verkettung von Zeichenfolgen. Das Komma hingegen bewirkt, dass Print# den folgenden Wert an die nächste Tabulatorposition setzt und den Zwischenraum gegebenenfalls mit Leerzeichen auffüllt. Der Abstand zwischen je zwei Tabulatorpositionen beträgt 14 Zeichen. Ist im Anschluss an den letzten Parameter der Liste kein Trennzeichen spezifiziert, ergänzt die Anweisung einen Wagenrücklauf Chr(13) und einen Zeilenvorschub Chr(10) bzw. vbCrLf. Als Werte in der Parameterliste sind auch die Ausdrücke Spc(n) und Tab(n) zulässig, die jedoch keine eigenständigen Zeichenfolgenfunktionen darstellen, sondern als Argument von Print, Print# und Write# zulässig sind. Spc(n) fügt n Leerzeichen ein, und Tab(n) füllt die aktuelle Zeile bis zur Tabulatorposition n mit Leerzeichen. Warnung
................................................... Wa rnung
Die Anweisung gibt Zeichenfolgen im ANSI-Code und nicht im Unicode aus. Es ist im Allgemeinen nicht möglich, Fließkommawerte und Datumswerte, die mit Print# geschrieben wurden, mittels Input # wieder in Variablen des gleichen Typs einzulesen, da Print # seinen Ausgaben das gebietsspezifische Format verpasst, Input# aber Literale im standardisierten Format erwartet. Damit das klappt, müssen Sie die Daten mit Write# und nicht mit Print# schreiben. Tipp
................................................... Tipp
Im Gegensatz zu Write# versieht Print# Zeichenfolgen nicht automatisch mit Anführungszeichen. Wenn Sie ausschließlich Zeichenfolgen ausgeben, also reine Textverarbeitung betreiben, ist Print# in jedem Fall die bessere Lösung. Zum zeilenweisen Lesen der Daten verwenden Sie dann die Anweisung Line Input#. Beispiel
................................................... Beis piel
Die Prozedur Ersetze sucht in einer Textdatei alle Vorkommen der Zeichenfolge sSuch und ersetzt diese gegen die Zeichenfolge sErsetz. Function Ersetze(sDatei As String, sSuch As String, sErsetz As String) Dim sZeile As String Open sDatei For Input As 1 Open "Ersetz.tmp" For Output As 2 ' Temporäre Ausgabedatei anlegen While Not EOF(1) Line Input #1, sZeile ' Zeile lesen Print #2, Replace(sZeile, sSuch, sErsetz) ' Ersetzen und schreiben Wend Close 1, 2 ' beide Dateien schließen Kill sDatei ' Ausgangsdatei löschen Name "Ersetz.tmp" As sDatei ' Temporäre Datei umbenennen End Function
1 52
Put- Anweisung
Verwandte Befehle
................................................... Verwa ndte Befehle
Input, Input#, Line Input#, Print, Write# Verwandte Themen
................................................... Verwandte Them en
Literale und Konstanten (S. 27)
Put- Anweisung Put [#]iDateiNr, [lSatzNr], Wert
................................................... Bes c hreibung
Die Anweisung Put ist das Gegenstück zur Anweisung Get. Sie schreibt die über den Parameter Wert spezifizierten Daten in der gegebenen Repräsentation (typerhaltend) in die Datei mit der Dateinummer iDateiNr. Ist eine Satznummer lSatzNr angegeben, schreibt die Anweisung im Modus Random den Wert Wert als Datensatz unter Berücksichtigung der bei der Open-Anweisung vereinbarten Datensatzlänge und im Modus Binary als schlichte Bytefolge ab der Byteposition lSatzNr. Fehlt lSatzNr, schreibt die Anweisung den Wert als nächsten Datensatz (Random) bzw. an der jeweils aktuellen Schreibposition (Binary) und aktualisiert danach den Datensatzzeiger bzw. die aktuelle Schreibposition. Der Parameter Wert kann einen beliebigen Typ tragen, nicht jedoch einen Objekttyp. Anwendung
................................................... Anwendung
Wenn es um das Schreiben und Lesen von Dateiformaten ging, waren Get und Put schon immer die Arbeitspferde der Sprache Basic. Die Arbeitsweise dieser Anweisungen ist traditionell auf indexsequenzielle Dateien zugeschnitten, deren Bearbeitung im Modus Random erfolgt. Get und Put werden aber auch – jedoch mit leicht modifizierter Arbeitsweise – im Modus Binary eingesetzt.
Der Modus Random Beim Öffnen von Dateien im Modus Random wird normalerweise eine Datensatzlänge in Bytes festgelegt, die fortan bestimmt, wie viele Bytes mit jeder Get- bzw. Put-Operation je Datensatz gelesen bzw. geschrieben werden. Die Zählung der Datensätze beginnt bei 1. Den Bytebedarf der elementaren Datentypen entnehmen Sie der Tabelle im Abschnitt »Elementare Datentypen« (S. 49); den von Datentypen mit fester Länge sowie von benutzerdefinierten Datentypen ermittelt man am besten mittels LenB, da die Speicherausrichtung der Datenfelder noch eine zusätzliche Rolle spielt. Liegt Wert ein Typ variabler Länge zugrunde (bzw. ein Typ, der Felder variabler Länge enthält), erweitert das den Datensatz um einen Deskriptor (lies: Längenangabe). Dabei gilt, dass ein Deskriptor dem Wert unmittelbar vorausgeht. Mithin muss also der Längenbedarf eines oder mehrerer Deskriptoren bei der Berechnung der Datensatzlänge berücksichtigt werden. Für Zeichenfolgen variabler Länge schlagen dabei 2 Längenbytes (!) zu Buche (Zeichenfolgen dürfen demnach nicht länger als 65.535 Zeichen sein), für Variant-Variablen gleichfalls zunächst 2 Bytes für den VarType-Typ plus gegebenenfalls weitere Längenbytes für Wertanteile mit variablen Längen. Dynamische Arrays schlagen mit 2 Bytes für den Array-Deskriptor zu Buche plus 8 Bytes je Dimension. Die maximale Datensatzlänge beträgt 32.767. Put schreibt Wert linksbündig in den Datensatz, ohne Füllbytes anzuhängen, wenn die Repräsentation von Wert kürzer als die Datensatzlänge ist. Sollte die Repräsentation von Wert länger sein als die bei Open angegebene Datensatzlänge, kommt es zum Laufzeitfehler 59, »Falsche Datensatzlänge«.
1 53
Dateiorientierte Funktionen und Anweisungen
Beschreibung
Dateiorientierte Funktionen und Anweisungen
Der Modus Binary Für den Modus Binary gilt im Wesentlichen dasselbe, mit folgenden Abweichungen: Eine Datensatzlänge wird nicht berücksichtigt, und die Anweisung schreibt ab der aktuellen Position bzw. der Position lSatzNr so viele Bytes, wie die Darstellung von Wert benötigt. Zeichenfolgen variabler Länge behandelt Put wie Zeichenfolgen fester Länge, schreibt also nur so viele Bytes wie der Wert an Zeichen enthält – ein Deskriptoranteil entfällt somit. Analoges gilt auch für Arrays. Im Zusammenhang mit benutzerdefinierten Datentypen finden Deskriptoranteile einzelner Datenfelder jedoch sehr wohl Berücksichtigung.
Dateiorientierte Funktionen und Anweisungen
Warnung
................................................... Wa rnung
Put schreibt Unicode-Zeichenfolgen als ANSI-Code und Get liest ANSI-Zeichenfolgen als Unicode. Beispiel
................................................... Beis piel
Die folgende Prozedur Crypt32 nimmt eine einfache 32 Bit-Verschlüsselung einer Datei sDatei mit dem Wert lKennzahl vor. Der gleiche Wert entschlüsselt die Datei auch wieder; probieren Sie es aus. Sub Crypt32(lKennzahl As Long, sDatei As String) Dim lData As Long Open sDatei For Binary As 1 For i = 1 To LOF(1) – Len(lData) + 1 Get 1, i, lData Put 1, i, lData Xor lData Next i Close 1 End Sub Verwandte Befehle
................................................... Verwa ndte Befehle
Get, Input, Input#, LenB, Line Input#, LSet, Open, Print# Verwandte Themen
................................................... Verwandte Them en
Elementare Datentypen (S. 49); Benutzerdefinierte Datentypen (S. 60)
Reset- Anweisung Reset Beschreibung
................................................... Bes c hreibung
Die Anweisung Reset schließt alle offenen Dateien, die mittels Open-Anweisungen geöffnet wurden. Anwendung
................................................... Anwendung
Sinn und Zweck dieser Anweisung ist es, im Fehlerfall oder bei einem überraschenden Programmabbruch schnell aufräumen zu können. Reset erzwingt insbesondere die Ausgabe von Pufferinhalten in Dateien, die zum Schreiben geöffnet wurden. Es besteht kein Unterschied zwischen dem parameterlosen Aufruf von Close und Reset.
1 54
RmDir- Anweisung
Verwandte Befehle
................................................... Verwa ndte Befehle
Close, End
RmDir- Anweisung Sub RmDir(sVerzeichnisname As String) Beschreibung
................................................... Bes c hreibung
Die Anweisung RmDir löscht das Verzeichnis sVerzeichnisName.
................................................... Anwendung
Der Wert des Parameters sVerzeichnisName kann ein (absoluter oder relativer) UNC-Pfad oder Laufwerkspfad sein. Enthält sVerzeichnisName keinen Pfadanteil, geht die Anweisung davon aus, dass das Verzeichnis ein Unterverzeichnis des standardmäßigen Verzeichnisses (vgl. »CurDir-Funktion«, S. 134) ist. Falls das Verzeichnis noch Dateien enthält, löst die Anweisung den Laufzeitfehler 75, »Fehler beim Zugriff auf Pfad/Datei«, aus. Existiert das Verzeichnis überhaupt nicht, kommt es zum Laufzeitfehler 76, »Pfad nicht gefunden«. Beispiel
................................................... Beis piel
Die rekursive Prozedur DelTree löscht ein Verzeichnis mit allen Dateien und Unterverzeichnissen. Sub DelTree(sPfad As String) Dim sUVz As String If Right(sPfad, 1) = "\" Then sPfad = Left(sPfad, Len(sPfad) – 1) End On Error GoTo Fehlerbehandlung Kill sPfad + "\*.*" sUVz = Dir(sPfad + "\", vbDirectory) While sUVz <> "" If sUVz <> "." And sUVz <> ".." Then DelTree (sPfad + "\" + sUVz) sUVz = Dir(sPfad + "\", vbDirectory) Else sUVz = Dir End If Wend RmDir sPfad On Error GoTo 0 Exit Sub Fehlerbehandlung: Resume Next End Sub
' "\" am Ende? ' Abschneiden ' Falls Kill scheitert ' oder Schreibschutz
' Unterverz. abklappern ' Rekursion ' da Dir nicht rekursiv ' arbeitet ' Nächstes Verzeichnis löschen
Verwandte Befehle
................................................... Verwa ndte Befehle
ChrDir, CurDir, Kill, MkDir
1 55
Dateiorientierte Funktionen und Anweisungen
Anwendung
Dateiorientierte Funktionen und Anweisungen
Seek- Anweisung und Seek- Funktion Function Seek(iDateiNr As Integer) As Long Seek [#]iDateiNr, lPosition Beschreibung
Dateiorientierte Funktionen und Anweisungen
................................................... Bes c hreibung
Als Funktion liefert Seek die aktuelle Position des Dateizeigers der unter der Dateinummer iDateiNr geöffneten Datei. Für den Modus Random gibt diese Angabe die Nummer des nächsten zu lesenden oder zu schreibenden Datensatzes ab Dateianfang wieder, für alle anderen Modi die Nummer des nächsten zu lesenden oder zu schreibenden Bytes ab Dateianfang. Das erste Byte bzw. der erste Datensatz trägt die Nummer 1. Als Anweisung setzt Seek den Wert lPosition als neue Position des Dateizeigers. Im Modus Random ist diese Position eine Datensatznummer, in allen anderen Modi eine Bytenummer. Anwendung
................................................... Anwendung
Lese- und Schreiboperationen verschieben den Dateizeiger jeweils immer nur um die gelesene Anzahl von Bytes bzw. Datensätzen, was dem Muster für den sequenziellen Dateizugriff entspricht. Seek ermöglicht die Orientierung und Positionierung innerhalb von Dateien, wenn indexsequenzielle Dateizugriffe erforderlich sind. Warnung
................................................... Wa rnung
Als Anweisung setzt Seek nichts weiter als den Dateizeiger. Falls der Wert von lPosition größer als die von LOF gelieferte Dateilänge ist, bewirkt die nächste Schreiboperation einer zum Schreiben geöffneten Datei eine entsprechende Verlängerung. Dagegen führt die nächste Leseoperation, gleich im welchem Modus die Datei geöffnet wurde, zum Laufzeitfehler 62, »Einlesen hinter Dateiende«. Tipp
................................................... Tipp
Die Syntax für die Dateioperationen Get und Put sieht die Angabe expliziter Positionsangaben vor, so dass auf Seek verzichtet werden kann. Beispiel
................................................... Beis piel
Open sDatei For Output As 1 Seek 1, lOffs ' Dateizeiger auf bestimmte Zeile Line Input #1, sZeile ' Zeile lesen Print Seek(1) ' Dateizeiger abfragen
Die folgende Zeile zeigt, was passiert, wenn Seek über das Dateiende hinausschießt: Open "Test" For Input As 1 ' Die Datei enthält 4 Bytes! Seek 1, 10000 ' Dateizeiger auf 10000 setzen Print Loc(1) ' Ausgabe: 9999 Print Seek(1) ' Ausgabe: 10000 Input #1, a ' Laufzeitfehler 62 Close
Vgl. auch das Beispiel zu »Open-Anweisung« (S. 149). Verwandte Befehle
................................................... Verwa ndte Befehle
Get, Loc, Open, Put
1 56
SetAttr- Anweisung
SetAttr- Anweisung Sub SetAttr(sPfad As String, iAttributvektor As Integer) Beschreibung
................................................... Bes c hreibung
Die Anweisung SetAttr setzt die Attribute der Datei oder des Verzeichnisses sPfad entsprechend dem Attributvektor iAttributvektor. Anwendung
................................................... Anwendung
Konstante
Beschreibung
vbNormal (0)
Keines der Bits im Attributvektor ist gesetzt, es handelt sich um eine gewöhnliche Datei
vbReadOnly (1)
Datei/Verzeichnis ist schreibgeschützt
vbHidden (2)
Datei/Verzeichnis ist verborgen
vbSystem (4)
Datei ist Systemdatei bzw. Verzeichnis ist Systemverzeichnis
vbVolume (8)
Logischer Datenträger (wird von SetAttr nicht gesetzt)
vbDirectory (16)
Verzeichnis (wird von SetAttr nicht gesetzt)
vbArchive (32)
Datei wurde seit der letzten Datensicherung geändert
Konstanten für Dateiattribute Beispiel
................................................... Beis piel
Die folgenden Zeilen zeigen, wie man temporär einen Schreibschutz auf eine Datei entfernt und dann wieder errichtet: SetAttr sDateName, GetAttr(sDateiname) And Not vbReadOnly ... SetAttr sDateName, GetAttr(sDateiname) Or vbReadOnly
Falls nicht klar ist, ob eine Datei schreibgeschützt ist oder nicht, schreiben Sie vorsichtiger: AttrVekt = GetAttr(sDateiname) SetAttr sDateName, AttrVekt And Not vbReadOnly ... SetAttr sDateName, AttrVekt Verwandte Befehle
................................................... Verwa ndte Befehle
Dir, FileAttr, GetAttr
1 57
Dateiorientierte Funktionen und Anweisungen
Das Dateisystem pflegt für jeden Namenseintrag einen Attributvektor (Bytewert), dessen Elemente (Bits des Bytewerts) eine genauere Aussage darüber machen, welcher Art die zugeordnete Datei (bzw. das Verzeichnis) ist. Die folgende Tabelle gibt einen Überblick über die möglichen Attribute sowie über die Konstanten, die in Visual Basic als Elemente des Aufzählungstyps VbFileAttribute für diese Attribute definiert sind. SetAttr ignoriert Attribute, die es nicht setzen kann – so ist es beispielsweise nicht möglich, mittels SetAttr aus einer Datei ein Verzeichnis zu machen.
Dateiorientierte Funktionen und Anweisungen
Shell- Anweisung Function Shell( _ sAnwendName As String, _ [FensterStil As VbAppWinStyle = vbMinimizedFocus]) _ As Double Beschreibung
Dateiorientierte Funktionen und Anweisungen
................................................... Bes c hreibung
Die Funktion Shell ermöglicht den Start einer anderen Anwendung sAnwendName als eigenständige Anwendung und liefert als Funktionswert die Task-ID des zugehörigen Prozesses respektive 0, wenn der Start nicht erfolgreich verlaufen ist. Die Bedeutung der Werte für den optionalen Parameter FensterStil listet die folgende Tabelle auf. Konstante
Beschreibung
vbHide (0)
Das Fenster der Anwendung ist nicht sichtbar, erhält aber den Fokus.
vbNormalFocus (1)
Das Fenster der Anwendung ist sichtbar, hat Normalgröße und erhält den Fokus.
vbMinimizedFocus (2)
Die Anwendung startet als Symbol, erhält aber den Fokus (Standardwert).
vbMaximizedFocus (3)
Die Anwendung startet mit maximiertem Fenster und erhält den Fokus.
vbNormalNoFocus (4)
Das Fenster der Anwendung ist sichtbar, hat Normalgröße, erhält aber nicht den Fokus.
vbMinimizedNoFocus (6)
Die Anwendung startet als Symbol, ohne den Fokus zu erhalten.
Fensterstile für den Start einer Anwendung aus Visual Basic heraus Anwendung
................................................... Anwendung
Das gestartete Programm erbt das standardmäßige Verzeichnis des aufrufenden Programms (vgl. »CurDir-Funktion«, S. 134). Mit der von Shell gelieferten Task-ID lässt sich mit den inhärenten Mitteln von Visual Basic nicht anderes anfangen, außer sie der Anweisung AppActivate zu übergeben, um der gestarteten Anwendung den Fokus zuzuschanzen. Das könnte etwa geschehen, um diese Anwendung mittels der Anweisung SendKeys fernzusteuern. Auf diese Weise lassen sich »die Geister, die man rief« beispielsweise auch wieder loswerden. Tipp
................................................... Tipp
Um eine Anwendung unter Vorgabe eines bestimmten Arbeitsverzeichnisses zu starten, stellen Sie dieses Verzeichnis vor dem Shell-Aufruf mittels ChDrive und ChDir als standardmäßiges Arbeitsverzeichnis ein. Beispiel
................................................... Beis piel
Vgl. das Beispiel zur »Date-Funktion und Date-Anweisung« (S. 116).
1 58
Unlock- Anweisung
Unlock- Anweisung Sub Unlock([#]iDateiNr As Integer[, lDatensatz As Long]) Sub Lock([#]iDateiNr As Integer, [lStartNr As Long] To lEndNr As Long) Beschreibung
................................................... Bes c hreibung
Anwendung
................................................... Anwendung
Wenn in einem System oder in einem Netzwerk mehrere Programme gleichzeitig Schreibzugriffe auf dieselbe Datei durchführen, kann das recht unangenehme Inkonsistenzen zur Folge haben. Das Anweisungspaar Lock/Unlock ermöglicht es einem Programm, sich temporär die Exklusivrechte für das Beschreiben eines gewissen Teils der Datei zu sichern. Jeder Unlock-Anweisung muss eine gleichlautende Lock-Anweisung vorangegangen sein, sonst löst diese den Laufzeitfehler 70, »Zugriff verweigert« aus. Warnung
................................................... Wa rnung
Bei Lock/Unlock-Anweisungen für sequenzielle Dateien (Input, Output, Append) ignoriert Visual Basic Bereichsangaben und sperrt immer die gesamte Datei. Entgegen anders lautenden Informationen in der Online-Hilfe zu Visual Basic 6.0 entfernt Close (respektive das Programmende) jedoch alle Sperren, die mit Lock gesetzt und nicht explizit mit Unlock wieder freigegeben wurden. Beispiel
................................................... Beis piel
Der folgende Code schreibt eine Reihe von Datensätzen in die gemeinsame genutzte Datei Kunden.idx: Open "Kunden.idx" For Random As 1 Len = Datensatzlänge On Error GoTo Fehler70 Lock 1, lStartBereich To lEndBereich ' Sperre errichten On Error GoTo 0 For i = lStartBereich To lEndBereich Put 1, i, bdt(i) Next Unlock 1, lStartBereich To lEndBereich ' Sperre aufheben Close 1 Verwandte Befehle
................................................... Verwa ndte Befehle
Lock, Open
Write #- Anweisung Write #iDateiNr[, Ausdr1[Trennz [Ausdr2] ... ]]
1 59
Dateiorientierte Funktionen und Anweisungen
Die Anweisung Unlock hebt bestehende (programmeigene) Sperren für einen einzelnen Datensatz lDatensatz oder einen Bereich von Datensätzen lStartNr bis lEndNr auf, die für die Datei mit der Dateinummer iDateiNr mittels eines vorangegangenen Lock-Aufrufs errichtet wurden. Fehlt bei Gebrauch der ersten Syntax der optionale Parameter lDatensatz, hebt Unlock eine Sperre auf, die für die gesamte Datei errichtet wurde. Fehlt bei Gebrauch der zweiten Syntax der optionale Parameter lStartNr, entsperrt die Anweisung alle Datensätze von der Nummer 1 bis zur Nummer lEndNr. Bei Dateien, die im Modus Binary geöffnet wurden, beziehen sich die Bereichsangaben auf Positionen des Dateizeigers.
Dateiorientierte Funktionen und Anweisungen
Beschreibung
................................................... Bes c hreibung
Die Anweisung Write # schreibt Daten im Standardformat für literale Werte in die unter der Dateinummer iDateiNr geöffnete sequenzielle Datei. Die auf die Dateinummer folgende Parameterliste Ausdr1, Ausdr2 usw. darf Werte beliebiger Standardtypen enthalten. Write # gibt diese Werte unter Beachtung des jeweils zwischen den Parametern stehenden Trennzeichens Trennz aus. Anwendung
Dateiorientierte Funktionen und Anweisungen
................................................... Anwendung
Da Print# Daten im gebietsspezifischen Format schreibt, wird Write# immer dann anstelle von Print# eingesetzt, wenn die geschriebenen Daten später mittels Input# wieder eingelesen werden sollen. Das Standardformat für literale Werte sieht insbesondere vor, dass Zeichenfolgen in Anführungszeichen und Datumswerte im Format #mm/tt/jjjj# notiert werden. Als Trennzeichen Trennz sind das Semikolon und das Komma erlaubt. Im Gegensatz zu Print # unterscheidet Write# nicht zwischen den beiden Trennzeichen und trennt aufeinanderfolgende Werte der Parameterliste durch ein Komma. Ist im Anschluss an den letzten Parameter der Liste kein Trennzeichen spezifiziert, ergänzt die Anweisung einen Wagenrücklauf Chr(13) und einen Zeilenvorschub Chr(10) bzw. vbCrLf. Warnung
................................................... Wa rnung
Write# gibt Zeichenfolgen im ANSI-Code und nicht im Unicode aus. Tipp
................................................... Tipp
Im Gegensatz zu Write# versieht Print# Zeichenfolgen nicht automatisch mit Anführungszeichen. Wenn Sie ausschließlich Zeichenfolgen ausgeben, also reine Textverarbeitung betreiben, ist Print# in jedem Fall die bessere Lösung. Zum zeilenweisen Lesen der Daten verwenden Sie dann die Anweisung Line Input#. Beispiel
................................................... Beis piel
Vgl. das Beispiel zu »Input #-Anweisung« (S. 143). Verwandte Befehle
................................................... Verwa ndte Befehle
Input#, Open, Print# Verwandte Themen
................................................... Verwandte Them en
Literale und Konstanten (S. 27)
1 60
Variablen Eine Variable ist ein auf einen bestimmten Datentyp (Datenformat) zugeschnittener »Behälter«, der einen Bezeichner (lies: einen Namen) trägt und einen (in dem Datenformat gehaltenen) Wert enthält. Beschreibung
................................................... Bes c hreibung
Charakteristikum der Variable ist, dass ihr Wert veränderlich ist, das heißt, er kann nach Belieben zur Laufzeit im Rahmen von Zuweisungsoperationen sowie von Funktions- und Prozeduraufrufen geändert werden. Mit dieser Eigenschaft ist die Variable unverzichtbarer Bestandteil einer jeden Programmiersprache und Medium für den formalen Umgang mit Daten jeglicher Art. Anwendung
................................................... Anwendung
Für die Wahl des Variablenbezeichners gelten die üblichen Vorschriften für die Bezeichnerwahl (vgl. »Bezeichner und Namensraum«, S. 34). Variablen erhalten ihren Wert durch Zuweisung eines Literals, einer Konstante, einer anderen gleichartigen Variablen, eines Funktionswerts oder eines Ausdrucks, wobei die jeweiligen Datenformate miteinander verträglich sein müssen. Dim MyVar1 As Integer, MyVar2 As Integer, MyVar3 As Integer Dim MyVar4 As Integer MyVar1 = 17 ' Variable MyVar1 erhält Literal als Wert MyVar2 = MyVar1 ' Variable MyVar2 erhält Wert von MyVar1 MyVar3 = MyVar1 + 17 ' Variable MyVar3 erhält Ergebnis von Berechnung MyVar4 = Max(MyVar1, MyVar3) ' Variable MyVar4 erhält Funktionswert
Somit können Variablen für alles stehen, was einen in einen Datentyp gefassten Wert darstellt. Auch wenn es die Sprache Visual Basic im Vergleich zu anderen Programmiersprachen nicht gerade offensichtlich macht: Es besteht ein gewisser Unterschied zwischen Variablen, die einen einfachen Datentyp, und solchen, die einen komplexen Datentyp tragen. Zu den einfachen Datentypen zählen: alle elementaren Datentypen (vgl. »Elementare Datentypen«, S. 49), ausgenommen String und Variant; weiterhin: Aufzählungsdatentypen (vgl. »Enum-Aufzählungen«, S. 62), alle benutzerdefinierten Datentypen, die ihrerseits nur einfache Datentypen als Felder enthalten; der Typ String* für Zeichenfolgen fester Länge und Datenfelder fester Größe, deren Elemente einen einfachen Datentyp tragen. Diese Datentypen zeichnen sich dadurch aus, dass sich ihre Repräsentation während des Programmablaufs von der Länge her nicht verändert und sie deshalb als kompakte Bytefolge gespeichert werden können. Die einfachen Datentypen noch abgerechnet, die als spezielle öffentliche Datentypen im Objektkatalog des Systems registriert sind und ihrerseits aus einfachen Datentypen ausgebaut sind, rechnet man alle anderen Datentypen zu den komplexen Datentypen. Insbesondere zählen dynamische Zeichenfolgen des Typs String, der flexible Datentyp Variant, dynamische Arrays sowie alle zu Objekten gehörigen Datentypen (Klassen) zu den komplexen Datentypen. Komplexe Datentypen lassen sich nicht kompakt speichern, sondern bestehen aus Deskriptoranteilen (Verweisen, Längen etc.) und Wertanteilen. Während die komplexen Datentypen String und Variant mit einem elementaren Datentyp als Untertyp noch relativ einfach und größtenteils intuitiv zu handhaben sind, ist der Umgang mit dynamischen Arrays und Objekten nicht ohne ein gewisses Verständnis für die Natur der »dahinter liegenden« Größen zu bewerkstelligen. Obwohl andere Programmiersprachen hier eine recht klare Linie zwischen Variablen ziehen, die für eine konkrete Größe stehen und solchen, die nur einen Verweis auf eine andere Größe darstellen, gibt es in Visual Basic das Konzept des Verweises offiziell nur in Bezug auf die Parameterübergabe bei Funktionsaufrufen.
1 61
Variablendeklaration
Variablendeklaration
»Hinter den Kulissen« arbeitet aber auch Visual Basic massiv mit Verweisen. Deutlich wird das beispielsweise, wenn man eine Objektvariable einer abstrakten Klasse (etwa der Klasse Form) vereinbart, der man zwar konkrete via Set ins Leben gerufene und von Form abstammende Objekte als Werte zuweisen kann, nicht jedoch via Set einen Wert der Klasse Form selbst – einen solchen gibt es nämlich nicht als konkreten Wert, weil eine Objektvariable des Typs Form ein reiner Verweis ist. »Verständnis für die Natur eines Werts zu haben«, bedeutet für den Visual-Basic-Programmierer natürlich nicht, dass er bis auf das Genaueste wissen muss, wie Visual Basic Objekte repräsentiert (das ist auch C++-Programmierern im Allgemeinen nicht bis auf das Letzte klar, weil es letztlich vom Compiler abhängt, wie er ein Objekt repräsentiert). Das genau ist ja die Stärke der abstrakten Datentypen, deren Implementationen hinter Objekten verborgen bleiben. Es bedeutet aber sehr wohl, dass man bei der Verwendung von Variablen nicht alle Werte in einen Topf schmeißen darf und insbesondere wissen muss, ob man es mit einer Variablen für einen einfachen Datentyp, einen dynamischen Datentyp, ein konkretes Objekt oder ein abstraktes Objekt zu tun hat.
Variablendeklaration Dim [WithEvents] VarName[([Indizes])] [As Typ] Dim VarName[([Indizes])] [As [New] Typ] Dim [WithEvents] VarName[...], [WithEvents] VarName[...][, ...] Private VarName[([Indizes])] [As [New] Typ] Private [WithEvents] VarName[([Indizes])] [As Typ] Private [WithEvents] VarName[...], VarName[...][, ...] Public VarName[([Indizes])] [As [New] Typ] Public [WithEvents] VarName[([Indizes])] [As Typ] Public [WithEvents] VarName[...], VarName[...][, ...] Static VarName[([Indizes])] [As [New] Typ] Static VarName[...], VarName [...][, ...] Option Explicit Beschreibung
................................................... Bes c hreibung
Visual Basic ist eine typisierende Programmiersprache. Zwar nimmt der Compiler von sich aus eine – für den Programmierer weitgehend transparente – implizite Typzuordnung und Typumwandlung von Werten je nach Erfordernis vor, doch dieses Standardverhalten überdeckt nur einen kleinen Teil der mit Visual Basic verfügbaren Typenvielfalt. Der volle Umfang der von Visual Basic unterstützten Datentypen mit allen ihren Repräsentationsformen und Geltungsbereichen lässt sich nur bei Verwendung der expliziten Variablendeklaration nutzen. Jede Deklaration impliziert eine Initialisierung mit dem Standardwert des – implizit oder explizit – vereinbarten Datentyps. Anwendung
................................................... Anwendung
Bei der expliziten Deklaration von Variablen unterscheiden Programmiersprachen traditionell zwischen der statischen und der automatischen Vereinbarung. Statische Variablen, für deren Deklaration das Schlüsselwort Static erforderlich ist, finden ihre Repräsentation im Datensegment des Prozesses, während automatische Variablen ihr (meist kurzes) Dasein auf dem Stack fristen. Visual Basic erlaubt die Vereinbarung statischer Variablen nur auf Prozedurebene
1 62
Variablendeklaration
Dim myForm As Form1 Set MyForm = New Form1 MyForm.Show und Dim myForm As New Form1 MyForm.Show In diesem Fall kann also eine implizite Initialisierung durch Nennung erfolgen. Visual Basic unterscheidet bei der expliziten, automatischen Variablendeklaration weiterhin zwischen einer Vereinbarung auf Prozedurebene und einer Vereinbarung auf Modulebene (im Bereich ALLGEMEIN). Vereinbarungen auf Prozedurebene und auf Modulebene lassen sich mit dem traditionellen Basic-Schlüsselwort Dim treffen. Vereinbarungen auf Modulebene lassen sich alternativ auch mittels der neuen Visual-Basic-Schlüsselwörter Private und Public treffen. Private entspricht dabei dem Schlüsselwort Dim und begrenzt den Geltungsbereich der Variablen auf das aktuelle Modul. Public dehnt dagegen den Geltungsbereich der Variablen auf alle Module aus. Bei der Deklaration einer Objektvariablen auf Modulebene ist der Zusatz WithEvents möglich. Er spezifiziert, dass die Objektvariable auf ein Objekt verweisen wird, das von sich aus (mittels RaiseEvent) Ereignisse generiert und die der »Besitzer« (das ist die Ebene, auf der die Objektvariable bekannt ist) behandeln oder weiterreichen sollte. Zur Behandlung solcher Ereignisse lassen sich dann in dem jeweiligen Modul unter dem Namen der Objektvariablen Behandlungsroutinen bereitstellen – so wie man das von Steuerelementen, die auf einem Formular platziert wurden, oder von Menüeinträgen her gewöhnt ist. ' Bereich Allgemein Private WithEvents myObject As MyClass ... Private Sub myObject_EventOfMyClass() ...
In der Tat nimmt Visual Basic für jedes Steuerelement, das auf einem Formular platziert wird, implizit nichts anderes als eine WithEvents-Deklaration vor und vereinbart dabei den unter der Eigenschaft Name des Steuerelements genannten Bezeichner als Objektvariable. WithEvents lässt sich nur bei der Vereinbarung von Instanzen konkreter Klassen verwenden und schließt eine gleichzeitige Verwendung des Spezifizierers New aus.
1 63
Variablendeklaration
(innerhalb von Prozedur- bzw. Funktionskörpern) und ermöglicht damit Prozeduren »mit Gedächtnis«: Im Gegensatz zur automatischen Variablen, die bei jedem Aufruf neu auf dem Stack angelegt wird, bleibt eine statische Variable und damit auch ihr Wert von einem Aufruf zum nächsten erhalten. Bei der D