[test3]

Hello,
English is not my first language, that why it will have errors and I'll try to do my best.

I already know how code in php, a little bit in C, 2 years ago with the pascal and Visual Basic (but I still have some difficulties with functions), I started to learn the sourcepawn since some days.

I read that page: http://wiki.alliedmods.net/Introduct...ns#Declaration
And I don't really understand what does this code below:

public Action:Command_MySlap(client, args) { }

It's a function of course, but what is the text "Action:", I saw that was a tag, like the tags in HTML like "<a>" for a link ? My translation must be wrong...

The second question is about the parameters of this function: Is an obligation to name the first parameter "client" and the second "args" ?
I guess not, and I think we can do a function like:

public Action:Command_MySlap(arguments, client) { }

Adjust the parameter 'arguments' in the function.
And after the compilation, write in the console: sm_myslap [number of damages] [the name of the client].

It's the first time that I read a tutorial for programming in english and I feel to don't know what I'm doing :/

Good afternoon.

[Leonardo]

no, you can't
it's a defined function structure
that calls when called registered command
"Action:" because it's an action. it can be passes without changes, can be changed, or even prevented/blocked.
you can replace (client, args) with (args, client), but it make code harder to read, also you must keep in mind that first param is a client id and second - number of arguments.

[berni]

The order of parameters is very important, as the Pawn runtime is not aware of the names used, that's like in C too. And pawn is very similar to C.

There is no equivalent for Pawn Tags (enums) in HTML.
If Pawn would have classes, the HTML <a> Tag would be a classname in Pawn

The enum Action is defined like this in core.inc:

PHP Code:

/**
 * Specifies what to do after a hook completes.
 */
enum Action
{
    Plugin_Continue = 0,    /**< Continue with the original action */
    Plugin_Changed = 1,        /**< Inputs or outputs have been overridden with new values */
    Plugin_Handled = 3,        /**< Handle the action at the end (don't call it) */
    Plugin_Stop = 4,        /**< Immediately stop the hook chain and handle the original */
}; 


You see it's a kind of pseudo datatype, an enum.

An enum is a list of possible values. Only one of them can be used as return value in a function or when used with a variable.

ie.: return Plugin_Handled;

It's a good way to not having to deal with plain numbers, but named values.

[test3]

Thank you very much Leonardo and berni,

Maybe is a better idea to continue to learn the language C ? What is the differences with a high-level programming language (PHP as example), etc. Or is it not so hard that I believe ? If it's a better idea to know completly how work the language C, it's not necessary to respond to my questions below.

EDIT: Infact, I think it's a good idea to learn how code with the language C, that will be easier later to code with Sourcepawn. Do I need to edit the main title and put "[solved]" or something else ?

but I have some other problems, I'll explain how I see the code below. The function OnPluginStart() creates a consol command, the string that we need to write in the consol is "sm_myslap" and the user writes the name of the client and the damages (like: "sm_MySlap [name of the client] [damages]" ). When this command is invoked, the function "Command_MySlap" is used. The last parameter is an administrative flag, but I don't know what do this flag and what are the others (how to know all of them) ?. When the function Command_MySlap() is invoked, there is 2 arguments: "client" and "args". But where are they from ? An argument must be an input, so how it takes the client name and the damages ? Then I don't understand what is the utility to know how many arguments are in the function ? What is the purpose of this argument ? And finaly, the purpose of the exercice/example is to create a command where we can slap a player, so we write in the console "sm_MySlap [name of the client] [damages]", but where can we take those informations, put them in the function Command_MySlap() ? I think I didn't really understand what is a callback function and how it works. public OnPluginStart() { RegAdminCmd("sm_myslap", Command_MySlap, ADMFLAG_SLAY) } public Action:Command_MySlap(client, args) { [...]

[Leonardo]

why no just read wiki?

Originally Posted by test3 Do I need to edit the main title and put "[solved]" or something else ?

if you want.

[test3]

I already read it, but some points are complicated, I didn't understand all the things, understand a new informatic language in my first language is already complicate, but do it in english is really hard, that why I'll read how code with C. Thank you again for the help.

And apart form the main subject, How was my english ? A lot of errors, good, bad ? I hop that wasn't too bad.

Good night.

[berni]

Well, Sourcepawn is quite easier to learn in my opinion, because it doesn't have that many language constructs like C does.
I recommend reading the source code of other people's plugin, that really helps, but don't takeover everything, there are really bad coded plugins out there.

Originally Posted by test3 How was my english ? A lot of errors, good, bad ? I hop that wasn't too bad

Your English is better than the English of 80% of the people writing in this forum

[Leonardo]

most of functions' names are based on english words to clearly understand what they're means/doing.
so it'll be better to know english.

too bad it's not my native lahguage too :c

[test3]

Yeah, and I prefer to know how code with a tutorial of informatic language than search in a program with a lot of plugins, etc. (It's just my opinion :p)

Well, thank you for you two to had helped me.

[Sillium]

You can also read the Pawn documentation:
http://www.compuphase.com/pawn/pawn.htm#DOWNLOAD_DOCS