Method getPrefixedDynamicDataField

Engine/source/console/simObject.cpp:1209–1255

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

const char *SimObject::getPrefixedDynamicDataField(StringTableEntry fieldName, const char *_array, const S32 fieldType)
{
   // Sanity!
   AssertFatal(fieldName != NULL, "Cannot get field value with NULL field name.");

   // Fetch field value.
   const char* pFieldValue = getDataField(fieldName, _array);

   // Sanity.
   AssertFatal(pFieldValue != NULL, "Field value cannot be NULL.");

   // Return the field if no field type is specified.
   if (fieldType == -1)
      return pFieldValue;

   // Return without the prefix if there's no value.
   if (*pFieldValue == 0)
      return StringTable->EmptyString();

   // 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("getPrefixedDynamicDataField() - Invalid field type '%d' specified for field '%s' with value '%s'.",
         fieldType, fieldName, pFieldValue);
   }

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

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

   // Calculate a buffer size including prefix.
   const U32 valueBufferSize = dStrlen(fieldPrefix) + dStrlen(pFieldValue) + 1;

   // Fetch a buffer.
   char* pValueBuffer = Con::getReturnBuffer(valueBufferSize);

   // Format the value buffer.
   dSprintf(pValueBuffer, valueBufferSize, "%s%s", fieldPrefix, pFieldValue);

   return pValueBuffer;
}

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