text_history.h

   1 /**
   2  * @file text_history.h
   3  * @author Shinichiro Nakamura
   4  * @brief NT-Shell用テキストヒストリモジュールの定義。
   5  * @details
   6  * 文字列の入力履歴を論理的に扱うためのモジュール。
   7  * このモジュールはビューに関して一切感知しない。
   8  */
   9
  10 /*
  11  * ===============================================================
  12  *  Natural Tiny Shell (NT-Shell)
  13  *  Version 0.0.7
  14  * ===============================================================
  15  * Copyright (c) 2010-2011 Shinichiro Nakamura
  16  *
  17  * Permission is hereby granted, free of charge, to any person
  18  * obtaining a copy of this software and associated documentation
  19  * files (the "Software"), to deal in the Software without
  20  * restriction, including without limitation the rights to use,
  21  * copy, modify, merge, publish, distribute, sublicense, and/or
  22  * sell copies of the Software, and to permit persons to whom the
  23  * Software is furnished to do so, subject to the following
  24  * conditions:
  25  *
  26  * The above copyright notice and this permission notice shall be
  27  * included in all copies or substantial portions of the Software.
  28  *
  29  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  30  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  31  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  32  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  33  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  34  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  35  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  36  * OTHER DEALINGS IN THE SOFTWARE.
  37  * ===============================================================
  38  */
  39
  40 #ifndef TEXT_HISTORY_H
  41 #define TEXT_HISTORY_H
  42
  43 #define TEXTHISTORY_MAXLEN 64   /**< テキストヒストリあたりの最大文字列長。 */
  44 #define TEXTHISTORY_DEPTH 8     /**< テキストヒストリのヒストリ数。 */
  45
  46 /**
  47  * @brief テキストヒストリ構造体。
  48  */
  49 typedef struct {
  50     char history[TEXTHISTORY_MAXLEN * TEXTHISTORY_DEPTH];
  51     int rp;
  52     int wp;
  53 } text_history_t;
  54
  55 void text_history_init(text_history_t *p);
  56 int text_history_write(text_history_t *p, char *buf);
  57 int text_history_read(text_history_t *p, char *buf, const int siz);
  58 int text_history_read_point_next(text_history_t *p);
  59 int text_history_read_point_prev(text_history_t *p);
  60 int text_history_find(text_history_t *p,
  61         const int index, const char *text,
  62         char *buf, const int siz);
  63
  64 #endif
  65