argparse

Синтаксис

									native argparse(const text[], pos, argbuffer[], maxlen);
								

String to tokenize.

Position to start parsing from.

Buffer to store first argument.

Size of the buffer.

Описание

Parses an argument string to find the first argument. You can use this to replace strbreak().

Пометка

Only available in 1.8.3 and above.

Пометка

You can use argparse() to break a string into all of its arguments:
new arg[N], pos;
while (true) {
  pos = argparse(string, pos, arg, sizeof(arg) - 1);
  if (pos == -1)
    break;
}

Пометка

All initial whitespace is removed. Remaining characters are read until an
argument separator is encountered. A separator is any whitespace not inside
a double-quotation pair (i.e. "x b" is one argument). If only one quotation
mark appears, argparse() acts as if one existed at the end of the string.
Quotation marks are never written back, and do not act as separators. For
example, "a""b""c" will return "abc". An empty quote pair ("") will count
as an argument containing no characters.

Пометка

argparse() will write an empty string to argbuffer if no argument is found.

Возвращает

If no argument was found, -1 is returned. Otherwise, the index to the next position to parse from is returned. This might be the very end of the string.