Sztringkezelõ függvények Az strlen függvény:Funkciója:Az strlen függvény segítségével lekérdezhetjük az általunk megadott karakterlánc hosszúságát( karaktereinek számát ).
Paraméter( ek ):
string[ ] = A karakterlánc, aminek a méretére kíváncsiak vagyunk.
Visszatérési értéke:A függvény visszatérési értéke a karakterlánc
karaktereinek száma.
Példa:Az alábbi eljárásban lekérdezzük a \'strlen\' karakterlánc hosszúságát, és ha az egyenlõ 6 - tal, akkor visszatérünk az 1 értékkel.
public OnFilterScriptInit( ) {
if( strlen( \"strlen\" ) == 6 ) return 1;
return 0;
}
Az strcat függvény:Funkciója:Az strcat függvény két általunk megadott karakterláncot fûz össze, és az így keletkezett sztringgel tér vissza.
Paraméter( ek ):
dest[ ] = A karakterlánc, amihez hozzáfûzzük a másik karakterláncot.
source[ ] = A karakterlánc, amit hozzáfûzzük a másik karakterlánchoz.
maxlength[ ] = A célkaraktertömb maximális hosszúsága. Ezt nem kötelezõ megadnunk, hiszen a függvény alapból rendel hozzá értéket( a célkaraktertömb méretét ).
Visszatérési értéke:A függvény visszatérési értéke az összecsatolt karakterlánc( dest ).
Példa:Az alábbi eljárásban összefûzünk két sztringet, és kiíratjuk a konzolba.
public OnFilterScriptInit( ) {
new szDest[ 20 ] = \"Megtanultam az \",
szSrc[ 20 ] = \"strcat függvényt!\";
strcat( szDest, szSrc, sizeof szDest + sizeof szSrc ); //Az alapértelmezett hely nem lett volna elegendo, így módosítottam.
print( szDest );
}
Az strmid függvény:Funkciója:Az strmid függvény segítségével egy karakterlánc általunk megadott szakaszát egy célkarakterláncba másolhatjuk.
Paraméter( ek ):
dest[ ] = A célkarakterlánc( amibe másoljuk a másik karakterláncot ).
source[ ] = A karakterlánc, amibõl másolunk a célkarakterláncba.
start = A másolás kezdõpontja( karaktere ).
end = A másolás végpontja( karaktere ).
maxlength[ ] = A célkaraktertömb maximális hosszúsága. Ezt nem kötelezõ megadnunk, hiszen a függvény alapból rendel hozzá értéket( a célkaraktertömb méretét ).
Visszatérési értéke:A függvény visszatérési értéke a célkarakterlánc lesz.
Példa:Az alábbi eljárásban a \'szSrc\' sztringbol kimásolunk 4 karaktert a \'szDest\' sztringbe, majd kiíratjuk a konzolba( meglepo eredménnyel
).
public OnFilterScriptInit( ) {
new szSrc[ 32 ] = \"Ezt a leírást ZeRo írta.\",
szDest[ 12 ];
strmid( szDest, szSrc, 14, 19 );
print( szDest );
}
Az strdel függvény:Funkciója:Az strdel függvény segítségével egy karakterlánc általunk megadott szakaszát törölhetjük.
Paraméter( ek ):
string[ ] = A karakterlánc, amiben törlünk.
start = A törlés kezdõpontja( karaktere ).
end = A törlés végpontja( karaktere ).
Visszatérési értéke:A függvény visszatérési értéke az \'új\' sztring lesz, amibõl töröltünk.
Példa:Az alábbi eljárásban a \'szStr\' sztringbõl kitöröljük az elsõ 3 karaktert( az eredmény \'del\' lesz ).
public OnFilterScriptInit( ) {
new szStr[ 7 ] = \"Strdel\";
strdel( szStr, 0, 3 );
print( szStr );
}
Az strcmp függvény:Funkciója:Az strcmp függvény segítségével összehasonlíthatunk két karakterláncot.
Paraméter( ek ):
string1[ ] = Az egyik karakterlánc.
string2[ ] = A másik karakterlánc.
ignorecase = Logikai értékû paraméter( Hamis[ false ], vagy igaz [ true ], azaz 0, vagy 1 ), ha az értéke igaz( 1 ), akkor az összehasonlításban a kis-, és nagybetûket nem fogja különbségnek számítani.
length = Az összehasonlítás végpontja( karaktere ). Ezt a paramétert nem muszáj megadnunk, hiszen alapértelmezett értéke a sztring( ek ) hosszúsága.
Visszatérési értéke:A függvény visszatérési értéke
0, ha a két sztring egyezik, és valamilyen más szám,
ha nem egyeznek.
Példa:Az alábbi eljárásban összehasonlítunk két karakterláncot; Ha egyeznek, akkor igaz értékkel, ha nem, hamis értékkel térünk vissza( Itt: A visszatérési érték
igaz lesz ).
public OnFilterScriptInit( ) {
if( strcmp( \"Ez hasznos függvény\", \"ez HasznoS FüGGvénY\", true ) == 0 ) return true;
else return false;
}
Az strfind függvény:Funkciója:Az strfind függvény segítségével ellenõrizhetjük, hogy egy adott karakterlánc megtalálható - e egy másikban.
Paraméter( ek ):
string[ ] = A karakterlánc, amit keresünk.
sub[ ] = A karakterlánc, amiben keresünk.
ignorecase = Logikai értékû paraméter( Hamis[ false ], vagy igaz [ true ], azaz 0, vagy 1 ), ha az értéke igaz( 1 ), akkor az összehasonlításban a kis-, és nagybetûket nem fogja különbségnek számítani.
pos = A keresés kezdõpontja( karaktere ). Alapértelmezett értéke van, a karakterlánc eleje.
Visszatérési értéke:A függvény visszatérési értéke
-1, ha a \'string\' karakterlánc nincs benne a \'sub\' sztringben
Egy indexszám( nem -1 ), ami a találat kezdõpontjára( karakterére ) mutat.
Példa:Az alábbi példában igaz értékkel térünk vissza, ha az \'Értem a strfind függvényt\' karakterláncban megtaláljuk a \'strfind\' sztringet.
public OnFilterScriptInit( ) {
if( strfind( \"Értem a strfind függvényt\", \"StRFinD\" ) ) return true;
return false;
}
Az strval függvény:Funkciója:Az strval függvény segítségével egy karakterláncot integerré( egész számmá ) konvertálhatunk.
Paraméter( ek ):
string[ ] = A karakterlánc, amit konvertálni szeretnénk.
Visszatérési értéke:A függvény visszatérési értéke a megadott sztring egész számú alakja lesz.
Példa:Az alábbi példában kiíratjuk a \'2314\' sztringet, majd annak az átkonvertált alakját.
public OnFilterScriptInit( ) {
new szStr[ 12 ] = \"2314\",
iStr = strval( szStr );
print( szStr );
printf( \"%i\", iStr );
return 1;
}
Mivel az eredmény ugyanaz, megmutatnám azoknak, akinek nem esett le, hogy mire is jó ez. Az elõzõ példát módosítva láthatjuk.
public OnFilterScriptInit( ) {
new szStr[ 12 ] = \"2314\",
iStr = strval( szStr );
if( iStr == 2314 ) print( \"Annyi\" ); //Helyes
if( szStr == 2314 ) print( \"Annyi\" ); //Helytelen
return 1;
}
A valstr függvény:Funkciója:A valstr függvény segítségével egy számot konvertálhatunk karakterlánc alakba.
Paraméter( ek ):
dest[ ] = A karakterlánc, ahova konvertálni szeretnénk.
value = Az érték, amit konvertálni szeretnénk.
pack = Logikai értékû paraméter( Hamis[ false ], vagy igaz [ true ], azaz 0, vagy 1 ), ha az értéke igaz( 1 ), akkor \'csomagolja\' az értéket( hivatkozhatunk rá az ispacked, strunpack függvényekkel ).
Visszatérési értéke:A függvény visszatérési értéke a megadott szám karakterlánc alakja lesz.
Példa:Az alábbi példában a 2010 számot sztringgé alakítjuk.
public OnFilterScriptInit( ) {
new szDest[ 6 ];
valstr( szDest, 2010 );
return 1;
}
A leírást még bûvíteni fogom néhány függvénnyel!