Method setPrefixedDynamicDataField

Engine/source/console/simObject.cpp:1259–1317

//-----------------------------------------------------------------------------

void SimObject::setPrefixedDynamicDataField(StringTableEntry fieldName, const char *array, const char *value, const S32 fieldType)
{
   // Sanity!
   AssertFatal(fieldName != NULL, "Cannot set object field value with NULL field name.");
   AssertFatal(value != NULL, "Field value cannot be NULL.");

   // Set value without prefix if no field type was specified.
   if (fieldType == -1)
   {
      setDataField(fieldName, NULL, value);
      return;
   }

   // Fetch the console base type.
   ConsoleBaseType* pConsoleBaseType = ConsoleBaseType::getType(fieldType);

   // Did we find the console base type?
   if (pConsoleBaseType == NULL)
   {
      // No, so warn.
      Con::warnf("setPrefixedDynamicDataField() - Invalid field type '%d' specified for field '%s' with value '%s'.",
         fieldType, fieldName, value);
   }

   // Set value without prefix if there's no value or we didn't find the console base type.
   if (*value == 0 || pConsoleBaseType == NULL)
   {
      setDataField(fieldName, NULL, value);
      return;
   }

   // Fetch the field prefix.
   StringTableEntry fieldPrefix = pConsoleBaseType->getTypePrefix();

   // Sanity.
   AssertFatal(fieldPrefix != NULL, "Field prefix cannot be NULL.");

   // Do we have a field prefix?
   if (fieldPrefix == StringTable->EmptyString())
   {
      // No, so set the data field in the usual way.
      setDataField(fieldName, NULL, value);
      return;
   }

   // Yes, so fetch the length of the field prefix.
   const U32 fieldPrefixLength = dStrlen(fieldPrefix);

   // Yes, so does it start with the object field prefix?
   if (dStrnicmp(value, fieldPrefix, fieldPrefixLength) != 0)
   {
      // No, so set the data field in the usual way.
      setDataField(fieldName, NULL, value);
      return;
   }

   // Yes, so set the data excluding the prefix.
   setDataField(fieldName, NULL, value + fieldPrefixLength);