SbName(3)

📦 version 2.5.0, in fedora 43, fedora 44

✨ SbName — Library Functions Manual ✨

okay bestie, buckle up 💖 this is SbName(3), and it's literally the class that keeps every string in Coin-land on a first-name basis with every other identical string. group-chat energy but for memory addresses. let's get into it 🦋

🌸 NAME 🌸

SbName — the SbName class stores strings by reference. periodt.

🎀 SYNOPSIS 🎀

#include <Inventor/SbName.h>

💅 Public Member Functions

SbName (void)
SbName (const char *nameString)
SbName (const SbString &str)
SbName (const SbName &name)
~SbName (void)
const char * getString (void) const
int getLength (void) const
int operator! (void) const
operator const char * (void) const

🌈 Static Public Member Functions

static SbBool isIdentStartChar (const char c)
static SbBool isIdentChar (const char c)
static SbBool isBaseNameStartChar (const char c)
static SbBool isBaseNameChar (const char c)

🫶 Friends

int operator== (const SbName &lhs, const char *rhs)
int operator== (const char *lhs, const SbName &rhs)
int operator== (const SbName &lhs, const SbName &rhs)
int operator!= (const SbName &lhs, const char *rhs)
int operator!= (const char *lhs, const SbName &rhs)
int operator!= (const SbName &lhs, const SbName &rhs)

💜 Detailed Description 💜

The SbName class stores strings by reference. no cap, that's the whole personality.

Coin uses this class to store keywords, names and other strings. The way it works is iconic: they're stored in a manner where identical strings are guaranteed to map to the same memory address (as returned by the SbName::getString() method). one string, one address, no duplicates, we don't do that here 💅

Why is that a slay? Because the main advantage of storing identical strings to the same memory address is that it simplifies comparison operations, and particularly when working with string data as keys in other data structures, like e.g. in hash (dictionary) tables. chef's kiss behavior fr fr.

Apart from that, mapping identical strings to the same memory address can also save on memory resources, and provide run-time optimizations. String comparisons for SbName objects are very efficient, for instance. like, very. ✨

⚠️ okay bestie this next part is the vibe check you cannot skip: there is an aspect of using SbName instances that it is important to be aware of — since strings are stored permanently, using SbName instances in code where there is continually changing strings or the continual addition of new unique strings will in the end swamp memory resources. 😭 So where possible, use SbString instances instead. please. for me.

See also

SbString

🧚 Constructor & Destructor Documentation 🧚

🌟 SbName::SbName (void )

This is the default constructor. the little blank canvas moment 🎀

Referenced by operator!=, operator!=, operator!=, operator==, operator==, operator==, and SbName().

🌟 SbName::SbName (const char * nameString)

Constructor. Adds the nameString string to the name table. welcome to the table, babe 💖

🌟 SbName::SbName (const SbString & str)

Constructor. Adds str to the name table.

References SbString::getString().

🌟 SbName::SbName (const SbName & name)

Copy constructor.

References SbName().

🌟 SbName::~SbName (void )

The destructor. say bye 👋

👑 Member Function Documentation 👑

💫 const char * SbName::getString (void ) const

This method returns pointer to character array for the name.

The returned memory pointer for the character string is guaranteed to be valid for the remaining life time of the process, even after all SbName instances referencing the string has been destructed. like, it outlives them. main character energy honestly.

Referenced by a truly unhinged number of things, and we're listing every single one because we don't gatekeep:

  • SoGLRenderAction::abortNow()
  • SoNodeKitListPart::addChild()
  • SoNodeKitListPart::addChildType()
  • SoDB::addConverter()
  • SoOutput::addDEFNode()
  • SoNodekitCatalog::addEntry()
  • SoFieldData::addField()
  • SoNodekitCatalog::addListItemType()
  • SoInput::addReference()
  • SoNotList::append()
  • SoPath::append()
  • SoPath::append()
  • SoField::connectFrom()
  • SoBase::connectRoute()
  • SoDB::createGlobalField()
  • SoBaseKit::createPathToAnyPart()
  • SoDB::createRoute()
  • SoType::createType()
  • SoBase::destroy()
  • SoInput::findReference()
  • SoType::fromName()
  • SoBaseKit::getAnyPart()
  • SoBaseKit::getContainerNode()
  • SoState::getElement()
  • SoBase::getFileFormatName()
  • SoGlyph::getGlyph()
  • SoBaseKit::getPartString()
  • SoOffscreenRenderer::getWriteFiletypeInfo()
  • SoNode::GLRenderS()
  • SoNodeKitListPart::insertChild()
  • SoType::isDerivedFrom()
  • SoOffscreenRenderer::isWriteSupported()
  • SoOutput::lookupDEFNode()
  • SoNotList::print()
  • SoReplacedElement::print()
  • SoState::print()
  • SoNodekitCatalog::printCheck()
  • SoDebug::printName()
  • SoBaseKit::printSubDiagram()
  • SoBaseKit::printTable()
  • SoAction::pushCurPath()
  • SoBase::read()
  • SoDB::read()
  • SoDB::read()
  • SoField::read()
  • SoFieldData::read()
  • SoField::readConnection()
  • SoFieldData::readFieldDescriptions()
  • SoBase::readRoute()
  • SoGroup::removeChild()
  • SoOutput::removeDEFNode()
  • SoPath::removeIndex()
  • SoChildList::removePathAuditor()
  • SoInput::removeReference()
  • SoDB::removeRoute()
  • SoDB::renameGlobalField()
  • SoGroup::replaceChild()
  • SoNodeKitListPart::replaceChild()
  • SoNodeKitListPart::replaceChild()
  • SoPath::replaceIndex()
  • SoTransformManip::replaceNode()
  • SoOutput::resolveRoutes()
  • SoMFEnum::set1Value()
  • SoBaseKit::setAnyPart()
  • SoInteractionKit::setAnyPartAsDefault()
  • SoInteractionKit::setAnyPartAsDefault()
  • SoInteractionKit::setAnySurrogatePath()
  • SoOutput::setCompression()
  • SoNodeKitListPart::setContainerType()
  • SoBase::setName()
  • SoBaseKit::setPart()
  • SoMFEnum::setValue()
  • SoSFEnum::setValue()
  • SoConcatenate::SoConcatenate()
  • SoGate::SoGate()
  • SoSelectOne::SoSelectOne()
  • SoBaseKit::typeCheck()
  • SoFieldData::write()
  • SoNode::write()
  • SoOutput::write()
  • SoVRMLScript::write()
  • SoField::writeConnection()
  • SoBase::writeHeader()
  • and SoOffscreenRenderer::writeToFile()

