Update GetPlayers.md

docs/scripting/functions/GetPlayers.md

@@ -15,13 +15,21 @@ Gets an array variable of the IDs of the current players on the server.
 | players[]     | An array into which to store the player IDs, passed by reference. |
 | size          | The size of the array.                                            |
 
+## Returns
+
+The function returns the number of players stored in the array.
+
 ## Examples
 
+Suppose there are 5 players on the server:
+
 ```c
 new players[MAX_PLAYERS];
+new length;
 
-GetPlayers(players, sizeof(players));
-// The `players` array now contains online player IDs. { 0, 1, 2, 3, 4, ... }
+length = GetPlayers(players, sizeof(players));
+// The `players` array now contains online player IDs. { 0, 1, 2, 3, 4 }
+// The value of the `length` variable is 5
 ```
 
 ## Related Functions