[amx-netlinx-common] r42 committed - Made things a little clearer, although I think it could still be bette...

[amx-netli...@googlecode.com]

Revision: 42
Author: trueamx
Date: Wed Nov 10 09:15:45 2010
Log: Made things a little clearer, although I think it could still be
better. Any ideas for improving this and using it as a template for other
functions?
http://code.google.com/p/amx-netlinx-common/source/detail?r=42

Modified:
/wiki/explode_quoted.wiki

=======================================
--- /wiki/explode_quoted.wiki Wed Nov 10 08:28:39 2010
+++ /wiki/explode_quoted.wiki Wed Nov 10 09:15:45 2010
@@ -4,9 +4,11 @@

== Description ==

-|| integer *explode_quoted* (char *delim*, char *a{{{[]}}}*, char
*ret{{{[][]}}}*, integer *ret_len*, char *quote*) ||
-
-Explodes a string with a delimiter of type *char* (such as a space) into
an array of substrings, while honoring and not exploding data surrounded by
quotes.
+|| integer *explode_quoted* (char *delim*, char *a`[]`*, char *ret`[][]`*,
integer *ret_len*, char *quote*) ||
+
+Explodes a string with a char delimiter *delim* (such as a space or comma)
into an array of substrings, not including the delimiter, while not
exploding data surrounded by the char quoting character *quote* (usually a
literal quote character, such as *'* or *"* ).
+
+If *quote* is set to 0, the quoting functionality will be disabled.

Due to NetLinx bugs, you must specify the array count of *ret* in
*ret_len* if you want the returned array sanitized. Otherwise, any extra
data present in the array will not be cleared.