ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / include

// Copyright (c) 2005, Google Inc.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//     * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
//     * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
// Author: Sanjay Ghemawat
//
// Regular-expression based scanner for parsing an input stream.
//
// Example 1: parse a sequence of "var = number" entries from input:
//
//      Scanner scanner(input);
//      string var;
//      int number;
//      scanner.SetSkipExpression("\\s+"); // Skip any white space we encounter
//      while (scanner.Consume("(\\w+) = (\\d+)", &var, &number)) {
//        ...;
//      }

#ifndef _PCRE_SCANNER_H
#define _PCRE_SCANNER_H

#include <assert.h>
#include <string>
#include <vector>

#include <pcrecpp.h>
#include <pcre_stringpiece.h>

namespace pcrecpp {

class PCRECPP_EXP_DEFN Scanner {
 public:
  Scanner();
  explicit Scanner(const std::string& input);
  ~Scanner();

// Return current line number.  The returned line-number is
  // one-based.  I.e. it returns 1 + the number of consumed newlines.
  //
  // Note: this method may be slow.  It may take time proportional to
  // the size of the input.
  int LineNumber() const;

// Return the byte-offset that the scanner is looking in the
  // input data;
  int Offset() const;

// Return true iff the start of the remaining input matches "re"
  bool LookingAt(const RE& re) const;

// Return true iff all of the following are true
  //    a. the start of the remaining input matches "re",
  //    b. if any arguments are supplied, matched sub-patterns can be
  //       parsed and stored into the arguments.
  // If it returns true, it skips over the matched input and any
  // following input that matches the "skip" regular expression.
  bool Consume(const RE& re,
               const Arg& arg0 = RE::no_arg,
               const Arg& arg1 = RE::no_arg,
               const Arg& arg2 = RE::no_arg
               // TODO: Allow more arguments?
               );

// Set the "skip" regular expression.  If after consuming some data,
  // a prefix of the input matches this RE, it is automatically
  // skipped.  For example, a programming language scanner would use
  // a skip RE that matches white space and comments.
  //
  //    scanner.SetSkipExpression("\\s+|//.*|/[*](.|\n)*?[*]/");
  //
  // Skipping repeats as long as it succeeds.  We used to let people do
  // this by writing "(...)*" in the regular expression, but that added
  // up to lots of recursive calls within the pcre library, so now we
  // control repetition explicitly via the function call API.
  //
  // You can pass NULL for "re" if you do not want any data to be skipped.
  void Skip(const char* re);   // DEPRECATED; does *not* repeat
  void SetSkipExpression(const char* re);

// Temporarily pause "skip"ing. This
  //   Skip("Foo"); code ; DisableSkip(); code; EnableSkip()
  // is similar to
  //   Skip("Foo"); code ; Skip(NULL); code ; Skip("Foo");
  // but avoids creating/deleting new RE objects.
  void DisableSkip();

// Reenable previously paused skipping.  Any prefix of the input
  // that matches the skip pattern is immediately dropped.
  void EnableSkip();

/***** Special wrappers around SetSkip() for some common idioms *****/

// Arranges to skip whitespace, C comments, C++ comments.
  // The overall RE is a disjunction of the following REs:
  //    \\s                     whitespace
  //    //.*\n                  C++ comment
  //    /[*](.|\n)*?[*]/        C comment (x*? means minimal repetitions of x)
  // We get repetition via the semantics of SetSkipExpression, not by using *
  void SkipCXXComments() {
    SetSkipExpression("\\s|//.*\n|/[*](?:\n|.)*?[*]/");
  }

void set_save_comments(bool comments) {
    save_comments_ = comments;
  }

bool save_comments() {
    return save_comments_;
  }

// Append to vector ranges the comments found in the
  // byte range [start,end] (inclusive) of the input data.
  // Only comments that were extracted entirely within that
  // range are returned: no range splitting of atomically-extracted
  // comments is performed.
  void GetComments(int start, int end, std::vector<StringPiece> *ranges);

// Append to vector ranges the comments added
  // since the last time this was called. This
  // functionality is provided for efficiency when
  // interleaving scanning with parsing.
  void GetNextComments(std::vector<StringPiece> *ranges);

private:
  std::string   data_;          // All the input data
  StringPiece   input_;         // Unprocessed input
  RE*           skip_;          // If non-NULL, RE for skipping input
  bool          should_skip_;   // If true, use skip_
  bool          skip_repeat_;   // If true, repeat skip_ as long as it works
  bool          save_comments_; // If true, aggregate the skip expression

// the skipped comments
  // TODO: later consider requiring that the StringPieces be added
  // in order by their start position
  std::vector<StringPiece> *comments_;

// the offset into comments_ that has been returned by GetNextComments
  int           comments_offset_;

// helper function to consume *skip_ and honour
  // save_comments_
  void ConsumeSkip();
};

}   // namespace pcrecpp

