| 1 | /*
|
|---|
| 2 | * Copyright (c) 2010 Jiri Svoboda
|
|---|
| 3 | * All rights reserved.
|
|---|
| 4 | *
|
|---|
| 5 | * Redistribution and use in source and binary forms, with or without
|
|---|
| 6 | * modification, are permitted provided that the following conditions
|
|---|
| 7 | * are met:
|
|---|
| 8 | *
|
|---|
| 9 | * - Redistributions of source code must retain the above copyright
|
|---|
| 10 | * notice, this list of conditions and the following disclaimer.
|
|---|
| 11 | * - Redistributions in binary form must reproduce the above copyright
|
|---|
| 12 | * notice, this list of conditions and the following disclaimer in the
|
|---|
| 13 | * documentation and/or other materials provided with the distribution.
|
|---|
| 14 | * - The name of the author may not be used to endorse or promote products
|
|---|
| 15 | * derived from this software without specific prior written permission.
|
|---|
| 16 | *
|
|---|
| 17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|---|
| 18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|---|
| 19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|---|
| 20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|---|
| 21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|---|
| 22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|---|
| 23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|---|
| 24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|---|
| 25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|---|
| 26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|---|
| 27 | */
|
|---|
| 28 |
|
|---|
| 29 | /** @addtogroup libclui
|
|---|
| 30 | * @{
|
|---|
| 31 | */
|
|---|
| 32 | /**
|
|---|
| 33 | * @file
|
|---|
| 34 | */
|
|---|
| 35 |
|
|---|
| 36 | #ifndef LIBCLUI_TINPUT_H_
|
|---|
| 37 | #define LIBCLUI_TINPUT_H_
|
|---|
| 38 |
|
|---|
| 39 | #define HISTORY_LEN 10
|
|---|
| 40 | #define INPUT_MAX_SIZE 1024
|
|---|
| 41 |
|
|---|
| 42 | /** Text input field (command line).
|
|---|
| 43 | *
|
|---|
| 44 | * Applications should treat this structure as opaque.
|
|---|
| 45 | */
|
|---|
| 46 | typedef struct {
|
|---|
| 47 | /** Buffer holding text currently being edited */
|
|---|
| 48 | wchar_t buffer[INPUT_MAX_SIZE + 1];
|
|---|
| 49 |
|
|---|
| 50 | /** Screen coordinates of the top-left corner of the text field */
|
|---|
| 51 | sysarg_t col0;
|
|---|
| 52 | sysarg_t row0;
|
|---|
| 53 |
|
|---|
| 54 | /** Screen dimensions */
|
|---|
| 55 | sysarg_t con_cols;
|
|---|
| 56 | sysarg_t con_rows;
|
|---|
| 57 |
|
|---|
| 58 | /** Number of characters in @c buffer */
|
|---|
| 59 | size_t nc;
|
|---|
| 60 |
|
|---|
| 61 | /** Caret position within buffer */
|
|---|
| 62 | size_t pos;
|
|---|
| 63 |
|
|---|
| 64 | /** Selection mark position within buffer */
|
|---|
| 65 | size_t sel_start;
|
|---|
| 66 |
|
|---|
| 67 | /** History (dynamically allocated strings) */
|
|---|
| 68 | char *history[HISTORY_LEN + 1];
|
|---|
| 69 |
|
|---|
| 70 | /** Number of entries in @c history, not counting [0] */
|
|---|
| 71 | size_t hnum;
|
|---|
| 72 |
|
|---|
| 73 | /** Current position in history */
|
|---|
| 74 | size_t hpos;
|
|---|
| 75 |
|
|---|
| 76 | /** @c true if finished with this line (return to caller) */
|
|---|
| 77 | bool done;
|
|---|
| 78 |
|
|---|
| 79 | /** @c true if user requested to abort interactive loop */
|
|---|
| 80 | bool exit_clui;
|
|---|
| 81 | } tinput_t;
|
|---|
| 82 |
|
|---|
| 83 | extern tinput_t *tinput_new(void);
|
|---|
| 84 | extern void tinput_destroy(tinput_t *);
|
|---|
| 85 | extern int tinput_read(tinput_t *, char **);
|
|---|
| 86 |
|
|---|
| 87 | #endif
|
|---|
| 88 |
|
|---|
| 89 | /** @}
|
|---|
| 90 | */
|
|---|
