Instrukcja Put

Zapisuje rekord do pliku względnego lub sekwencję bajtów do pliku binarnego.

Zobacz także: Instrukcja Get

Składnia:

Put [#] FileNumber As Integer, [position], zmienna

Parametry:

Numer_pliku: Dowolne wyrażenie w postaci liczby całkowitej definiujące plik, do którego należy zapisać dane.

Pozycja: W przypadku plików względnych (otwartych w trybie Random) pozycja jest numerem rekordu, do którego należy zapisać dane.

W przypadku plików binarnych (otwartych w trybie Binary) pozycja stanowi pozycję bajtu w pliku, od której należy rozpocząć zapis.

Zmienna: Nazwa zmiennej, którą należy zapisać do pliku.

Uwaga dotycząca plików względnych: Jeśli zawartość tej zmiennej ma inną długość niż długość rekordu określona w klauzuli Len instrukcji Open, miejsce pomiędzy końcem aktualnie dopisanego rekordu i następnym rekordem pozostaje wypełnione danymi już istniejącym w tym pliku.

Uwaga dotycząca plików binarnych: Zawartość zmiennej jest zapisywana w określonej pozycji, a wskaźnik pliku jest ustawiany bezpośrednio za ostatnim zapisanym bajtem. Pomiędzy rekordami nie jest pozostawiane wolne miejsce.

Przykład:

Sub ExampleRandomAccess

Dim iNumber As Integer

Dim sText As Variant ' Musi być typu variant

Dim aFile As String

    aFile = "c:\data.txt"

    iNumber = Freefile

    Open aFile For Random As #iNumber Len=32

    Seek #iNumber,1 ' Pozycja, z której rozpoczynamy pisać

    Put #iNumber,, "To jest pierwsza linia tekstu" ' Wypełnia linię tekstem

    Put #iNumber,, "To jest druga linia tekstu"

    Put #iNumber,, "To jest trzecia linia tekstu"

    Seek #iNumber,2

    Get #iNumber,,sText

    Print sText

    Close #iNumber

    iNumber = Freefile

    Open aFile For Random As #iNumber Len=32

    Get #iNumber,2,sText

    Put #iNumber,,"To jest nowy tekst"

    Get #iNumber,1,sText

    Get #iNumber,2,sText

    Put #iNumber,20,"To jest tekst w rekordzie 20"

    Print Lof(#iNumber)

    Close #iNumber

End Sub