Forr�s: ZeRo, sampforum.hu

Bevezet�

A foreach lecser�li a ciklusokat( legink�bb a j�t�kosokra vonatkoz�kat ) gyorsabb, �s m�g hat�konyabb ciklusokra. P�lda:

for( new i = 0; i != MAX_PLAYERS; ++i ) {
    if (IsPlayerConnected( i ) ) {
        printf( "J�t�kos %d csatlakozva van", i );
    }
}

Egyszer�en ezz� v�lik:

foreach( Player, i ) {
    printf( "J�t�kos[%d] csatlakozva van", i );   
}

Felh�vn�m a figyelmet, hogy ez nem csak egy egyszer� defin�ci�, ami az eredeti ciklust illeszti be m�s n�ven, hanem ez tulajdonk�ppen egy teljesen k�l�nb�z� be�gyaz�s, ami j�t�koslist�z�st haszn�l, emiatt gyorsabb az eredeti rendszern�l. S�t, a m�k�d�si elve miatt nem sz�m�t a MAX_PLAYERS �rt�ke, ak�r be van �ll�tva a te szerveredhez, ak�r nincs; Ez a ciklusfajta mindig ugyanannyi id� alatt fog lefutni, mivel ez CSAK a csatlakozott j�t�kosokat kezeli, �res azonos�t�kat nem.

Be�gyaz�s

Ez a f�ggv�nyk�nyvt�r ezt a rendszert haszn�lja, teh�t mind�ssze ennyit kell csin�lj:

#include <foreach>

Ezek ut�n m�r haszn�lhatod az �j ciklust.

Ha filterszkriptben szeretn�d haszn�lni ezt a rendszert, akkor tedd a k�vetkez�t:

#define FILTERSCRIPT
#include <foreach>

Ha a forr�sodban m�r szerepel a FILTERSCRIPT defin�ci�, akkor gy�z�dj meg r�la, hogy a foreach be�gyaz�sa F�L�TT legyen.

Deklar�ci�

Hogy l�trehozz egy iter�tort( egy elem, amit a foreach seg�ts�g�vel haszn�lhatsz ), haszn�ld a k�vetkez� k�dot:

new Iterator:MyIterator<10>;
Ez l�tre fogja hozni a "MyIterator" nev� iter�tort, amihez 10 f�r�helyet rendel.

Figyelmedbe aj�nlom, hogy ez a szintaxis ezen a k�don alapul, �s form�ra hasonl�t egy �tlagos v�ltoz� deklar�l�s�ra( t�bbr�t� elemek haszn�lata ), de ez nem egy t�mb, �gy az emberek nem esnek abba a hib�ba, hogy direkt m�don pr�b�lnak meg inform�ci�khoz hozz�f�rni, teh�t a szerkezet fontos.


Haszn�lata

A saj�t iter�torodat a k�vetkez� k�ppen haszn�lhatod:

foreach( MyIterator, var ) {
    printf( "V�ltoz�[%d] akt�v", var );
}

�rt�kek hozz�ad�sa:

Iter_Add( MyIterator, 7 );
�rt�kek t�rl�se:

Iter_Remove( MyIterator, 7 );
Ha egy v�letlenszer� �rt�ket szeretn�l lek�rdezni az iter�torodb�l GYORSAN( ez nagyon j� v�letlenszer� j�t�kosok kiv�laszt�s�ra ), csin�ld ezt:

Iter_Random( MyIterator );
J�t�koshoz:

new randomplayer = Iter_Random( Player );
F�ggv�nyek

• Iterator:n�v<m�ret>
  
  L�trehoz egy �j iter�tort a megadott n�vvel �s m�rettel. A rendszer automatikusan defini�lja a k�vetkez� iter�torokat:
  • Player - Minden csatlakozott j�t�kos
  • Bot (0.3) - Minden csatlakozott bot
  • NPC (0.3) - Minden csatlakozott bot( ugyan az, mint a Bot )
  • Character (0.3) - Minden csatlakozott j�t�kos �s bot
• Iter_Add(name,value)
  
  �rt�ket rendel hozz� a megadott iter�torhoz. A fentieket automatikusan kezeli.
   
• Iter_Remove(name,value)
  
  �rt�ket t�r�l a megadott iter�torb�l. A fentieket automatikusan kezeli.
   
• Iter_Clear(name)
  
  Teljesen ki�r�t egy iter�tort. Minden �rt�ket t�r�l.
   
• Iter_Random(name)
  
  Visszat�r egy v�letlenszer� �rt�kkel a megadott iter�torb�l. Hasznos v�letlenszer� j�t�kosok kiv�laszt�s�hoz( ez sokkal gyorsabb, mint a t�bbi ehhez hasonl� m�dszer, a k�d strukt�r�ja miatt ).
   
• Iter_Count(name)
  
  Visszat�r egy megadott iter�tor elemeinek sz�m�val( p�ld�ul h�ny csatlakozott j�t�kos van a szerveren ) - NAGYON gyorsan
   
• IteratorArray:name[num]<size>
  
  L�trehoz egy �j multidimenzi�s iter�tort a megadott n�vvel, �s a maxim�lis t�rol�si m�rettel.
   
