Справочник

Что такое EditAnywhere

EditAnywhere - самый универсальный спецификатор UPROPERTY.
Он позволяет редактировать переменную везде, где появляется панель Details:

• в Class Defaults (настройки класса по умолчанию)
• в каждом отдельном экземпляре актора на уровне
• в компонентах, структурах, вложенных объектах

Это означает, что одно и то же свойство можно настраивать как глобально (для всех объектов), так и индивидуально (для каждого объекта в сцене)..

Когда использовать EditAnywhere

• когда хочешь настраивать значения для каждого объекта на сцене
• нужна гибкость и на уровне класса, и на уровне экземпляра

Пример кода

UCLASS()
class MYGAME_API AMyClass : public AActor
{
    GENERATED_BODY()

public:

    UPROPERTY(EditAnywhere)
    FString Property = "";

    UPROPERTY(EditDefaultsOnly)
    FString DefaultOnlyProperty = "";

};

Как это выглядит в редакторе

В Class Defaults меняешь → влияет на все новые экземпляры.
В размещённом акторе меняешь → переопределяется только этот экземпляр.

Сравнение с EditDefaultsOnly и EditInstanceOnly

Что такое TOptional<T>

TOptional<T> — это шаблонный тип, обертка в которую мы оборачиваем нужный нам тип данных, которое может быть установлено или отсутствовать.

Зачем нужен TOptional<T>

Если нам нужно проверить были записаны какие либо данные в переменную или нет.
В обычной ситуации мы создадим новую переменную записываем в нее значения а после сравниваем с «Магическим значением» что обязывает нас помнить и учитывать такие проверки а если их будет несколько риск ошибки на ровном месте возрастает в разы

Пример кода с проверкой на «Магическое значение»

UPROPERTY(EditDefaultsOnly)
TArray<UObject*> ItemSlots;
	
int32 FindFirstEmptySlot()
{
	for (int32 i = 0; i < ItemSlots.Num(); i++)
	{
		if (IsValid(ItemSlots[i]))
		{
			return  i;
		}
	}
	return -1;
}

void AddItemSlot(UObject* NewItem)
{
	int32 EmptySlot = FindFirstEmptySlot();
	if (EmptySlot != -1)
	{
			
	}
}

UPROPERTY(EditDefaultsOnly)
TArray<UObject*> ItemSlots;
	
int32 FindFirstEmptySlot()
{
	for (int32 i = 0; i < ItemSlots.Num(); i++)
	{
		if (IsValid(ItemSlots[i]))
		{
			return  i;
		}
	}
	return -1;
}

void AddItemSlot(UObject* NewItem)
{
	int32 EmptySlot = FindFirstEmptySlot();
	if (EmptySlot != -1)
	{
			
	}
}

В этом коде после поиска слота мы должны проверить найден ли он, а для этого нам необходимо сравнить его с каким-то «магическое значение»

• нужно помнить, что -1 означает «не найдено»
• для разных типов придётся использовать разные значения
• легко допустить ошибку при сравнении

TOptional<T> решает эту проблему теперь нам не нужно будет придумывать какие-то значения если мы ничего не нашли теперь у нас есть единообразная проверка для всех подобных случаев и при замене типа нам не нужно будет менять условия во всех местах где использовался этот тип данных

TOptional<int32> FindFirstEmptySlot()
{
	for (int32 i = 0; i < ItemSlots.Num(); i++)
	{
		if (IsValid(ItemSlots[i]))
		{
				return  i;
		}
	}
	return TOptional<int32>();
}

void AddItemSlot(UObject* NewItem)
{
	TOptional<int32> EmptySlot = FindFirstEmptySlot();
	if (EmptySlot.IsSet())
	{
		int32 Value = EmptySlot.GetValue();	
	}
}

TOptional<int32> FindFirstEmptySlot()
{
	for (int32 i = 0; i < ItemSlots.Num(); i++)
	{
		if (IsValid(ItemSlots[i]))
		{
				return  i;
		}
	}
	return TOptional<int32>();
}

void AddItemSlot(UObject* NewItem)
{
	TOptional<int32> EmptySlot = FindFirstEmptySlot();
	if (EmptySlot.IsSet())
	{
		int32 Value = EmptySlot.GetValue();	
	}
}

Что изменилось

• код становится чище и безопаснее
• мы не используем «магические значения»
• одинаковая проверка для любых типов

Когда использовать TOptional<T>

• Вместо «магических значений»
• нужно явно показать, что результат может быть пустым
• Когда значение может отсутствовать, но не является ошибкой

Когда не нужно использовать

• yже используется указатель
• когда нет нужды проверять значение есть или нет

⚠️ важно помнить если вы вызовете GetValue() метод для неинициализированного значения то вы получите краш игры или редактора

if (EmptySlot.IsSet())
{
    int32 Value = EmptySlot.GetValue();
}

if (EmptySlot.IsSet())
{
    int32 Value = EmptySlot.GetValue();
}