Writing Advanced Modules In C - Revision history

Cheese: wrote callback tutorial and interface tutorial

2015-07-06T00:07:06Z

wrote callback tutorial and interface tutorial

Show changes

Cheese: /* Passing Multiple Arguments To Commands */ cleaned up

2011-01-19T04:10:14Z

‎Passing Multiple Arguments To Commands: cleaned up

Cheese: added link

2011-01-09T20:25:31Z

added link

Cheese: minor details

2011-01-08T01:22:07Z

minor details

Cheese: now its easier for the newbies :D

2011-01-08T00:46:24Z

now its easier for the newbies :D

Cheese: fixed spacing, might replace strtok with strsplit later

2010-12-30T03:20:39Z

fixed spacing, might replace strtok with strsplit later

BaK: /* Passing Multiple Arguments To Commands */ fixed a bug, a memory leak, and made it cross platform

2010-12-29T21:33:36Z

‎Passing Multiple Arguments To Commands: fixed a bug, a memory leak, and made it cross platform

BaK: /* Passing Data To Timers */ let's not have memory leaks in sample code

2010-12-29T21:25:06Z

‎Passing Data To Timers: let's not have memory leaks in sample code

Cheese: minor details

2010-12-29T02:24:05Z

minor details

Cheese: forgot more stuff

2010-12-29T01:52:37Z

forgot more stuff

@@ Line 50: / Line 50: @@
 == Passing Multiple Arguments To Commands ==
-Since the words are read one by one, then checked against the whole list, they can be in any order!
+Since the words are read one by one against the whole list, they can be in any order!
 <pre>
-// define macros for comparing strings that work for both linux and windows
+// define macros for comparing strings that work on linux
-#ifdef WIN32
+#ifndef WIN32
 //a case insensitive comparison that returns 0 if both are the same
-#define istrcmp(x,y) (stricmp(x,y) == 0)
+#define stricmp(x,y) (strcasecmp(x,y) == 0)
 //a case insensitive comparison that returns 0 if both are the same for the first N letters
-#define istrcmpn(x,y,n) (strnicmp(x,y,n) == 0)
+#define strnicmp(x,y,n) (strncasecmp(x,y,n) == 0)
 #endif
@@ Line 78: / Line 73: @@
 		chat->SendMessage(p,"Word: %s",word); //the word currently being reviewed
