System.Classes.TCustomMemoryStream.Seek

Aus RAD Studio API Documentation
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Scoping Libraries)
(Updated file (LOC-9171).)
 
Zeile 4: Zeile 4:
 
{{#ifeq: {{PAGENAME}} | System.Classes.TCustomMemoryStream.Seek | |{{InheritsFrom|System.Classes.TCustomMemoryStream.Seek}}}}
 
{{#ifeq: {{PAGENAME}} | System.Classes.TCustomMemoryStream.Seek | |{{InheritsFrom|System.Classes.TCustomMemoryStream.Seek}}}}
  
−
<section begin=short />Verschiebt die aktuelle Position des Streams um Offset Bytes. Die Verschiebung erfolgt relativ zu dem mit Origin angegebenen Ursprung.<section end=short />
+
<section begin=short />Verschiebt die aktuelle Position des Streams um <code>Offset</code> Bytes. Die Verschiebung erfolgt relativ zu dem mit <code>Origin</code> angegebenen Ursprung.<section end=short />
  
 
Mit [[System.Classes.TCustomMemoryStream.Seek|Seek]] kann die aktuelle Position innerhalb des Speicher-Streams um den angegebenen Offset verschoben werden. [[System.Classes.TCustomMemoryStream.Seek|Seek]] ermöglicht es der Anwendung, ab einer bestimmten Position in dem mit dem Speicher-Stream verbundenen [[System.Classes.TCustomMemoryStream.Memory|Memory]] zu lesen oder zu schreiben.
 
Mit [[System.Classes.TCustomMemoryStream.Seek|Seek]] kann die aktuelle Position innerhalb des Speicher-Streams um den angegebenen Offset verschoben werden. [[System.Classes.TCustomMemoryStream.Seek|Seek]] ermöglicht es der Anwendung, ab einer bestimmten Position in dem mit dem Speicher-Stream verbundenen [[System.Classes.TCustomMemoryStream.Memory|Memory]] zu lesen oder zu schreiben.
  
−
Wenn für Offset eine negative Zahl angegeben wird, erfolgt die Suche rückwärts ab dem angegebenen Ursprung. Die folgende Tabelle enthält die verschiedenen Werte von Origin und ihre Auswirkung auf die Suche.
+
Wenn für <code>Offset</code> eine negative Zahl angegeben wird, erfolgt die Suche rückwärts ab dem angegebenen Ursprung. Die folgende Tabelle enthält die verschiedenen Werte von <code>Origin</code> und ihre Auswirkung auf die Suche.
  
 
{| border="1" frame="hsides" rules="rows"
 
{| border="1" frame="hsides" rules="rows"
 
! '''Wert'''
 
! '''Wert'''
 
! '''Bedeutung'''
 
! '''Bedeutung'''
−
|-
+
|- valign="top"
−
| align="left" valign="top" |
+
|  
−
soFromBeginning
+
[[System.Classes|soBeginning]]
−
| align="left" valign="top" |
+
|  
−
Der Offset bezieht sich auf den Anfang von [[System.Classes.TCustomMemoryStream.Memory|Memory]]. Seek bewegt den Dateizeiger zur Position Offset. Offset muss &gt;= 0 sein.
+
Der <code>Offset</code> bezieht sich auf den Anfang von [[System.Classes.TCustomMemoryStream.Memory|Memory]]. [[System.Classes.TCustomMemoryStream.Seek|Seek]] bewegt den Dateizeiger zur Position <code>Offset</code>. <code>Offset</code> muss &gt;= 0 sein.
−
|-
+
|- valign="top"
−
| align="left" valign="top" |
+
|  
−
soFromCurrent
+
[[System.Classes|soCurrent]]
−
| align="left" valign="top" |
+
|  
−
<!--Ausgangspunkt für Offset ist die aktuelle Position.-->Der Offset bezieht sich auf die aktuelle Position. Seek verschiebt den Dateizeiger nach (Position + Offset).
+
<!--Ausgangspunkt für Offset ist die aktuelle Position.-->Der <code>Offset</code> bezieht sich auf die aktuelle Position. [[System.Classes.TCustomMemoryStream.Seek|Seek]] verschiebt den Dateizeiger nach (<code>Position</code> + <code>Offset</code>).
−
|-
+
|- valign="top"
−
| align="left" valign="top" |
+
|
−
soFromEnd
+
[[System.Classes|soEnd]]
−
| align="left" valign="top" |
+
|  
−
<!--Ausgangspunkt für Offset ist das Ende von [[System.Classes.TCustomMemoryStream.Memory|Memory]].-->Der Offset bezieht sich auf das Ende von [[System.Classes.TCustomMemoryStream.Memory|Memory]]. Offset muss &lt;= 0 sein und die gewünschte Anzahl Bytes vor dem Ende des Speicherpuffers angeben.
+
<!--Ausgangspunkt für Offset ist das Ende von [[System.Classes.TCustomMemoryStream.Memory|Memory]].-->Der <code>Offset</code> bezieht sich auf das Ende von [[System.Classes.TCustomMemoryStream.Memory|Memory]]. <code>Offset</code> muss &lt;= 0 sein und die gewünschte Anzahl Bytes vor dem Ende des Speicherpuffers angeben.
 
|}
 
|}
  
 +
[[System.Classes.TCustomMemoryStream.Seek|Seek]] liefert den neuen Wert in der Eigenschaft [[System.Classes.TStream.Position|Position]] zurück.
  
−
 
+
<blockquote>'''Hinweis:''' [[System.Classes.TCustomMemoryStream.Seek|Seek]] führt keine Fehlerprüfung hinsichtlich des für <code>Offset</code> angegebenen Wertes durch. [[System.Classes.TCustomMemoryStream.Seek|Seek]] darf weder mit einem Wert aufgerufen werden, der die aktuelle Position vor den Anfang des Streams verschiebt, noch mit einem Wert, der größer als <code>Size</code> ist, also hinter das Ende des Speicherpuffers.</blockquote>
−
 
+
−
[[System.Classes.TCustomMemoryStream.Seek|Seek]] liefert den neuen Wert in der Eigenschaft Position zurück.
+
−
 
+
−
<blockquote>'''Anmerkung:'''  [[System.Classes.TCustomMemoryStream.Seek|Seek]] führt keine Fehlerprüfung hinsichtlich des für Offset angegebenen Wertes durch. [[System.Classes.TCustomMemoryStream.Seek|Seek]] darf weder mit einem Wert aufgerufen werden, der die aktuelle Position vor den Anfang des Streams verschiebt, noch mit einem Wert, der größer als Size ist, also hinter das Ende des Speicherpuffers.</blockquote>
+
  
 
===Siehe auch===
 
===Siehe auch===
  
−
* [[System.Classes.TCustomMemoryStream.Memory|Memory]]
+
* [[System.Classes.TSeekOrigin]]
 +
* [[System.Classes.TCustomMemoryStream.Memory]]
 +
* [[System.Classes.TStream.Position]]
 +
* [[System.Classes.TCustomMemoryStream.Read]]
 +
* [[System.Classes.TStream.Size]]
 +
* [[System.Classes.TStream.Write]]
 +
* [[System.Classes]]
 +
* [[System.Classes]]
 +
* [[System.Classes]]
  
−
* [[System.Classes.TStream.Position|Position]]
+
[[Category:API-Dokumentation]]
  
−
* [[System.Classes.TCustomMemoryStream.Read|Read]]
+
===Codebeispiele===
  
−
* [[System.Classes.TStream.Size|Size]]
 
−
 
−
* [[System.Classes.TStream.Write|Write]]
 
−
 
−
 
−
[[Category:API-Dokumentation]]
 
−
<!--End API Documentation-->
 
−
<!--Start samples-->
 
−
==Codebeispiele==
 
 
*[[samp_en:ComponentToString (Delphi)|ComponentToString (Delphi)]]
 
*[[samp_en:ComponentToString (Delphi)|ComponentToString (Delphi)]]
 
*[[samp_en:ComponentToString (C++)|ComponentToString (C++)]]
 
*[[samp_en:ComponentToString (C++)|ComponentToString (C++)]]
−
 
−
<!--End samples-->
 

Aktuelle Version vom 25. April 2012, 08:25 Uhr

Delphi 

function Seek(const Offset: Int64; Origin: TSeekOrigin): Int64; override;

C++ 

virtual __int64 __fastcall Seek(const __int64 Offset, TSeekOrigin Origin)/* overload */;
inline int __fastcall  Seek(int Offset, System::Word Origin){ return TStream::Seek(Offset, Origin); }
inline __int64 __fastcall  Seek _DEPRECATED_ATTRIBUTE0 (const __int64 Offset, System::Word Origin){ return TStream::Seek(Offset, Origin); }

Inhaltsverzeichnis

[Bearbeiten] Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
 System.Classes TCustomMemoryStream

[Bearbeiten] Beschreibung

Verschiebt die aktuelle Position des Streams um Offset Bytes. Die Verschiebung erfolgt relativ zu dem mit Origin angegebenen Ursprung.

Mit Seek kann die aktuelle Position innerhalb des Speicher-Streams um den angegebenen Offset verschoben werden. Seek ermöglicht es der Anwendung, ab einer bestimmten Position in dem mit dem Speicher-Stream verbundenen Memory zu lesen oder zu schreiben.

Wenn für Offset eine negative Zahl angegeben wird, erfolgt die Suche rückwärts ab dem angegebenen Ursprung. Die folgende Tabelle enthält die verschiedenen Werte von Origin und ihre Auswirkung auf die Suche.

Wert Bedeutung

soBeginning

Der Offset bezieht sich auf den Anfang von Memory. Seek bewegt den Dateizeiger zur Position Offset. Offset muss >= 0 sein.

soCurrent

Der Offset bezieht sich auf die aktuelle Position. Seek verschiebt den Dateizeiger nach (Position + Offset).

soEnd

Der Offset bezieht sich auf das Ende von Memory. Offset muss <= 0 sein und die gewünschte Anzahl Bytes vor dem Ende des Speicherpuffers angeben.

Seek liefert den neuen Wert in der Eigenschaft Position zurück.

Hinweis: Seek führt keine Fehlerprüfung hinsichtlich des für Offset angegebenen Wertes durch. Seek darf weder mit einem Wert aufgerufen werden, der die aktuelle Position vor den Anfang des Streams verschiebt, noch mit einem Wert, der größer als Size ist, also hinter das Ende des Speicherpuffers.

[Bearbeiten] Siehe auch

[Bearbeiten] Codebeispiele

Von „http://docwiki.embarcadero.com/Libraries/XE4/d/index.php?title=System.Classes.TCustomMemoryStream.Seek&oldid=338559“
Übersetzungen