1/*****************************************************************************/
2/* */
3/* scanstrbuf.h */
4/* */
5/* Small scanner for input from a StrBuf */
6/* */
7/* */
8/* */
9/* (C) 2002-2009, Ullrich von Bassewitz */
10/* Roemerstrasse 52 */
11/* D-70794 Filderstadt */
12/* EMail: uz@cc65.org */
13/* */
14/* */
15/* This software is provided 'as-is', without any expressed or implied */
16/* warranty. In no event will the authors be held liable for any damages */
17/* arising from the use of this software. */
18/* */
19/* Permission is granted to anyone to use this software for any purpose, */
20/* including commercial applications, and to alter it and redistribute it */
21/* freely, subject to the following restrictions: */
22/* */
23/* 1. The origin of this software must not be misrepresented; you must not */
24/* claim that you wrote the original software. If you use this software */
25/* in a product, an acknowledgment in the product documentation would be */
26/* appreciated but is not required. */
27/* 2. Altered source versions must be plainly marked as such, and must not */
28/* be misrepresented as being the original software. */
29/* 3. This notice may not be removed or altered from any source */
30/* distribution. */
31/* */
32/*****************************************************************************/
33
34
35
36#ifndef SCANSTRBUF_H
37#define SCANSTRBUF_H
38
39
40
41/* common */
42#include "strbuf.h"
43
44
45
46/*****************************************************************************/
47/* Code */
48/*****************************************************************************/
49
50
51
52void SB_SkipWhite (StrBuf* B);
53/* Skip whitespace in the string buffer */
54
55int SB_GetSym (StrBuf* B, StrBuf* Ident, const char* SpecialChars);
56/* Get a symbol from the string buffer. If SpecialChars is not NULL, it
57** points to a string that contains characters allowed within the string in
58** addition to letters, digits and the underline. Note: The identifier must
59** still begin with a letter.
60** Returns 1 if a symbol was found and 0 otherwise but doesn't output any
61** errors.
62*/
63
64int SB_GetString (StrBuf* B, StrBuf* S);
65/* Get a string from the string buffer. Returns 1 if a string was found and 0
66** otherwise. Errors are only output in case of invalid strings (missing end
67** of string).
68*/
69
70int SB_GetNumber (StrBuf* B, long* Val);
71/* Get a number from the string buffer. Accepted formats are decimal, octal,
72** hex and character constants. Numeric constants may be preceeded by a
73** minus or plus sign. The function returns 1 if a number was found and
74** zero otherwise. Errors are only output for invalid numbers.
75*/
76
77
78
79/* End of scanstrbuf.h */
80
81#endif
82