• Iter_Init(name)
  
  Ha l�trehozt�l egy multidimenzi�s iter�tort, akkor ezt a f�ggv�nyt meg KELL h�vnod, miel�tt b�rmit is rakn�l bele.
   
• Iter_Func2(name,index,pars)
  
  Felh�vom a figyelmet, hogy ezek a f�ggv�nyek el lettek t�vol�tva a leg�jabb verzi�ban - most m�r csak szimpl�n meg kell indexelned a t�mb�t.
  
  Ha a "2" szerepel a fenti f�ggv�nyek v�g�n, �s az iter�torod v�g�n( de a param�terek EL�TT ) egy index �ll, akkor multidimenzi�s iter�tort kapsz. P�ld�ul:
  
  
  Pawn: [Kijel�l�s]
  new IteratorArray:My2d[3]<5>;

Iter_Init2(My2d);
Iter_Add2(My2d, 1, 4);
  
  Ezzel l�trehozol 3 5-elemes iter�tort, �s a m�sodikhoz hozz�adod a 4-et �rt�kk�nt.
  Ford�t�si be�ll�t�sok
  
  A be�gyaz�s el�tt defini�lhatsz p�r dolgot, hogy testreszabd a foreach funkci�it.
  • FOREACH_NO_BOTS
    Ha csak j�t�kosokra akarod vonatkoztatni a ciklusaidat, akkor haszn�ld ezt a defin�ci�t, hogy megsz�ntesd a k�dot, ami a botokat(NPC) n�zi.
  • FOREACH_NO_PLAYERS
    Ezzel megsz�nteted a j�t�kosok �S botok sz�ml�l�s�t, �gy csak a f� funkci�k lesznek el�rhet�k.
• T�bbr�t� dimenzi�k
  
  Az el�z� kiad�s minden f�ggv�ny�nek volt egy "Iter_Func2" v�ltozata - ezek most t�r�lve lettek egy m�g egy�rtelm�bb szintaxis l�trehoz�s�nak �rdek�ben:
  
  Mostant�l l�trehozhatsz t�bbr�t� iter�torokat is. P�ld�ul egy iter�torokb�l �ll� t�mb�t, ami a j�t�kosok j�rm�it tartalmazza( hab�r volna jobb javaslatom is ennek megold�s�ra ):
  
  
  Pawn: [Kijel�l�s]
  foreach( PlayerVehicles[ playerid ], veh ) {
    //Itt csin�lhatsz valamit az adott j�t�kos j�rm�v�vel
}
  
  Multidimenzi�s iter�torok l�trehoz�s�hoz meg kell h�vnod ezt a f�ggv�nyt:
  
  
  Pawn: [Kijel�l�s]
  Iter_Init( iterator );
  Az iter�tor haszn�lata el�tt. Az egyszer� iter�torokat inicializ�lhatod a ford�t�si id� k�zben, de a multidimenzi�sokat nem.
  
  P�ld�k
  
  Els� p�lda
  
  Multidimenzi�s iter�torok. Ezzel egy iter�torokb�l �ll� t�mb�t hozhatsz l�tre:
  
  
  Pawn: [Kijel�l�s]
  #include <foreach>

new IteratorArray:Vehicle[4]<20>;

public OnGameModeInit()
{
    //El�sz�r EZT KELL megh�vnod multidimenzi�s iter�torokn�l.
    Iter_Init(Vehicle);
    //Hozz�ad�s az ELS� list�hoz
    Iter_Add(Vehicle[0], AddStaticVehicle(454, -1364.0269, 1470.2139, 0.3568, 165.0191, -1, -1));
    Iter_Add(Vehicle[0], AddStaticVehicle(484, -1394.0040, 1468.3309, 0.1742, 99.7403, -1, -1));
    Iter_Add(Vehicle[0], AddStaticVehicle(484, -1404.9385, 1507.1971, -0.0963, 60.9265, -1, -1));
    Iter_Add(Vehicle[0], AddStaticVehicle(446, -1603.1550, 1391.8168, -0.8820, 310.2346, -1, -1));
    //Hozz�ad�s a M�SODIK list�hoz
    Iter_Add(Vehicle[1], AddStaticVehicle(446, -1698.8333, 1411.8612, -0.4988, 333.6676, -1, -1));
    Iter_Add(Vehicle[1], AddStaticVehicle(446, -1710.4403, 1430.0688, -0.5722, 322.3057, -1, -1));
    Iter_Add(Vehicle[1], AddStaticVehicle(473, -1623.9312, 1438.3147, -0.2109, 280.8999, -1, -1));
    //Hozz�ad�s a HARMADIK list�hoz
    Iter_Add(Vehicle[2], AddStaticVehicle(473, -1609.0120, 1405.0123, -0.1395, 300.4936, -1, -1));
    Iter_Add(Vehicle[2], AddStaticVehicle(487, -1651.4410, 1302.6608, 7.2126, 310.4509, -1, -1));
    //Hozz�ad�s a NEGYEDIK list�hoz
    Iter_Add(Vehicle[3], AddStaticVehicle(487, -1736.8011, 1400.1903, 7.3641, 293.3916, -1, -1));
    //V�gigmegy�nk a m�sodik lista �sszes j�rm�v�n
    foreach (Vehicle[1], veh)
    {
        ChangeVehicleColor(veh, 0, 10);
    }
    //V�gigmegy�nk az els� lista �sszes j�rm�v�n
    foreach (Vehicle[0], veh)
    {
        ChangeVehicleColor(veh, 12, 20);
    }
}
  
  M�sodik p�lda
  
  Multidimenzi�s iter�torok. L�trehozunk egy iter�torokb�l �ll� t�mb�t, �s a j�rm�veket egy �sszetett list�hoz hozz�adjuk.
  
  
  Pawn: [Kijel�l�s]
  #include <foreach>

