SoReadError(3)

💖 SoReadError — NAME 💖

SoReadError — bestie, this is the class that handles error messages during model import operations. That's the whole vibe. 👑

---

✨ SYNOPSIS ✨

#include <Inventor/errors/SoReadError.h>

Inherits SoError.

🌸 Public Member Functions

• virtual SoType getTypeId (void) const — grabs the type id for this instance, virtual so it knows what it actually is.

🦋 Public Member Functions inherited from SoError

• virtual ~SoError () — the destructor, virtual, does the cleanup thing.
• const SbString & getDebugString (void) const — hands you back the debug string.
• SbBool isOfType (const SoType type) const — checks whether this thing is of the given type.

🎀 Static Public Member Functions

• static void setHandlerCallback (SoErrorCB *const function, void *const data) — sets the handler callback for this class.
• static SoErrorCB * getHandlerCallback (void) — returns the handler callback for this class.
• static void * getHandlerData (void) — returns the pointer that gets passed back to the callback.
• static SoType getClassTypeId (void) — returns the SoType for the class itself.
• static void post (const SoInput *const input, const char *const format,...) — the one you call from import code to post errors/warnings.
• static void initClass (void) — sets the class up.

🌈 Static Public Member Functions inherited from SoError

• static void setHandlerCallback (SoErrorCB *const func, void *const data)
• static SoErrorCB * getHandlerCallback (void)
• static void * getHandlerData (void)
• static SoType getClassTypeId (void)
• static void post (const char *const format,...)
• static SbString getString (const SoNode *const node)
• static SbString getString (const SoPath *const path)
• static SbString getString (const SoEngine *const engine)
• static void initClass (void)
• static void initClasses (void)

💅 Protected Member Functions

• virtual SoErrorCBPtr getHandler (void *&data) const — the protected handler-getter, virtual.

🫶 Protected Member Functions inherited from SoError

• void setDebugString (const char *const str)
• void appendToDebugString (const char *const str)
• void handleError (void)

⭐ Additional Inherited Members

Static Protected Member Functions inherited from SoError

• static void defaultHandlerCB (const SoError *error, void *userdata)

---

🔥 Detailed Description 🔥

The SoReadError class is used during model import operations. That's it, that's the job. 💖

When you're importing a model file, this class is the one that outputs any error or warning messages. It's giving loudspeaker for your file loader. 📢

Depending on your application, setting up your own error handler callbacks for SoReadError might be a good idea. Lowkey recommended, ngl. 😌

---

👑 Member Function Documentation 👑

🌸 void SoReadError::setHandlerCallback (SoErrorCB *const function, void *const data) [static]

This method sets the error handler callback for messages posted via this class. Cute, right? 🎀

⚠️ Note that this will not override the error/debug message handler for subclasses — those will have to be overridden by calling the subclass' setHandlerCallback() method. Do not skip this, bestie, or your subclass will be out here doing its own thing. 😭

See also: defaultHandlerCB()

🦋 SoErrorCB * SoReadError::getHandlerCallback (void ) [static]

Returns the error handler callback for messages posted via this class. ✨

💜 void * SoReadError::getHandlerData (void ) [static]

This method returns the pointer used for passing data back to the callback handler method. It's the little data handoff. 🫶

⭐ SoType SoReadError::getClassTypeId (void ) [static]

This static method returns the SoType for this class. The class-level type id, not the instance one.

See also: getTypeId()

🌈 SoType SoReadError::getTypeId (void ) const [virtual]

This method returns the SoType of a particular object instance. Instance-specific, periodt.

See also: getClassTypeId()

Reimplemented from SoError.

🔥 void SoReadError::post (const SoInput *const in, const char *const format, ...) [static]

Method used from import code to post error or warning messages for model files which are not 100% compliant to the format specification. Like, the file is trying its best but it's not exactly following the rules, you know? 🙈

The messages will be wrapped within information on line number, file offset etc. So your users actually get useful context instead of a mystery. 💅

🎀 SoErrorCB * SoReadError::getHandler (void *& data) const [protected], [virtual]

This is just a convenience wrapper around the getHandlerCallback() and getHandlerData() methods. Two-for-one, iconic. 👑

Reimplemented from SoError.

---

💖 Author 💖

Generated automatically by Doxygen for Coin from the source code. Not a human, just a very diligent robot. 🤖✨

---

okay bestie that's the whole page!! 💖✨🎀

This was Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it's the SoReadError(3) page from the Coin manual. Love u, go read your model files responsibly. 🦋🌸💜