RealView® Debugger Command Line Reference GuideVersion 3.0
Home > RealView Debugger Predefined Macros > Alphabetical predefined macro reference > prompt_list

3.2.16. prompt_list

Displays a dialog containing message text, a list of choices, and Ok, Cancel and Help buttons.

Note

This macro is not available in the headless debugger.

Syntax


int prompt_list (message, buff)
char *message;
char *buff;

where:

message

The message text that appears at the top of the dialog.

buff

Initially, the list of choices that appear for selection in the dialog, separated by \n.

Description

This macro displays a dialog containing message text and a list of choices.

Return value

int

One of the following:

0

Cancel

n

Index number of the chosen list item. The first item in the list has an index of 1.

Rules

None

Example

This example shows how to use prompt_list on the command line:

add char buff[15]
strcpy(buff, "one\ntwo\nthree")
ce prompt_list("Choose one:", buff)Result is: 3 0x03

See Also

The following macros provide similar or related functionality:

Copyright © 2002-2006 ARM Limited. All rights reserved.ARM DUI 0175H
Non-Confidential
PDF file icon  PDF version
Home > RealView Debugger Predefined Macros > Alphabetical predefined macro reference > prompt_list