Documentation error:

[awneil]

@ADL User Guide for Open AT® OS v6.21

ascii * wm_strGetParameterString( ascii * dst, const ascii * src, u16 Position );
If src is a string formatted as an AT response (for example “+RESP: 1,2,3”) or as an AT command (for example “AT+CMD=1,2,3”), the function copies the parameter at Position offset (starting from 1) if it is present in the dst i[/i] buffer, and returns a pointer on dst.

Surely, that should say, “if it is present in the src buffer”

Reference: WM_DEV_OAT_UGD_080
Revision: 007
Date: February 2009

[chiduprakash]

Also it is same in Basic Development Guide for Open AT OS v3.13.

Looks like it is just copy pasted from older version without verify during documentation.

Also please look wm_strSwitch() functionality.

[awneil]

@chiduprakash

Looks like it is just copy pasted from older version without verify during documentation.

Yes, I think so!

The documentation also does not say what happens to the dst string when the specified parameter is not present in the src string:

What actually happens is that the dst string is set to the empty string;
ie, dst[0] = 0.

[awneil]

@chiduprakash

Also please look wm_strSwitch() functionality.

See: viewtopic.php?f=3&t=4234&p=16935&hilit=wm_strSwitch#p16811

[awneil]

The definition of when a parameter is “present” is also not clearly explained:

+RESP: P1,P2,P3

Clearly contains 3 parameters, so parameters 1-3 are “present”, parameters 4+ are “not present”.

But what about:

+RESP: P1,P3

In fact, again, this is considered to contain three parameters:

• Parameter number 1 is present, and has the value “P1”;

• Parameter number 2 is present, and has a null value;

• Parameter number 3 is present, and has the value “P3”;

• Parameters numbered 4 & above are not present.