[Gorgeousmaniac]

Yeah, so basically, my downloaded gm script has lots of stock in it, and I cant edit it without knowing what it is.
Sorry, but my shrunken brain doesn't completely understand the definition of stock in the SA-MP wiki. So can anyone please explain it to me in a simple/short way?

[MrViolence101]

stock is a method. completes code that you have inside the stock. Place the name of the stock in a certain place in your code. It then does the code you have in the stock.

*Sorry, my english is bad :P

[SickAttack]

Stock is a keyword that tells the compiler to skip or leave out whatever has the keyword included to it (as if it never existed in the source code), that's if it isn't being used anywhere.

Using stock while creating a function doesn't make it a "stock", it's still a function. Though, you can also call it a "stock function".

[Gorgeousmaniac]

Quote:

Originally Posted by SickAttack Stock is a keyword that tells the compiler to skip or leave out whatever has the keyword included to it (as if it never existed in the source code), that's if it isn't being used anywhere. Using stock while creating a function doesn't make it a "stock", it's still a function. Though, you can also call it a "stock function".

Can you give me an example on what is it used for?

[FreAkeD]

https://sampwiki.blast.hk/wiki/Function
https://sampforum.blast.hk/showthread.php?tid=341545

[Gorgeousmaniac]

Quote:

Originally Posted by FreAkeD https://sampwiki.blast.hk/wiki/Function https://sampforum.blast.hk/showthread.php?tid=341545

FreAkeD, As I said, I'm having a hard time understanding the definition of stock in the samp wiki. However, the second link is what I'm looking for, Thank you!

[SickAttack]

Quote:

Originally Posted by Gorgeousmaniac Can you give me an example on what is it used for?

I'm not quite sure why the explanation wasn't enough, but...

Let's say we have this function:

pawn Code:

stock Function(a)
{
    if(a)
    {
        return 1;
    }
    return 0;
}

If I use the function in OnPlayerConnect:

pawn Code:

Function(0);

The function will be added to the .amx file.

If the function isn't used and has stock, it won't be added to the .amx file and it won't give you a warning. It will only exist in the source code (.pwn).

If the function is like below (without stock) and isn't used, instead:

pawn Code:

Function(a)
{
    if(a)
    {
        return 1;
    }
    return 0;
}

You'll get a warning.

If it is used, you won't get a warning.

- Stock makes things that use it lack from the compiled source.

[Gorgeousmaniac]

Quote:

Originally Posted by SickAttack I'm not quite sure why the explanation wasn't enough, but... Let's say we have this function: pawn Code: stock Function(a) {     if(a)     {         return 1;     }     return 0; } If I use the function in OnPlayerConnect: pawn Code: Function(0); The function will be added to the .amx file. If the function isn't used and has stock, it won't be added to the .amx file and it won't give you a warning. It will only exist in the source code (.pwn). If the function is like below (without stock) and isn't used, instead: pawn Code: Function(a) {     if(a)     {         return 1;     }     return 0; } You'll get a warning. If it is used, you won't get a warning. - Stock makes things that use it lack from the compiled source.

I get it now! Thank you SickAttack!

[Hiddos]

That doesn't provide an example on what it's used for (and when you need it). This is a better link.

You should only use the stock keyword when you're writing an include for other people to use, in which they can use your functions but aren't required to.

[SickAttack]

Quote:

Originally Posted by Hiddos That doesn't provide an example on what it's used for (and when you need it). This is a better link. You should only use the stock keyword when you're writing an include for other people to use, in which they can use your functions but aren't required to.

Negative. It's completely fine to use it while creating functions => stock functions.

It also has other uses than just that one.

[Yashas]

Honestly, the stop the abuse of stock topic is not worthy. It doesn't matter if you keep a function/variable as a stock or not.

The advantage of not using stock is that the compiler warns you if you forget to call the function whereas with stock, the compiler ignores that function (removes it from the code and doesn't even tell you).

[Threshold]

Why put something in a script if you're never going to use it? Stocks should really only belong in includes.

[SickAttack]

Quote:

Originally Posted by Threshold Why put something in a script if you're never going to use it? Stocks should really only belong in includes.

If it doesn't hurt, then let it be.

I just use it for accessibility, I don't tend to leave functions (which will lack from the source code when compiled) in a script that won't be used. I don't want to switch to using a define as using stock is more convenient.

[Threshold]

Sure, but it just goes along the same principles as using #pragma tabsize 0 to remove loose indentation warnings.

Using stock where unnecessary just promotes laziness, in my opinion.