Text- och binärströmmar

En textström består av en eller flera textrader som kan skrivas till en textorienterad visning så att de kan läsas. När den läser från en textström läser programmet en ny rad i slutet av varje rad. När det skriver till en textström skriver programmet en ny rad för att signalera slutet på en rad. För att matcha olika konventioner mellan målmiljöer för att representera text i filer kan biblioteksfunktionerna ändra antalet och representationerna av tecken som överförs mellan programmet och en textström.

Positionering i en textström är begränsad. Du kan hämta den aktuella indikatorn för filposition genom att anropa fgetpos eller ftell. Du kan placera en textström på en position som erhålls på det här sättet, eller i början eller slutet av strömmen, genom att anropa fsetpos eller fseek. Andra positionsändringar kan mycket väl inte stödjas.

För maximal portabilitet bör programmet inte skriva:

• Tomma filer.
• Blankstegstecken i slutet av en rad.
• Partiella rader (genom att utelämna den nya raden i slutet av en fil).
• Andra tecken än de utskrivbara tecknen, den nya raden och den vågräta fliken.

Om du följer de här reglerna kommer sekvensen av tecken du läser från en textström att matcha sekvensen av tecken du skrev, oavsett om de är som byte eller flerbytestecken. Annars kan biblioteksfunktionerna ta bort en fil som du skapar om filen är tom när du stänger den. Eller så kan de ändra eller ta bort tecken som du skriver till filen.

En binär ström består av en eller flera bytes av godtycklig information. Du kan skriva värdet som lagras i ett godtyckligt objekt till en (byteorienterad) binär ström och läsa exakt vad som lagrades i objektet när du skrev det. Biblioteksfunktionerna ändrar inte de byte som du överför mellan programmet och en binär ström. De kan dock lägga till ett godtyckligt antal NULL byte i filen som du skriver med en binär dataström. Programmet måste hantera dessa extra NULL byte i slutet av binärströmmen.

Positionering i en binär ström är väldefinierad, förutom positionering i förhållande till strömmens slut. Du kan hämta och ändra den aktuella filpositionsindikatorn på samma sätt som för en textström. De offsetvärden som används av ftell och fseek räknar antal byte från början av strömmen (vilket är byte noll), så heltalsaritmetik på dessa offsetvärden ger förutsägbara resultat.

En byteström behandlar en fil som en sekvens med byte. I programmet ser strömmen ut som samma sekvens med byte, förutom de eventuella ändringar som beskrivs ovan.

Se även

Filer och strömmar