💫 int SbName::getLength (void ) const

This method returns the number of characters in the name. just counting, bestie 🔢

Referenced by SoBase::destroy(), SoBase::setName(), SoFieldData::write(), SoNode::write(), and SoBase::writeHeader().

💫 SbBool SbName::isIdentStartChar (const char c) [static]

This method checks if the c character is a valid identifier start character for a name.

See also

SbBool SbName::isIdentChar(const char c)

References isIdentChar().

💫 SbBool SbName::isIdentChar (const char c) [static]

This method checks if the c character is a valid character for a name.

See also

SbBool SbName::isIdentStartChar(const char c)

Referenced by isIdentStartChar().

💫 SbBool SbName::isBaseNameStartChar (const char c) [static]

Returns TRUE if the given character is valid for use as the first character of a name for an object derived from a class inheriting SoBase.

SoBase derived objects needs to be named in a manner which will not clash with the special characters reserved as tokens in the syntax rules of Open Inventor and VRML files. we are ✨respecting the grammar✨.

Legal characters for the first character of an SoBase object name is underscore ("_") and any uppercase and lowercase alphabetic character from the ASCII character set (i.e. A-Z and a-z).

🫶 heads up: this method is not part of the original Open Inventor API.

See also

isBaseNameChar()

Referenced by SoBase::setName().

💫 SbBool SbName::isBaseNameChar (const char c) [static]

Returns TRUE if the given character is valid for use in naming object instances of classes derived from SoBase.

SoBase derived objects needs to be named in a manner which will not clash with the special characters reserved as tokens in the syntax rules of Open Inventor and VRML files.

Legal characters to use for an SoBase object name is any character from the ASCII character set from and including character 33 (hex 0x21) to and including 126 (hex 0x7e), except single and double apostrophes, the plus sign and punctuation, backslash and the curly braces. so basically the whole printable range minus the drama queens 💀

🫶 again: this method is not part of the original Open Inventor API.

See also

isBaseNameStartChar()

Referenced by SoBase::setName().

💫 int SbName::operator! (void ) const

This unary operator results in FALSE if the SbName object is non-empty and TRUE if the SbName object is empty. An empty name contains a null-length string. yes it's backwards from what you'd guess, no we're not going to explain it further, that's just the lore 🙈

💫 SbName::operator const char * (void ) const

This operator returns a pointer to the character array for the name string. It is intended for implicit use. Use SbName::getString() explicitly instead of this operator — it might be removed later. ⚠️ so like, don't get attached.

See also

const char * SbName::getString(void)

🌈 int operator== (const SbName & lhs, const char * rhs) [friend]

This operator checks for equality and returns TRUE if so, and FALSE otherwise.

References SbName().

🌈 int operator== (const char * lhs, const SbName & rhs) [friend]

This operator checks for equality and returns TRUE if so, and FALSE otherwise.

References SbName().

🌈 int operator== (const SbName & lhs, const SbName & rhs) [friend]

This operator checks for equality and returns TRUE if so, and FALSE otherwise.

References SbName().

🌈 int operator!= (const SbName & lhs, const char * rhs) [friend]

This operator checks for inequality and returns TRUE if so, and FALSE if the names are equal.

References SbName().

🌈 int operator!= (const char * lhs, const SbName & rhs) [friend]

This operator checks for inequality and returns TRUE if so, and FALSE if the names are equal.

References SbName().

🌈 int operator!= (const SbName & lhs, const SbName & rhs) [friend]

This operator checks for inequality and returns TRUE if so, and FALSE if the names are equal.

References SbName().

⭐ Author ⭐

Generated automatically by Doxygen for Coin from the source code. not a human, just vibes 🤖✨

and that's the whole page, bestie 🥹💖 this was Coin, Version 2.5.0, and the manual page is SbName(3). slay, ate, no crumbs, see u in the next one 🎀🦋💅

📦 where this page comes from