AN3259

Software description

Doc ID 17835 Rev 1

13/25

4.3.3

GetInputString function

The GetInputString function is used to receive and store the character strings sent through

the terminal window. This function relies on the Get_key function to acquire and decode

each character (see Section 4.3.4). Different actions can be performed according to the

value of the character ASCII code:

●

If ASCII code = ‘\b’

A backspace has been sent by the terminal. The last character of the string is erased if

the string is not empty.

●

If ASCII code belongs to {0...1 or a...Z}

The character is stored.

●

If ASCII code = ‘\r’

The GetInputString function stores the “end of string” value, '\0', at the end of the string.

The maximum number of ASCII codes stored in the buffP[bytes_read] buffer has been

reached

The software erases the recorded string and waits for another input from the terminal.

For more information on ASCII codes refer to Appendix A: Standard ASCII character codes.