![]() |
Qore Programming Language - C/C++ Library 2.1.1
|
this class is used to safely manage calls to AbstractQoreNode::getStringRepresentation() when a simple QoreString value is needed, stack only, may not be dynamically allocated More...
#include <QoreStringNode.h>
Public Member Functions | |
| DLLEXPORT | QoreStringValueHelper (const QoreValue n) |
| creates the object and acquires a pointer to the QoreString representation of the QoreValue passed | |
| DLLEXPORT | QoreStringValueHelper (const QoreValue n, const QoreEncoding *enc, ExceptionSink *xsink) |
| gets the QoreString representation and ensures that it's in the desired encoding | |
| DLLEXPORT | ~QoreStringValueHelper () |
| destroys the object and deletes the QoreString pointer being managed if it was a temporary pointer | |
| DLLEXPORT char * | giveBuffer () |
| returns a char* string that the caller owns and must free() | |
| DLLEXPORT QoreString * | giveString () |
| returns a copy of the QoreString that the caller owns | |
| DLLEXPORT bool | is_temp () const |
| returns true if the pointer being managed is temporary | |
| DLLEXPORT const QoreString * | operator* () |
| returns the object being managed | |
| DLLEXPORT const QoreString * | operator-> () |
| returns the object being managed | |
this class is used to safely manage calls to AbstractQoreNode::getStringRepresentation() when a simple QoreString value is needed, stack only, may not be dynamically allocated
the QoreString value returned by this function is managed safely in an exception-safe way with this class
| DLLEXPORT QoreStringValueHelper::QoreStringValueHelper | ( | const QoreValue | n, |
| const QoreEncoding * | enc, | ||
| ExceptionSink * | xsink ) |
gets the QoreString representation and ensures that it's in the desired encoding
a Qore-language exception may be thrown if an encoding error occurs
| DLLEXPORT char * QoreStringValueHelper::giveBuffer | ( | ) |
returns a char* string that the caller owns and must free()
the object is empty after this call
| DLLEXPORT QoreString * QoreStringValueHelper::giveString | ( | ) |
returns a copy of the QoreString that the caller owns
the object may be left empty after this call
| DLLEXPORT const QoreString * QoreStringValueHelper::operator* | ( | ) |
returns the object being managed
| DLLEXPORT const QoreString * QoreStringValueHelper::operator-> | ( | ) |
returns the object being managed