aboutsummaryrefslogtreecommitdiff
path: root/libbutl/string-parser.mxx
blob: f7a941260d4f8716a791bc05dcc28a237bf1afb6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
// file      : libbutl/string-parser.mxx -*- C++ -*-
// copyright : Copyright (c) 2014-2018 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

#ifndef __cpp_modules
#pragma once
#endif

// C includes.

#ifndef __cpp_lib_modules
#include <string>
#include <vector>
#include <cstddef>   // size_t
#include <utility>   // pair
#include <stdexcept> // invalid_argument
#endif

// Other includes.

#ifdef __cpp_modules
export module butl.string_parser;
#ifdef __cpp_lib_modules
import std.core;
#endif
#endif

#include <libbutl/export.hxx>

LIBBUTL_MODEXPORT namespace butl
{
  namespace string_parser
  {
    class LIBBUTL_SYMEXPORT invalid_string: public std::invalid_argument
    {
    public:
      invalid_string (std::size_t p, const std::string& d)
        : invalid_argument (d), position (p) {}

      std::size_t position; // Zero-based.
    };

    // Parse a whitespace-separated list of strings. Can contain single or
    // double quoted substrings. No escaping is supported. If unquote is true,
    // return one-level unquoted values. Throw invalid_string in case of
    // invalid quoting.
    //
    LIBBUTL_SYMEXPORT std::vector<std::string>
    parse_quoted (const std::string&, bool unquote);

    // As above but return a list of string and zero-based position pairs.
    // Position is useful for issuing diagnostics about an invalid string
    // during second-level parsing.
    //
    LIBBUTL_SYMEXPORT std::vector<std::pair<std::string, std::size_t>>
    parse_quoted_position (const std::string&, bool unquote);

    // Remove a single level of quotes. Note that the format or the
    // correctness of the quotation is not validated.
    //
    LIBBUTL_SYMEXPORT std::string
    unquote (const std::string&);

    LIBBUTL_SYMEXPORT std::vector<std::string>
    unquote (const std::vector<std::string>&);
  }
}