#endif /* _PCRE_SCANNER_H */

[+] ..
[-] krb5.h [edit]
[-] lauxlib.h [edit]
[-] execinfo.h [edit]
[-] zlib.h [edit]
[+] drm
[-] sched.h [edit]
[-] netdb.h [edit]
[-] fmtmsg.h [edit]
[+] mtd
[-] kdb.h [edit]
[+] libpng15
[-] ctype.h [edit]
[-] xf86drm.h [edit]
[-] gpg-error.h [edit]
[-] gshadow.h [edit]
[-] spawn.h [edit]
[-] wchar.h [edit]
[-] gdfontg.h [edit]
[+] rpc
[-] FlexLexer.h [edit]
[-] cpufreq.h [edit]
[-] monetary.h [edit]
[-] autosprintf.h [edit]
[-] ldap.h [edit]
[-] punycode.h [edit]
[-] db_185.h [edit]
[+] gtk-2.0
[+] gnu
[+] GL
[+] pixman-1
[-] string.h [edit]
[-] unistd.h [edit]
[-] lber_types.h [edit]
[-] pcreposix.h [edit]
[-] endian.h [edit]
[+] libexslt
[+] autotrace
[-] stdio_ext.h [edit]
[+] nfs
[-] pcre.h [edit]
[-] locale.h [edit]
[-] idn-free.h [edit]
[+] pango-1.0
[-] jmorecfg.h [edit]
[+] ImageMagick-6
[+] libkms
[-] getopt.h [edit]
[-] gcrypt.h [edit]
[-] dirent.h [edit]
[-] expat_external.h [edit]
[-] xlocale.h [edit]
[+] ijs
[-] grp.h [edit]
[-] gconv.h [edit]
[-] tiffconf.h [edit]
[-] jpeglib.h [edit]
[-] unctrl.h [edit]
[+] gio-unix-2.0
[-] utime.h [edit]
[+] net
[+] rdma
[-] bzlib.h [edit]
[-] png.h [edit]
[+] netax25
[-] mntent.h [edit]
[-] cursesp.h [edit]
[+] libltdl
[-] pwd.h [edit]
[+] libxslt
[+] neteconet
[-] aio.h [edit]
[+] db4.7.25
[-] fenv.h [edit]
[+] libxml2
[+] netash
[+] gdbm
[+] xen
[+] openssl
[+] sepol
[-] mcheck.h [edit]
[-] syscall.h [edit]
[-] nl_types.h [edit]
[-] crypt.h [edit]
[+] protocols
[-] com_err.h [edit]
[+] selinux
[+] rpcsvc
[-] errno.h [edit]
[-] argp.h [edit]
[-] regex.h [edit]
[-] fcntl.h [edit]
[-] stdc-predef.h [edit]
[-] gssapi.h [edit]
[-] cursesw.h [edit]
[-] malloc.h [edit]
[-] mqueue.h [edit]
[-] pnglibconf.h [edit]
[+] scsi
[-] dbm.h [edit]
[-] xf86drmMode.h [edit]
[-] ndbm.h [edit]
[-] math.h [edit]
[-] cursslk.h [edit]
[-] krad.h [edit]
[+] netrose
[-] ncurses_dll.h [edit]
[+] fontconfig
[-] libsync.h [edit]
[-] err.h [edit]
[-] termcap.h [edit]
[-] jerror.h [edit]
[-] semaphore.h [edit]
[+] glib-2.0
[-] gcrypt-module.h [edit]
[-] obstack.h [edit]
[-] _G_config.h [edit]
[-] luaconf.h [edit]
[-] cursesf.h [edit]
[-] ldap_cdefs.h [edit]
[-] sysexits.h [edit]
[-] envz.h [edit]
[+] harfbuzz
[-] stdint.h [edit]
[-] lber.h [edit]
[+] graphite2
[+] gssrpc
[-] gnu-versions.h [edit]
[+] unicode
[-] cursesm.h [edit]
[-] re_comp.h [edit]
[+] kadm5
[-] printf.h [edit]
[-] gdfontl.h [edit]
[+] arpa
[-] pthread.h [edit]
[-] pcre_scanner.h [edit]
[-] gdfontt.h [edit]
[-] slapi-plugin.h [edit]
[+] uapi
[+] mysql
[+] freetype2
[-] tld.h [edit]
[-] ldif.h [edit]
[-] lualib.h [edit]
[+] libwmf
[-] time.h [edit]
[+] X11
[-] pcrecpp.h [edit]
[+] quota
[+] sys
[-] setjmp.h [edit]
[-] regexp.h [edit]
[-] features.h [edit]
[-] libaio.h [edit]
[-] eti.h [edit]
[-] term.h [edit]
[-] utmpx.h [edit]
[+] gdk-pixbuf-2.0
[-] ar.h [edit]
[-] panel.h [edit]
[-] iconv.h [edit]
[+] ncurses
[-] gd_io.h [edit]
[-] gdbm.h [edit]
[+] uuid
[-] ncurses.h [edit]
[+] librsvg-2.0
[-] fnmatch.h [edit]
[+] c++
[-] stdlib.h [edit]
[-] stringprep.h [edit]
[-] gdcache.h [edit]
[-] tiff.h [edit]
[-] sgtty.h [edit]
[-] pngconf.h [edit]
[-] wctype.h [edit]
[-] ldap_schema.h [edit]
[-] syslog.h [edit]
[-] cursesapp.h [edit]
[-] complex.h [edit]
[+] asm
[-] ifaddrs.h [edit]
[-] ieee754.h [edit]
[-] limits.h [edit]
[-] fstab.h [edit]
[+] krb5
[+] netpacket
[-] libio.h [edit]
[-] lua.h [edit]
[+] misc
[-] poll.h [edit]
[-] values.h [edit]
[+] ghostscript
[+] netipx
[+] netrom
[-] stdio.h [edit]
[-] tiffvers.h [edit]
[+] netiucv
[-] memory.h [edit]
[+] layout
[-] db.h [edit]
[-] alloca.h [edit]
[-] uchar.h [edit]
[-] tiffio.hxx [edit]
[-] tiffconf-64.h [edit]
[-] nc_tparm.h [edit]
[+] netinet
[-] pcrecpparg.h [edit]
[-] aliases.h [edit]
[-] ulimit.h [edit]
[-] verto.h [edit]
[-] tic.h [edit]
[+] python3.6m
[-] lzma.h [edit]
[-] paths.h [edit]
[+] et
[-] idna.h [edit]
[+] cairo
[-] term_entry.h [edit]
[-] fpu_control.h [edit]
[-] profile.h [edit]
[+] ncursesw
[+] KHR
[-] jconfig.h [edit]
[+] sasl
[+] sound
[-] search.h [edit]
[-] fts.h [edit]
[-] termios.h [edit]
[-] ltdl.h [edit]
[-] verto-module.h [edit]
[+] bits
[-] elf.h [edit]
[-] expat.h [edit]
[+] atk-1.0
[-] termio.h [edit]
[-] ustat.h [edit]
[-] nss.h [edit]
[+] apache2
[-] wait.h [edit]
[-] error.h [edit]
[-] ttyent.h [edit]
[-] inttypes.h [edit]
[-] assert.h [edit]
[+] video
[+] python2.7
[-] wordexp.h [edit]
[-] a.out.h [edit]
[-] tgmath.h [edit]
[-] shadow.h [edit]
[-] zconf.h [edit]
[-] ftw.h [edit]
[-] resolv.h [edit]
[-] libintl.h [edit]
[+] fribidi
[-] ldap_features.h [edit]
[-] glob.h [edit]
[+] xcb
[-] curses.h [edit]
[-] gdfonts.h [edit]
[-] tiffio.h [edit]
[-] entities.h [edit]
[+] gtk-unix-print-2.0
[+] asm-generic
[-] argz.h [edit]
[-] lastlog.h [edit]
[-] keyutils.h [edit]
[-] tcpd.h [edit]
[-] gd.h [edit]
[-] ucontext.h [edit]
[+] linux
[-] menu.h [edit]
[+] ext2fs
[-] stab.h [edit]
[-] form.h [edit]
[-] idn-int.h [edit]
[-] langinfo.h [edit]
[+] e2p
[-] libgen.h [edit]
[-] thread_db.h [edit]
[-] signal.h [edit]
[+] netatalk
[-] dlfcn.h [edit]
[-] ldap_utf8.h [edit]
[-] pcre_stringpiece.h [edit]
[-] cpio.h [edit]
[+] glvnd
[+] gail-1.0
[-] gdfx.h [edit]
[-] pty.h [edit]
[+] bind9
[-] gdfontmb.h [edit]
[-] utmp.h [edit]
[+] jasper
[+] libdrm
[-] byteswap.h [edit]
[+] gssapi
[-] fam.h [edit]
[-] pr29.h [edit]
[-] tar.h [edit]
[-] etip.h [edit]
[+] EGL
[+] libdb
[+] ffmpeg
[+] security
[-] link.h [edit]
[-] strings.h [edit]
[-] gettext-po.h [edit]
[+] lzma
[-] lua.hpp [edit]