SLPEscape-Subroutine

Online bearbeiten

Zweck

Verarbeitet eine Eingabezeichenfolge und versieht alle für SLP reservierten Zeichen mit Escapezeichen.

Syntax

SLPError SLPEscape(const char* pcInbuf,
                      char** ppcOutBuf,
                      SLPBoolean isTag);

Beschreibung

Die Subroutine SLPEscape verarbeitet die Eingabezeichenfolge in pcInbuf und versieht alle für SLP reservierten Zeichen mit Escapezeichen. Wenn der Parameter isTag den Wert SLPTruehat, sucht SLPEscape nach fehlerhaften Tagzeichen und signalisiert einen Fehler, wenn sie gefunden werden, indem der Code SLP_PARSE_ERROR zurückgegeben wird. Die Ergebnisse werden in einem von der API-Bibliothek zugewiesenen Puffer abgelegt und im Parameter ppcOutBuf zurückgegeben. Dieser Puffer sollte mit SLPFrei () freigegeben werden, wenn der Speicher nicht mehr benötigt wird.

Parameter

Element Beschreibung
pcInbuf Zeiger auf den Eingabepuffer zur Verarbeitung für Escapezeichen.
ppcOutBuf Zeiger auf einen Zeiger für den Ausgabepuffer mit den Zeichen, die für SLP mit Escapezeichen reserviert sind. Muss mit SLPFrei () freigegeben werden, wenn der Speicher nicht mehr benötigt wird.
isTag Bei 'true' wird der Eingabepuffer auf fehlerhafte Tagzeichen überprüft.

Rückgabewerte

Die Subroutine SLPEscape gibt SLP_PARSE_ERROR zurück, wenn Zeichen ungültige Tagzeichen sind und das Flag isTag wahr ist. Andernfalls gibt sie SLP_OKoder den entsprechenden Fehlercode zurück, wenn ein anderer Fehler auftritt.