-		if(istrcmpn(word,"a=",2)) //remember, the N means it is checking only first 2 letters
+		if(strnicmp(word,"a=",2)) //remember, the N means it is checking only first 2 letters
+		{
 			//do stuff if first 2 letters of word are 'a' then '='
@@ Line 85: / Line 80: @@
 			int check=atoi(word); //then read a number
+		}
-		else if(istrcmpn(word,"bc=",3)) //3 this time
+		else if(strnicmp(word,"bc=",3)) //3 this time
+		{
 			//do stuff if first 3 letters of word are 'b' then 'c' then '='
@@ Line 92: / Line 87: @@
 			int check=atoi(word); //then read a number
+		}
-		else if(istrcmp(word,"-de")) //no N, it just checks the whole thing
+		else if(stricmp(word,"-de")) //no N, it just checks the whole thing
+		{
 			//do stuff if word is "-de"

← Older revision		Revision as of 20:25, 9 January 2011
Line 9:		Line 9:

	http://www.cplusplus.com/reference/		http://www.cplusplus.com/reference/
		+
		+	http://www.cprogramming.com/tutorial.html

@@ Line 68: / Line 68: @@
 	chat->SendMessage(p,"Sentence: %s",params);
-	char word[255]; //where strsplit will store each word
+	char buf[255];
-	const char *tmp=NULL; //pointer that strsplit needs to work
+	char *word=NULL;
-	while(strsplit(params," ,:",word,sizeof(word),&tmp)) //for each word, seperated by ' ' or ',' or ':'
+	const char *tmp=NULL;
+	{
 		chat->SendMessage(p,"Word: %s",word); //the word currently being reviewed

@@ Line 53: / Line 53: @@
 // define macros for comparing strings that work for both linux and windows
 #ifdef WIN32
-	#define STRCASECMP stricmp
+//a case insensitive comparison that returns 0 if both are the same
-	#define STRNCASECMP strnicmp
+#define istrcmp(x,y) (stricmp(x,y) == 0)
 #else
-	#define STRCASECMP strcasecmp
+//a case insensitive comparison that returns 0 if both are the same
-	#define STRNCASECMP strncasecmp
+#define istrcmp(x,y) (strcasecmp(x,y) == 0)
 #endif
 local void examplecommand(const char *command, const char *params, Player *p, const Target *t)
+{
-	char *sentence=strdup(params); //strdup clones a string because strtok replaces " " with a \0
+	chat->SendMessage(p,"Sentence: %s",params);
-	while(word) //while word != null
+	char word[255]; //where strsplit will store each word
+	{
-		if(!STRNCASECMP(word,"a=",2)) //STRNCASECMP is a case insensitive comparison that returns 0 if the same, with a number
+		chat->SendMessage(p,"Word: %s",word); //the word currently being reviewed
+		{
 			//do stuff if first 2 letters of word are 'a' then '='
@@ Line 74: / Line 81: @@
 			int check=atoi(word); //then read a number
+		}
-		else if(!STRNCASECMP(word,"bc=",3))
+		else if(istrcmpn(word,"bc=",3)) //3 this time
+		{
 			//do stuff if first 3 letters of word are 'b' then 'c' then '='
@@ Line 81: / Line 88: @@
 			int check=atoi(word); //then read a number
+		}
-		else if(!STRCASECMP(word,"-de")) //thats STRCASECMP with no N, it checks the whole thing
+		else if(istrcmp(word,"-de")) //no N, it just checks the whole thing
+		{
 			//do stuff if word is "-de"
+		}
+	}
+}
 </pre>

@@ Line 29: / Line 29: @@
+	}
-	//return 1 if you want timer to run again, or 0 if you want it to be removed
+	int returnValue=0; //return 1 if you want timer to run again, or 0 if you want it to be removed
-	int returnValue = 0;
+	if(!returnValue) afree(tid); //if zero, free the data we have previously allocated
 	return returnValue;
+}
@@ Line 85: / Line 81: @@
 			int check=atoi(word); //then read a number
+		}
-		else if(!STRCASECMP(word,"-de")) //thats STRCASECMPwith no N, it checks the whole thing
+		else if(!STRCASECMP(word,"-de")) //thats STRCASECMP with no N, it checks the whole thing
+		{
 			//do stuff if word is "-de"
@@ Line 92: / Line 88: @@
+	}
-	afree(sentence); // since we allocated a string with strdup, we must free the associated memory manually
+	afree(sentence); //since we allocated a string with strdup, we must free the associated memory manually
+}
 </pre>

@@ Line 29: / Line 29: @@
+	}
-	return 0; //return 1 if you want timer to run again, or 0 if you want it to be removed
+	//return 1 if you want timer to run again, or 0 if you want it to be removed
+}
@@ Line 38: / Line 39: @@
 	tid->number=10
-	ml->SetTimer(timerfunc,1000,100,tid,0); //now set timer to activate in 1000 centiseconds, then repeat every 100. we are also sending the address of tid
+	//now set timer to activate in 1000 centiseconds, then repeat every 100.
+}
 </pre>
@@ Line 51: / Line 54: @@
+{
 	char *sentence=strdup(params); //strdup clones a string because strtok replaces " " with a \0
-	char *word=strtok(params," "); //strtok reads everything until next \0 into word
+	char *word=strtok(params," "); //strtok reads everything until first \0 into word
 	while(word) //while word != null

@@ Line 51: / Line 51: @@
+{
 	char *sentence=strdup(params); //strdup clones a string because strtok replaces " " with a \0
-	char* word=strtok(params," "); //strtok reads everything until next \0 into word
+	char *word=strtok(params," "); //strtok reads everything until next \0 into word
 	while(word) //while word != null
+	{
-		if(!strnicmp(word,"a=",2))
+		if(!strnicmp(word,"a=",2)) //strnicmp is a case insensitive comparison that returns 0 if the same, with a number
+		{
 			//do stuff if first 2 letters of word are 'a' then '='
@@ Line 69: / Line 69: @@
 			int check=atoi(word); //then read a number
+		}
-		else if(!stricmp(word,"-de"))
+		else if(!stricmp(word,"-de")) //thats stricmp with no N, it checks the whole thing
+		{
 			//do stuff if word is "-de"