SLPUnescape-Subroutine

Zweck

Verarbeitet eine Eingabezeichenfolge und hebt die Escapezeichen für alle für SLP reservierten Zeichen auf.

Syntax

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

Beschreibung

Die Subroutine SLPUnescape verarbeitet die Eingabezeichenfolge in pcInbuf und hebt die Escapezeichen für alle für SLP reservierten Zeichen auf. Wenn der Parameter isTag den Wert SLPTruehat, sucht SLPUnescape nach fehlerhaften Tagzeichen und signalisiert durch Rückgabe des Codes SLP_PARSE_ERROR einen Fehler. Es wird keine Transformation ausgeführt, wenn die Eingabezeichenfolge nicht transparent ist. Die Ergebnisse werden in einem von der API-Bibliothek zugewiesenen Puffer abgelegt und im Parameter ppcOutBuf zurückgegeben. Dieser Puffer sollte mit SLPFree () 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 SLPFree () 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 SLPUnescape gibt SLP_PARSE_ERROR zurück, wenn Zeichen fehlerhafte Tagzeichen sind und das Flag isTag wahr ist. Andernfalls gibt sie SLP_OKoder den entsprechenden Fehlercode zurück, wenn ein anderer Fehler auftritt.