Fossil

Hex Artifact Content
Login

Artifact 7c5879e56e29c0d61801a28dc7a6fbe21c63c9e20d8f842c56e767bdf24c32ee:


0000: 2f 2a 20 6c 69 6e 65 6e 6f 69 73 65 2e 68 20 2d  /* linenoise.h -
0010: 2d 20 56 45 52 53 49 4f 4e 20 31 2e 30 0a 20 2a  - VERSION 1.0. *
0020: 0a 20 2a 20 47 75 65 72 72 69 6c 6c 61 20 6c 69  . * Guerrilla li
0030: 6e 65 20 65 64 69 74 69 6e 67 20 6c 69 62 72 61  ne editing libra
0040: 72 79 20 61 67 61 69 6e 73 74 20 74 68 65 20 69  ry against the i
0050: 64 65 61 20 74 68 61 74 20 61 20 6c 69 6e 65 20  dea that a line 
0060: 65 64 69 74 69 6e 67 20 6c 69 62 0a 20 2a 20 6e  editing lib. * n
0070: 65 65 64 73 20 74 6f 20 62 65 20 32 30 2c 30 30  eeds to be 20,00
0080: 30 20 6c 69 6e 65 73 20 6f 66 20 43 20 63 6f 64  0 lines of C cod
0090: 65 2e 0a 20 2a 0a 20 2a 20 53 65 65 20 6c 69 6e  e.. *. * See lin
00a0: 65 6e 6f 69 73 65 2e 63 20 66 6f 72 20 6d 6f 72  enoise.c for mor
00b0: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 20  e information.. 
00c0: 2a 0a 20 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  *. * -----------
00d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
00e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
00f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 2a  -------------. *
0110: 0a 20 2a 20 43 6f 70 79 72 69 67 68 74 20 28 63  . * Copyright (c
0120: 29 20 32 30 31 30 2d 32 30 31 34 2c 20 53 61 6c  ) 2010-2014, Sal
0130: 76 61 74 6f 72 65 20 53 61 6e 66 69 6c 69 70 70  vatore Sanfilipp
0140: 6f 20 3c 61 6e 74 69 72 65 7a 20 61 74 20 67 6d  o <antirez at gm
0150: 61 69 6c 20 64 6f 74 20 63 6f 6d 3e 0a 20 2a 20  ail dot com>. * 
0160: 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 32 30  Copyright (c) 20
0170: 31 30 2d 32 30 31 33 2c 20 50 69 65 74 65 72 20  10-2013, Pieter 
0180: 4e 6f 6f 72 64 68 75 69 73 20 3c 70 63 6e 6f 6f  Noordhuis <pcnoo
0190: 72 64 68 75 69 73 20 61 74 20 67 6d 61 69 6c 20  rdhuis at gmail 
01a0: 64 6f 74 20 63 6f 6d 3e 0a 20 2a 0a 20 2a 20 41  dot com>. *. * A
01b0: 6c 6c 20 72 69 67 68 74 73 20 72 65 73 65 72 76  ll rights reserv
01c0: 65 64 2e 0a 20 2a 0a 20 2a 20 52 65 64 69 73 74  ed.. *. * Redist
01d0: 72 69 62 75 74 69 6f 6e 20 61 6e 64 20 75 73 65  ribution and use
01e0: 20 69 6e 20 73 6f 75 72 63 65 20 61 6e 64 20 62   in source and b
01f0: 69 6e 61 72 79 20 66 6f 72 6d 73 2c 20 77 69 74  inary forms, wit
0200: 68 20 6f 72 20 77 69 74 68 6f 75 74 0a 20 2a 20  h or without. * 
0210: 6d 6f 64 69 66 69 63 61 74 69 6f 6e 2c 20 61 72  modification, ar
0220: 65 20 70 65 72 6d 69 74 74 65 64 20 70 72 6f 76  e permitted prov
0230: 69 64 65 64 20 74 68 61 74 20 74 68 65 20 66 6f  ided that the fo
0240: 6c 6c 6f 77 69 6e 67 20 63 6f 6e 64 69 74 69 6f  llowing conditio
0250: 6e 73 20 61 72 65 0a 20 2a 20 6d 65 74 3a 0a 20  ns are. * met:. 
0260: 2a 0a 20 2a 20 20 2a 20 20 52 65 64 69 73 74 72  *. *  *  Redistr
0270: 69 62 75 74 69 6f 6e 73 20 6f 66 20 73 6f 75 72  ibutions of sour
0280: 63 65 20 63 6f 64 65 20 6d 75 73 74 20 72 65 74  ce code must ret
0290: 61 69 6e 20 74 68 65 20 61 62 6f 76 65 20 63 6f  ain the above co
02a0: 70 79 72 69 67 68 74 0a 20 2a 20 20 20 20 20 6e  pyright. *     n
02b0: 6f 74 69 63 65 2c 20 74 68 69 73 20 6c 69 73 74  otice, this list
02c0: 20 6f 66 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61   of conditions a
02d0: 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  nd the following
02e0: 20 64 69 73 63 6c 61 69 6d 65 72 2e 0a 20 2a 0a   disclaimer.. *.
02f0: 20 2a 20 20 2a 20 20 52 65 64 69 73 74 72 69 62   *  *  Redistrib
0300: 75 74 69 6f 6e 73 20 69 6e 20 62 69 6e 61 72 79  utions in binary
0310: 20 66 6f 72 6d 20 6d 75 73 74 20 72 65 70 72 6f   form must repro
0320: 64 75 63 65 20 74 68 65 20 61 62 6f 76 65 20 63  duce the above c
0330: 6f 70 79 72 69 67 68 74 0a 20 2a 20 20 20 20 20  opyright. *     
0340: 6e 6f 74 69 63 65 2c 20 74 68 69 73 20 6c 69 73  notice, this lis
0350: 74 20 6f 66 20 63 6f 6e 64 69 74 69 6f 6e 73 20  t of conditions 
0360: 61 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  and the followin
0370: 67 20 64 69 73 63 6c 61 69 6d 65 72 20 69 6e 20  g disclaimer in 
0380: 74 68 65 0a 20 2a 20 20 20 20 20 64 6f 63 75 6d  the. *     docum
0390: 65 6e 74 61 74 69 6f 6e 20 61 6e 64 2f 6f 72 20  entation and/or 
03a0: 6f 74 68 65 72 20 6d 61 74 65 72 69 61 6c 73 20  other materials 
03b0: 70 72 6f 76 69 64 65 64 20 77 69 74 68 20 74 68  provided with th
03c0: 65 20 64 69 73 74 72 69 62 75 74 69 6f 6e 2e 0a  e distribution..
03d0: 20 2a 0a 20 2a 20 54 48 49 53 20 53 4f 46 54 57   *. * THIS SOFTW
03e0: 41 52 45 20 49 53 20 50 52 4f 56 49 44 45 44 20  ARE IS PROVIDED 
03f0: 42 59 20 54 48 45 20 43 4f 50 59 52 49 47 48 54  BY THE COPYRIGHT
0400: 20 48 4f 4c 44 45 52 53 20 41 4e 44 20 43 4f 4e   HOLDERS AND CON
0410: 54 52 49 42 55 54 4f 52 53 0a 20 2a 20 22 41 53  TRIBUTORS. * "AS
0420: 20 49 53 22 20 41 4e 44 20 41 4e 59 20 45 58 50   IS" AND ANY EXP
0430: 52 45 53 53 20 4f 52 20 49 4d 50 4c 49 45 44 20  RESS OR IMPLIED 
0440: 57 41 52 52 41 4e 54 49 45 53 2c 20 49 4e 43 4c  WARRANTIES, INCL
0450: 55 44 49 4e 47 2c 20 42 55 54 20 4e 4f 54 0a 20  UDING, BUT NOT. 
0460: 2a 20 4c 49 4d 49 54 45 44 20 54 4f 2c 20 54 48  * LIMITED TO, TH
0470: 45 20 49 4d 50 4c 49 45 44 20 57 41 52 52 41 4e  E IMPLIED WARRAN
0480: 54 49 45 53 20 4f 46 20 4d 45 52 43 48 41 4e 54  TIES OF MERCHANT
0490: 41 42 49 4c 49 54 59 20 41 4e 44 20 46 49 54 4e  ABILITY AND FITN
04a0: 45 53 53 20 46 4f 52 0a 20 2a 20 41 20 50 41 52  ESS FOR. * A PAR
04b0: 54 49 43 55 4c 41 52 20 50 55 52 50 4f 53 45 20  TICULAR PURPOSE 
04c0: 41 52 45 20 44 49 53 43 4c 41 49 4d 45 44 2e 20  ARE DISCLAIMED. 
04d0: 49 4e 20 4e 4f 20 45 56 45 4e 54 20 53 48 41 4c  IN NO EVENT SHAL
04e0: 4c 20 54 48 45 20 43 4f 50 59 52 49 47 48 54 0a  L THE COPYRIGHT.
04f0: 20 2a 20 48 4f 4c 44 45 52 20 4f 52 20 43 4f 4e   * HOLDER OR CON
0500: 54 52 49 42 55 54 4f 52 53 20 42 45 20 4c 49 41  TRIBUTORS BE LIA
0510: 42 4c 45 20 46 4f 52 20 41 4e 59 20 44 49 52 45  BLE FOR ANY DIRE
0520: 43 54 2c 20 49 4e 44 49 52 45 43 54 2c 20 49 4e  CT, INDIRECT, IN
0530: 43 49 44 45 4e 54 41 4c 2c 0a 20 2a 20 53 50 45  CIDENTAL,. * SPE
0540: 43 49 41 4c 2c 20 45 58 45 4d 50 4c 41 52 59 2c  CIAL, EXEMPLARY,
0550: 20 4f 52 20 43 4f 4e 53 45 51 55 45 4e 54 49 41   OR CONSEQUENTIA
0560: 4c 20 44 41 4d 41 47 45 53 20 28 49 4e 43 4c 55  L DAMAGES (INCLU
0570: 44 49 4e 47 2c 20 42 55 54 20 4e 4f 54 0a 20 2a  DING, BUT NOT. *
0580: 20 4c 49 4d 49 54 45 44 20 54 4f 2c 20 50 52 4f   LIMITED TO, PRO
0590: 43 55 52 45 4d 45 4e 54 20 4f 46 20 53 55 42 53  CUREMENT OF SUBS
05a0: 54 49 54 55 54 45 20 47 4f 4f 44 53 20 4f 52 20  TITUTE GOODS OR 
05b0: 53 45 52 56 49 43 45 53 3b 20 4c 4f 53 53 20 4f  SERVICES; LOSS O
05c0: 46 20 55 53 45 2c 0a 20 2a 20 44 41 54 41 2c 20  F USE,. * DATA, 
05d0: 4f 52 20 50 52 4f 46 49 54 53 3b 20 4f 52 20 42  OR PROFITS; OR B
05e0: 55 53 49 4e 45 53 53 20 49 4e 54 45 52 52 55 50  USINESS INTERRUP
05f0: 54 49 4f 4e 29 20 48 4f 57 45 56 45 52 20 43 41  TION) HOWEVER CA
0600: 55 53 45 44 20 41 4e 44 20 4f 4e 20 41 4e 59 0a  USED AND ON ANY.
0610: 20 2a 20 54 48 45 4f 52 59 20 4f 46 20 4c 49 41   * THEORY OF LIA
0620: 42 49 4c 49 54 59 2c 20 57 48 45 54 48 45 52 20  BILITY, WHETHER 
0630: 49 4e 20 43 4f 4e 54 52 41 43 54 2c 20 53 54 52  IN CONTRACT, STR
0640: 49 43 54 20 4c 49 41 42 49 4c 49 54 59 2c 20 4f  ICT LIABILITY, O
0650: 52 20 54 4f 52 54 0a 20 2a 20 28 49 4e 43 4c 55  R TORT. * (INCLU
0660: 44 49 4e 47 20 4e 45 47 4c 49 47 45 4e 43 45 20  DING NEGLIGENCE 
0670: 4f 52 20 4f 54 48 45 52 57 49 53 45 29 20 41 52  OR OTHERWISE) AR
0680: 49 53 49 4e 47 20 49 4e 20 41 4e 59 20 57 41 59  ISING IN ANY WAY
0690: 20 4f 55 54 20 4f 46 20 54 48 45 20 55 53 45 0a   OUT OF THE USE.
06a0: 20 2a 20 4f 46 20 54 48 49 53 20 53 4f 46 54 57   * OF THIS SOFTW
06b0: 41 52 45 2c 20 45 56 45 4e 20 49 46 20 41 44 56  ARE, EVEN IF ADV
06c0: 49 53 45 44 20 4f 46 20 54 48 45 20 50 4f 53 53  ISED OF THE POSS
06d0: 49 42 49 4c 49 54 59 20 4f 46 20 53 55 43 48 20  IBILITY OF SUCH 
06e0: 44 41 4d 41 47 45 2e 0a 20 2a 2f 0a 0a 23 69 66  DAMAGE.. */..#if
06f0: 6e 64 65 66 20 5f 5f 4c 49 4e 45 4e 4f 49 53 45  ndef __LINENOISE
0700: 5f 48 0a 23 64 65 66 69 6e 65 20 5f 5f 4c 49 4e  _H.#define __LIN
0710: 45 4e 4f 49 53 45 5f 48 0a 0a 23 69 66 64 65 66  ENOISE_H..#ifdef
0720: 20 5f 5f 63 70 6c 75 73 70 6c 75 73 0a 65 78 74   __cplusplus.ext
0730: 65 72 6e 20 22 43 22 20 7b 0a 23 65 6e 64 69 66  ern "C" {.#endif
0740: 0a 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ..typedef struct
0750: 20 6c 69 6e 65 6e 6f 69 73 65 43 6f 6d 70 6c 65   linenoiseComple
0760: 74 69 6f 6e 73 20 7b 0a 20 20 73 69 7a 65 5f 74  tions {.  size_t
0770: 20 6c 65 6e 3b 0a 20 20 63 68 61 72 20 2a 2a 63   len;.  char **c
0780: 76 65 63 3b 0a 7d 20 6c 69 6e 65 6e 6f 69 73 65  vec;.} linenoise
0790: 43 6f 6d 70 6c 65 74 69 6f 6e 73 3b 0a 0a 74 79  Completions;..ty
07a0: 70 65 64 65 66 20 76 6f 69 64 28 6c 69 6e 65 6e  pedef void(linen
07b0: 6f 69 73 65 43 6f 6d 70 6c 65 74 69 6f 6e 43 61  oiseCompletionCa
07c0: 6c 6c 62 61 63 6b 29 28 63 6f 6e 73 74 20 63 68  llback)(const ch
07d0: 61 72 20 2a 2c 20 6c 69 6e 65 6e 6f 69 73 65 43  ar *, linenoiseC
07e0: 6f 6d 70 6c 65 74 69 6f 6e 73 20 2a 29 3b 0a 74  ompletions *);.t
07f0: 79 70 65 64 65 66 20 63 68 61 72 2a 28 6c 69 6e  ypedef char*(lin
0800: 65 6e 6f 69 73 65 48 69 6e 74 73 43 61 6c 6c 62  enoiseHintsCallb
0810: 61 63 6b 29 28 63 6f 6e 73 74 20 63 68 61 72 20  ack)(const char 
0820: 2a 2c 20 69 6e 74 20 2a 63 6f 6c 6f 72 2c 20 69  *, int *color, i
0830: 6e 74 20 2a 62 6f 6c 64 29 3b 0a 74 79 70 65 64  nt *bold);.typed
0840: 65 66 20 76 6f 69 64 28 6c 69 6e 65 6e 6f 69 73  ef void(linenois
0850: 65 46 72 65 65 48 69 6e 74 73 43 61 6c 6c 62 61  eFreeHintsCallba
0860: 63 6b 29 28 76 6f 69 64 20 2a 29 3b 0a 76 6f 69  ck)(void *);.voi
0870: 64 20 6c 69 6e 65 6e 6f 69 73 65 53 65 74 43 6f  d linenoiseSetCo
0880: 6d 70 6c 65 74 69 6f 6e 43 61 6c 6c 62 61 63 6b  mpletionCallback
0890: 28 6c 69 6e 65 6e 6f 69 73 65 43 6f 6d 70 6c 65  (linenoiseComple
08a0: 74 69 6f 6e 43 61 6c 6c 62 61 63 6b 20 2a 29 3b  tionCallback *);
08b0: 0a 76 6f 69 64 20 6c 69 6e 65 6e 6f 69 73 65 53  .void linenoiseS
08c0: 65 74 48 69 6e 74 73 43 61 6c 6c 62 61 63 6b 28  etHintsCallback(
08d0: 6c 69 6e 65 6e 6f 69 73 65 48 69 6e 74 73 43 61  linenoiseHintsCa
08e0: 6c 6c 62 61 63 6b 20 2a 29 3b 0a 76 6f 69 64 20  llback *);.void 
08f0: 6c 69 6e 65 6e 6f 69 73 65 53 65 74 46 72 65 65  linenoiseSetFree
0900: 48 69 6e 74 73 43 61 6c 6c 62 61 63 6b 28 6c 69  HintsCallback(li
0910: 6e 65 6e 6f 69 73 65 46 72 65 65 48 69 6e 74 73  nenoiseFreeHints
0920: 43 61 6c 6c 62 61 63 6b 20 2a 29 3b 0a 76 6f 69  Callback *);.voi
0930: 64 20 6c 69 6e 65 6e 6f 69 73 65 41 64 64 43 6f  d linenoiseAddCo
0940: 6d 70 6c 65 74 69 6f 6e 28 6c 69 6e 65 6e 6f 69  mpletion(linenoi
0950: 73 65 43 6f 6d 70 6c 65 74 69 6f 6e 73 20 2a 2c  seCompletions *,
0960: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a   const char *);.
0970: 0a 63 68 61 72 20 2a 6c 69 6e 65 6e 6f 69 73 65  .char *linenoise
0980: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 70 72 6f  (const char *pro
0990: 6d 70 74 29 3b 0a 76 6f 69 64 20 6c 69 6e 65 6e  mpt);.void linen
09a0: 6f 69 73 65 46 72 65 65 28 76 6f 69 64 20 2a 70  oiseFree(void *p
09b0: 74 72 29 3b 0a 69 6e 74 20 6c 69 6e 65 6e 6f 69  tr);.int linenoi
09c0: 73 65 48 69 73 74 6f 72 79 41 64 64 28 63 6f 6e  seHistoryAdd(con
09d0: 73 74 20 63 68 61 72 20 2a 6c 69 6e 65 29 3b 0a  st char *line);.
09e0: 69 6e 74 20 6c 69 6e 65 6e 6f 69 73 65 48 69 73  int linenoiseHis
09f0: 74 6f 72 79 53 65 74 4d 61 78 4c 65 6e 28 69 6e  torySetMaxLen(in
0a00: 74 20 6c 65 6e 29 3b 0a 69 6e 74 20 6c 69 6e 65  t len);.int line
0a10: 6e 6f 69 73 65 48 69 73 74 6f 72 79 53 61 76 65  noiseHistorySave
0a20: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c  (const char *fil
0a30: 65 6e 61 6d 65 29 3b 0a 69 6e 74 20 6c 69 6e 65  ename);.int line
0a40: 6e 6f 69 73 65 48 69 73 74 6f 72 79 4c 6f 61 64  noiseHistoryLoad
0a50: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c  (const char *fil
0a60: 65 6e 61 6d 65 29 3b 0a 76 6f 69 64 20 6c 69 6e  ename);.void lin
0a70: 65 6e 6f 69 73 65 43 6c 65 61 72 53 63 72 65 65  enoiseClearScree
0a80: 6e 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 6c 69  n(void);.void li
0a90: 6e 65 6e 6f 69 73 65 53 65 74 4d 75 6c 74 69 4c  nenoiseSetMultiL
0aa0: 69 6e 65 28 69 6e 74 20 6d 6c 29 3b 0a 76 6f 69  ine(int ml);.voi
0ab0: 64 20 6c 69 6e 65 6e 6f 69 73 65 50 72 69 6e 74  d linenoisePrint
0ac0: 4b 65 79 43 6f 64 65 73 28 76 6f 69 64 29 3b 0a  KeyCodes(void);.
0ad0: 0a 23 69 66 64 65 66 20 5f 5f 63 70 6c 75 73 70  .#ifdef __cplusp
0ae0: 6c 75 73 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 65  lus.}.#endif..#e
0af0: 6e 64 69 66 20 2f 2a 20 5f 5f 4c 49 4e 45 4e 4f  ndif /* __LINENO
0b00: 49 53 45 5f 48 20 2a 2f 0a                       ISE_H */.