Разбор кода Nebula Device2. Часть3. Контейнеры (статья 1 - Списки) (комментарии)

////////////////////////////////////////////////////////////////////////
// Demonstration of nList (c) Marat Sungatullin (graveman), 2016

#include <stdio.h>
#include <conio.h>
#include <stdlib.h>
#include <time.h>

// Макрос __WIN32__ определен при использовании компилятора Borland, а у нас Visual C++.
// Для 32-х битных приложений Windows в Visual C++ определен макрос _WIN32.
#ifdef _WIN32
#define __WIN32__
#endif

#include "util/nstring.h"
#include "util/nlist.h"



void GoOn()
{
  printf ("Press a key for continue...\n");
  getch();
  printf("\n");
}



// Небольшое демо, показывающее операции со списком
void Demo()
{
  const int NQ2WEAPON = 11;
  nString q2WeaponNames[NQ2WEAPON] = 
  {
    "Shotgun", 
    "Blaster",
    "Super Shotgun",
    "Hyperblaster",
    "Machine Gun",
    "Chain Gun",
    "Rocket Launcher",
    "Grenade",
    "Grenade Launcher",
    "Railgun",
    "BFG"
  };
  

  // Печатаем название демо
  printf ("Demo - q2 weapons for demonstration nList class\n"
      "------------------------------------------------\n\n");
  
  // Имитируем процесс сбора оружия игроком 
  nList pickedWeapons;


  // Соберем пять случайных пушек
  srand((int) time(0));
  for (int i = 0; i < 5; i++)
  {
    // выбираем случайный индекс из таблицы q2WeaponNames
    int nIndex = (int)(((float)rand() / (float)RAND_MAX) * NQ2WEAPON);
    // проверяем, не было ли уже добавлено оружие с этим именем
    bool fWeaponPicked = false;
    for (nNode* n = pickedWeapons.GetHead(); n != 0; n = n->GetSucc())
    {
      nString* pStr = (nString*)n->GetPtr();
      if (q2WeaponNames[nIndex] == (*pStr))
      {
        fWeaponPicked = true;
        break; // нет нужды проверять остальные узлы
      }
    }
    // Если не было, добавляем
    if (!fWeaponPicked) pickedWeapons.AddHead(new nNode((void*)&q2WeaponNames[nIndex]));
  }
  
  // Печатаем, что собрали
  printf ("Player picked this weapons:\n");
  for (nNode* n = pickedWeapons.GetHead(); n != 0; n = n->GetSucc())
  {
    nString* pStr = (nString*)n->GetPtr();
    printf ("%s;\n", pStr->Get());
  }
  
  GoOn();
  printf("Clear resources of demo...\n");

  // Очистка ресурсов
  while (!pickedWeapons.IsEmpty())
  {
    // ReamHead() удаляет первый нод за головой списка 
    // и возвращает его указатель
    delete pickedWeapons.RemHead();
  }
}



int main()
{
  Demo();

  // quit
    printf("Press any key to quit...");
    getch();
    return 0;
}