new IteratorArray:Vehicle[4]<20>;

public OnGameModeInit()
{
    //El�sz�r EZT KELL megh�vnod multidimenzi�s iter�torokn�l.
    Iter_Init(Vehicle);
    new
        veh;
    veh = AddStaticVehicle(454, -1364.0269, 1470.2139, 0.3568, 165.0191, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[2], veh);
    veh = AddStaticVehicle(484, -1394.0040, 1468.3309, 0.1742, 99.7403, -1, -1);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[2], veh);
    Iter_Add(Vehicle[3], veh);
    veh = AddStaticVehicle(484, -1404.9385, 1507.1971, -0.0963, 60.9265, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[2], veh);
    Iter_Add(Vehicle[3], veh);
    veh = AddStaticVehicle(446, -1603.1550, 1391.8168, -0.8820, 310.2346, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[3], veh);
    veh = AddStaticVehicle(446, -1698.8333, 1411.8612, -0.4988, 333.6676, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[2], veh);
    veh = AddStaticVehicle(446, -1710.4403, 1430.0688, -0.5722, 322.3057, -1, -1);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[2], veh);
    Iter_Add(Vehicle[3], veh);
    veh = AddStaticVehicle(473, -1623.9312, 1438.3147, -0.2109, 280.8999, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[2], veh);
    Iter_Add(Vehicle[3], veh);
    veh = AddStaticVehicle(473, -1609.0120, 1405.0123, -0.1395, 300.4936, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[3], veh);
    veh = AddStaticVehicle(487, -1651.4410, 1302.6608, 7.2126, 310.4509, -1, -1);
    Iter_Add(Vehicle[0], veh);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[2], veh);
    veh = AddStaticVehicle(487, -1736.8011, 1400.1903, 7.3641, 293.3916, -1, -1);
    Iter_Add(Vehicle[1], veh);
    Iter_Add(Vehicle[2], veh);
    Iter_Add(Vehicle[3], veh);
    //V�gigmegy�nk a m�sodik lista �sszes j�rm�v�n
    foreachex (Vehicle[1], veh)
    {
        ChangeVehicleColor(veh, 0, 10);
    }
    //V�gigmegy�nk az els� lista �sszes j�rm�v�n
    foreachex (Vehicle[0], veh)
    {
        ChangeVehicleColor(veh, 12, 20);
    }
}
  
  Harmadik p�lda
  
  V�gigmegy�nk az �sszes boton( csak 0.3 ).
  
  
  Pawn: [Kijel�l�s]
  foreach (Bot, botid)
{
    SetPlayerPos(botid, 0.0, 0.0, 10.0); //Minden NPC-t a p�lya k�zep�re helyez�nk
}
  
  Negyedik p�lda
  
  L�trehozunk egy �j iter�tort 20 j�rm� sz�m�ra, �s megv�ltoztatjuk a sz�n�ket.
  
  
  Pawn: [Kijel�l�s]
  #include <foreach>

new Iterator:Vehicle<20>;

public OnGameModeInit()
{
    Iter_Add(Vehicle, AddStaticVehicle(454, -1364.0269, 1470.2139, 0.3568, 165.0191, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(484, -1394.0040, 1468.3309, 0.1742, 99.7403, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(484, -1404.9385, 1507.1971, -0.0963, 60.9265, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(446, -1603.1550, 1391.8168, -0.8820, 310.2346, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(446, -1698.8333, 1411.8612, -0.4988, 333.6676, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(446, -1710.4403, 1430.0688, -0.5722, 322.3057, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(473, -1623.9312, 1438.3147, -0.2109, 280.8999, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(473, -1609.0120, 1405.0123, -0.1395, 300.4936, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(487, -1651.4410, 1302.6608, 7.2126, 310.4509, -1, -1));
    Iter_Add(Vehicle, AddStaticVehicle(487, -1736.8011, 1400.1903, 7.3641, 293.3916, -1, -1));
    foreach (Vehicle, vid)
    {
        ChangeVehicleColor(vid, 0, 10);
    }
}
  
  Id�eredm�nyek
  
  Mint m�r eml�tettem, ez a strukt�ra gyorsabb, mint az alap ciklusok, itt a bizony�t�k.
  
  Let�lt�s
  
  http://pastebin.com/2wduLfcq
  
  

  ---

  
  Eredeti t�ma itt.