MemReadStr

obj -> MemReadStr(int1, int2[, int3]) : alpha

Zeichenkette lesen

Details

• obj: Deskriptor des Memory -Objekts
• int1: Erstes zu lesendes Byte
• int2: Anzahl, der zu lesenden Bytes
• int3: Zielzeichensatz (optional)
• Resultat: alpha gelesene Zeichenkette
• Siehe: Verwandte Befehle , MemWriteStr () , MemReadByte ()

Dieser Befehl liest aus dem Speicherbereich des Memory -Objekts (obj) ab der Position (int1) eine Menge von (int2) Bytes und überträgt sie in den Resultatwert. Dabei wird eine Zeichensatzwandlung durchgeführt, wenn in (int3) ein Zielzeichensatz (siehe Charset) angegeben wird. Als Quellzeichensatz wird die Eigenschaft Charset des Memory -Objekts verwendet. Es kann zwischen allen unterstützten Zeichensätzen konvertiert werden. Dabei werden Zeichen, die nicht im Zielzeichensatz darstellbar sind, durch ein Fragezeichen ersetzt.

info

In einigen Zeichensätze werden mehrere Bytes zur Repräsentaion eines Zeichens verwendet. Wird eine Anzahl von Bytes angegeben, die nicht auf eine Zeichengrenze fällt, kann das letzte Zeichen nicht konvertiert werden.

info

Da Zeichenketten null-terminiert sind, kann die Länge der resultierenden Zeichenkette kleiner als die zu lesende Länge (int2) sein, sofern das Memory-Objekt im ausgelesenen Bereich ein Null-Byte enthält.

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) übergebene Desriptor ist ungültig.
• _ErrValueRange: Die Position (int1) oder die Länge (int2) liegen außerhalb des zulässigen Bereichs.
• _ErrValueInvalid: In (int3) wurde ein undefinierter Zeichensatz angegeben.