Gecko [ georgetownmover.com ]

Name	Size	Permission	Date
alphaindex.h	26.48 KB	-rw-r--r--	2024-02-06 07:47
appendable.h	8.49 KB	-rw-r--r--	2024-02-06 07:47
basictz.h	9.68 KB	-rw-r--r--	2024-02-06 07:47
brkiter.h	27.8 KB	-rw-r--r--	2024-02-06 07:47
bytestream.h	10.73 KB	-rw-r--r--	2024-02-06 07:47
bytestrie.h	20.77 KB	-rw-r--r--	2024-02-06 07:47
bytestriebuilder.h	7.29 KB	-rw-r--r--	2024-02-06 07:47
calendar.h	105.88 KB	-rw-r--r--	2024-02-06 07:47
caniter.h	7.43 KB	-rw-r--r--	2024-02-06 07:47
casemap.h	25.33 KB	-rw-r--r--	2024-02-06 07:47
char16ptr.h	7.22 KB	-rw-r--r--	2024-02-06 07:47
chariter.h	24.05 KB	-rw-r--r--	2024-02-06 07:47
choicfmt.h	23.91 KB	-rw-r--r--	2024-02-06 07:47
coleitr.h	13.76 KB	-rw-r--r--	2024-02-06 07:47
coll.h	56.26 KB	-rw-r--r--	2024-02-06 07:47
compactdecimalformat.h	6.88 KB	-rw-r--r--	2024-02-06 07:47
curramt.h	3.76 KB	-rw-r--r--	2024-02-06 07:47
currpinf.h	7.3 KB	-rw-r--r--	2024-02-06 07:47
currunit.h	4 KB	-rw-r--r--	2024-02-06 07:47
datefmt.h	40.67 KB	-rw-r--r--	2024-02-06 07:47
dbbi.h	1.19 KB	-rw-r--r--	2024-02-06 07:47
dcfmtsym.h	20.42 KB	-rw-r--r--	2024-02-06 07:47
decimfmt.h	87.58 KB	-rw-r--r--	2024-02-06 07:47
docmain.h	7.21 KB	-rw-r--r--	2024-02-06 07:47
dtfmtsym.h	37.73 KB	-rw-r--r--	2024-02-06 07:47
dtintrv.h	3.84 KB	-rw-r--r--	2024-02-06 07:47
dtitvfmt.h	49.29 KB	-rw-r--r--	2024-02-06 07:47
dtitvinf.h	18.62 KB	-rw-r--r--	2024-02-06 07:47
dtptngen.h	26.06 KB	-rw-r--r--	2024-02-06 07:47
dtrule.h	8.68 KB	-rw-r--r--	2024-02-06 07:47
edits.h	20.74 KB	-rw-r--r--	2024-02-06 07:47
enumset.h	2.08 KB	-rw-r--r--	2024-02-06 07:47
errorcode.h	4.84 KB	-rw-r--r--	2024-02-06 07:47
fieldpos.h	8.69 KB	-rw-r--r--	2024-02-06 07:47
filteredbrk.h	5.37 KB	-rw-r--r--	2024-02-06 07:47
fmtable.h	24.42 KB	-rw-r--r--	2024-02-06 07:47
format.h	12.5 KB	-rw-r--r--	2024-02-06 07:47
formattedvalue.h	9.75 KB	-rw-r--r--	2024-02-06 07:47
fpositer.h	3.04 KB	-rw-r--r--	2024-02-06 07:47
gender.h	3.33 KB	-rw-r--r--	2024-02-06 07:47
gregocal.h	31.71 KB	-rw-r--r--	2024-02-06 07:47
icudataver.h	1.02 KB	-rw-r--r--	2024-02-06 07:47
icuplug.h	11.83 KB	-rw-r--r--	2024-02-06 07:47
idna.h	12.7 KB	-rw-r--r--	2024-02-06 07:47
listformatter.h	8.79 KB	-rw-r--r--	2024-02-06 07:47
localebuilder.h	11.23 KB	-rw-r--r--	2024-02-06 07:47
localematcher.h	26.98 KB	-rw-r--r--	2024-02-06 07:47
localpointer.h	19.36 KB	-rw-r--r--	2024-02-06 07:47
locdspnm.h	7.12 KB	-rw-r--r--	2024-02-06 07:47
locid.h	47.65 KB	-rw-r--r--	2024-02-06 07:47
measfmt.h	11.37 KB	-rw-r--r--	2024-02-06 07:47
measunit.h	104.66 KB	-rw-r--r--	2024-02-06 07:47
measure.h	4.32 KB	-rw-r--r--	2024-02-06 07:47
messagepattern.h	33.71 KB	-rw-r--r--	2024-02-06 07:47
msgfmt.h	44.12 KB	-rw-r--r--	2024-02-06 07:47
normalizer2.h	33.66 KB	-rw-r--r--	2024-02-06 07:47
normlzr.h	30.94 KB	-rw-r--r--	2024-02-06 07:47
nounit.h	2.3 KB	-rw-r--r--	2024-02-06 07:47
numberformatter.h	92.23 KB	-rw-r--r--	2024-02-06 07:47
numberrangeformatter.h	25.04 KB	-rw-r--r--	2024-02-06 07:47
numfmt.h	49.77 KB	-rw-r--r--	2024-02-06 07:47
numsys.h	7.32 KB	-rw-r--r--	2024-02-06 07:47
parseerr.h	3.08 KB	-rw-r--r--	2024-02-06 07:47
parsepos.h	5.56 KB	-rw-r--r--	2024-02-06 07:47
platform.h	28.08 KB	-rw-r--r--	2024-02-06 07:47
plurfmt.h	25.18 KB	-rw-r--r--	2024-02-06 07:47
plurrule.h	20.84 KB	-rw-r--r--	2024-02-06 07:47
ptypes.h	3.49 KB	-rw-r--r--	2024-02-06 07:47
putil.h	6.32 KB	-rw-r--r--	2024-02-06 07:47
rbbi.h	27.57 KB	-rw-r--r--	2024-02-06 07:47
rbnf.h	48.73 KB	-rw-r--r--	2024-02-06 07:47
rbtz.h	15.72 KB	-rw-r--r--	2024-02-06 07:47
regex.h	84.34 KB	-rw-r--r--	2024-02-06 07:47
region.h	9.18 KB	-rw-r--r--	2024-02-06 07:47
reldatefmt.h	22.22 KB	-rw-r--r--	2024-02-06 07:47
rep.h	9.37 KB	-rw-r--r--	2024-02-06 07:47
resbund.h	18.07 KB	-rw-r--r--	2024-02-06 07:47
schriter.h	6.32 KB	-rw-r--r--	2024-02-06 07:47
scientificnumberformatter.h	6.4 KB	-rw-r--r--	2024-02-06 07:47
search.h	22.22 KB	-rw-r--r--	2024-02-06 07:47
selfmt.h	14.3 KB	-rw-r--r--	2024-02-06 07:47
simpleformatter.h	12.59 KB	-rw-r--r--	2024-02-06 07:47
simpletz.h	45.55 KB	-rw-r--r--	2024-02-06 07:47
smpdtfmt.h	71 KB	-rw-r--r--	2024-02-06 07:47
sortkey.h	11.18 KB	-rw-r--r--	2024-02-06 07:47
std_string.h	1.05 KB	-rw-r--r--	2024-02-06 07:47
strenum.h	9.92 KB	-rw-r--r--	2024-02-06 07:47
stringoptions.h	5.79 KB	-rw-r--r--	2024-02-06 07:47
stringpiece.h	10.05 KB	-rw-r--r--	2024-02-06 07:47
stringtriebuilder.h	15.33 KB	-rw-r--r--	2024-02-06 07:47
stsearch.h	21.3 KB	-rw-r--r--	2024-02-06 07:47
symtable.h	4.27 KB	-rw-r--r--	2024-02-06 07:47
tblcoll.h	36.65 KB	-rw-r--r--	2024-02-06 07:47
timezone.h	41.52 KB	-rw-r--r--	2024-02-06 07:47
tmunit.h	3.38 KB	-rw-r--r--	2024-02-06 07:47
tmutamt.h	4.9 KB	-rw-r--r--	2024-02-06 07:47
tmutfmt.h	7.85 KB	-rw-r--r--	2024-02-06 07:47
translit.h	65.81 KB	-rw-r--r--	2024-02-06 07:47
tzfmt.h	42.89 KB	-rw-r--r--	2024-02-06 07:47
tznames.h	16.85 KB	-rw-r--r--	2024-02-06 07:47
tzrule.h	35.37 KB	-rw-r--r--	2024-02-06 07:47
tztrans.h	6.12 KB	-rw-r--r--	2024-02-06 07:47
ubidi.h	89.54 KB	-rw-r--r--	2024-02-06 07:47
ubiditransform.h	12.7 KB	-rw-r--r--	2024-02-06 07:47
ubrk.h	24.45 KB	-rw-r--r--	2024-02-06 07:47
ucal.h	61 KB	-rw-r--r--	2024-02-06 07:47
ucasemap.h	15.21 KB	-rw-r--r--	2024-02-06 07:47
ucat.h	5.35 KB	-rw-r--r--	2024-02-06 07:47
uchar.h	141.13 KB	-rw-r--r--	2024-02-06 07:47
ucharstrie.h	22.53 KB	-rw-r--r--	2024-02-06 07:47
ucharstriebuilder.h	7.3 KB	-rw-r--r--	2024-02-06 07:47
uchriter.h	13.2 KB	-rw-r--r--	2024-02-06 07:47
uclean.h	11.2 KB	-rw-r--r--	2024-02-06 07:47
ucnv.h	83.04 KB	-rw-r--r--	2024-02-06 07:47
ucnv_cb.h	6.58 KB	-rw-r--r--	2024-02-06 07:47
ucnv_err.h	20.97 KB	-rw-r--r--	2024-02-06 07:47
ucnvsel.h	6.19 KB	-rw-r--r--	2024-02-06 07:47
ucol.h	61.51 KB	-rw-r--r--	2024-02-06 07:47
ucoleitr.h	9.82 KB	-rw-r--r--	2024-02-06 07:47
uconfig.h	12.07 KB	-rw-r--r--	2024-02-06 07:47
ucpmap.h	5.53 KB	-rw-r--r--	2024-02-06 07:47
ucptrie.h	22.51 KB	-rw-r--r--	2024-02-06 07:47
ucsdet.h	14.69 KB	-rw-r--r--	2024-02-06 07:47
ucurr.h	16.77 KB	-rw-r--r--	2024-02-06 07:47
udat.h	62.11 KB	-rw-r--r--	2024-02-06 07:47
udata.h	15.62 KB	-rw-r--r--	2024-02-06 07:47
udateintervalformat.h	11.98 KB	-rw-r--r--	2024-02-06 07:47
udatpg.h	26.76 KB	-rw-r--r--	2024-02-06 07:47
udisplaycontext.h	5.94 KB	-rw-r--r--	2024-02-06 07:47
uenum.h	7.79 KB	-rw-r--r--	2024-02-06 07:47
ufieldpositer.h	4.41 KB	-rw-r--r--	2024-02-06 07:47
uformattable.h	10.97 KB	-rw-r--r--	2024-02-06 07:47
uformattedvalue.h	12.3 KB	-rw-r--r--	2024-02-06 07:47
ugender.h	2.06 KB	-rw-r--r--	2024-02-06 07:47
uidna.h	33.43 KB	-rw-r--r--	2024-02-06 07:47
uiter.h	22.75 KB	-rw-r--r--	2024-02-06 07:47
uldnames.h	10.48 KB	-rw-r--r--	2024-02-06 07:47
ulistformatter.h	10.78 KB	-rw-r--r--	2024-02-06 07:47
uloc.h	54.6 KB	-rw-r--r--	2024-02-06 07:47
ulocdata.h	11.3 KB	-rw-r--r--	2024-02-06 07:47
umachine.h	16.05 KB	-rw-r--r--	2024-02-06 07:47
umisc.h	1.33 KB	-rw-r--r--	2024-02-06 07:47
umsg.h	24.25 KB	-rw-r--r--	2024-02-06 07:47
umutablecptrie.h	8.29 KB	-rw-r--r--	2024-02-06 07:47
unifilt.h	3.96 KB	-rw-r--r--	2024-02-06 07:47
unifunct.h	4.04 KB	-rw-r--r--	2024-02-06 07:47
unimatch.h	6.1 KB	-rw-r--r--	2024-02-06 07:47
unirepl.h	3.38 KB	-rw-r--r--	2024-02-06 07:47
uniset.h	65.04 KB	-rw-r--r--	2024-02-06 07:47
unistr.h	170.46 KB	-rw-r--r--	2024-02-06 07:47
unorm.h	20.52 KB	-rw-r--r--	2024-02-06 07:47
unorm2.h	24.68 KB	-rw-r--r--	2024-02-06 07:47
unum.h	54.88 KB	-rw-r--r--	2024-02-06 07:47
unumberformatter.h	30.55 KB	-rw-r--r--	2024-02-06 07:47
unumberrangeformatter.h	15.38 KB	-rw-r--r--	2024-02-06 07:47
unumsys.h	7.26 KB	-rw-r--r--	2024-02-06 07:47
uobject.h	10.68 KB	-rw-r--r--	2024-02-06 07:47
upluralrules.h	8.8 KB	-rw-r--r--	2024-02-06 07:47
uregex.h	71.99 KB	-rw-r--r--	2024-02-06 07:47
uregion.h	9.81 KB	-rw-r--r--	2024-02-06 07:47
ureldatefmt.h	17.04 KB	-rw-r--r--	2024-02-06 07:47
urename.h	133.97 KB	-rw-r--r--	2024-02-06 07:47
urep.h	5.38 KB	-rw-r--r--	2024-02-06 07:47
ures.h	36.54 KB	-rw-r--r--	2024-02-06 07:47
uscript.h	27.19 KB	-rw-r--r--	2024-02-06 07:47
usearch.h	39.07 KB	-rw-r--r--	2024-02-06 07:47
uset.h	42.59 KB	-rw-r--r--	2024-02-06 07:47
usetiter.h	9.55 KB	-rw-r--r--	2024-02-06 07:47
ushape.h	18 KB	-rw-r--r--	2024-02-06 07:47
uspoof.h	65.84 KB	-rw-r--r--	2024-02-06 07:47
usprep.h	8.19 KB	-rw-r--r--	2024-02-06 07:47
ustdio.h	38.55 KB	-rw-r--r--	2024-02-06 07:47
ustream.h	1.89 KB	-rw-r--r--	2024-02-06 07:47
ustring.h	72.35 KB	-rw-r--r--	2024-02-06 07:47
ustringtrie.h	3.15 KB	-rw-r--r--	2024-02-06 07:47
utext.h	58.08 KB	-rw-r--r--	2024-02-06 07:47
utf.h	7.87 KB	-rw-r--r--	2024-02-06 07:47
utf16.h	23.35 KB	-rw-r--r--	2024-02-06 07:47
utf32.h	763 B	-rw-r--r--	2024-02-06 07:47
utf8.h	30.83 KB	-rw-r--r--	2024-02-06 07:47
utf_old.h	45.83 KB	-rw-r--r--	2024-02-06 07:47
utmscale.h	13.78 KB	-rw-r--r--	2024-02-06 07:47
utrace.h	17.18 KB	-rw-r--r--	2024-02-06 07:47
utrans.h	25.54 KB	-rw-r--r--	2024-02-06 07:47
utypes.h	31.06 KB	-rw-r--r--	2024-02-06 07:47
uvernum.h	6.68 KB	-rw-r--r--	2024-02-06 07:47
uversion.h	5.99 KB	-rw-r--r--	2024-02-06 07:47
vtzone.h	20.67 KB	-rw-r--r--	2024-02-06 07:47

Rename

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
// Copyright (C) 2009-2013, International Business Machines
// Corporation and others. All Rights Reserved.
//
// Copyright 2001 and onwards Google Inc.
// Author: Sanjay Ghemawat

// This code is a contribution of Google code, and the style used here is
// a compromise between the original Google code and the ICU coding guidelines.
// For example, data types are ICU-ified (size_t,int->int32_t),
// and API comments doxygen-ified, but function names and behavior are
// as in the original, if possible.
// Assertion-style error handling, not available in ICU, was changed to
// parameter "pinning" similar to UnicodeString.
//
// In addition, this is only a partial port of the original Google code,
// limited to what was needed so far. The (nearly) complete original code
// is in the ICU svn repository at icuhtml/trunk/design/strings/contrib
// (see ICU ticket 6765, r25517).

#ifndef __STRINGPIECE_H__
#define __STRINGPIECE_H__

/**
 * \file 
 * \brief C++ API: StringPiece: Read-only byte string wrapper class.
 */

#include "unicode/utypes.h"

#if U_SHOW_CPLUSPLUS_API

#include <cstddef>
#include <type_traits>

#include "unicode/uobject.h"
#include "unicode/std_string.h"

// Arghh!  I wish C++ literals were "string".

U_NAMESPACE_BEGIN

/**
 * A string-like object that points to a sized piece of memory.
 *
 * We provide non-explicit singleton constructors so users can pass
 * in a "const char*" or a "string" wherever a "StringPiece" is
 * expected.
 *
 * Functions or methods may use StringPiece parameters to accept either a
 * "const char*" or a "string" value that will be implicitly converted to a
 * StringPiece.
 *
 * Systematic usage of StringPiece is encouraged as it will reduce unnecessary
 * conversions from "const char*" to "string" and back again.
 *
 * @stable ICU 4.2
 */
class U_COMMON_API StringPiece : public UMemory {
 private:
  const char*   ptr_;
  int32_t       length_;

public:
  /**
   * Default constructor, creates an empty StringPiece.
   * @stable ICU 4.2
   */
  StringPiece() : ptr_(nullptr), length_(0) { }

/**
   * Constructs from a NUL-terminated const char * pointer.
   * @param str a NUL-terminated const char * pointer
   * @stable ICU 4.2
   */
  StringPiece(const char* str);
#if defined(__cpp_char8_t) || defined(U_IN_DOXYGEN)
  /**
   * Constructs from a NUL-terminated const char8_t * pointer.
   * @param str a NUL-terminated const char8_t * pointer
   * @stable ICU 67
   */
  StringPiece(const char8_t* str) : StringPiece(reinterpret_cast<const char*>(str)) {}
#endif
  /**
   * Constructs an empty StringPiece.
   * Needed for type disambiguation from multiple other overloads.
   * @param p nullptr
   * @stable ICU 67
   */
  StringPiece(std::nullptr_t p) : ptr_(p), length_(0) {}

/**
   * Constructs from a std::string.
   * @stable ICU 4.2
   */
  StringPiece(const std::string& str)
    : ptr_(str.data()), length_(static_cast<int32_t>(str.size())) { }
#if defined(__cpp_lib_char8_t) || defined(U_IN_DOXYGEN)
  /**
   * Constructs from a std::u8string.
   * @stable ICU 67
   */
  StringPiece(const std::u8string& str)
    : ptr_(reinterpret_cast<const char*>(str.data())),
      length_(static_cast<int32_t>(str.size())) { }
#endif

/**
   * Constructs from some other implementation of a string piece class, from any
   * C++ record type that has these two methods:
   *
   * \code{.cpp}
   *
   *   struct OtherStringPieceClass {
   *     const char* data();  // or const char8_t*
   *     size_t size();
   *   };
   *
   * \endcode
   *
   * The other string piece class will typically be std::string_view from C++17
   * or absl::string_view from Abseil.
   *
   * Starting with C++20, data() may also return a const char8_t* pointer,
   * as from std::u8string_view.
   *
   * @param str the other string piece
   * @stable ICU 65
   */
  template <typename T,
            typename = typename std::enable_if<
                (std::is_same<decltype(T().data()), const char*>::value
#if defined(__cpp_char8_t)
                    || std::is_same<decltype(T().data()), const char8_t*>::value
#endif
                ) &&
                std::is_same<decltype(T().size()), size_t>::value>::type>
  StringPiece(T str)
      : ptr_(reinterpret_cast<const char*>(str.data())),
        length_(static_cast<int32_t>(str.size())) {}

/**
   * Constructs from a const char * pointer and a specified length.
   * @param offset a const char * pointer (need not be terminated)
   * @param len the length of the string; must be non-negative
   * @stable ICU 4.2
   */
  StringPiece(const char* offset, int32_t len) : ptr_(offset), length_(len) { }
#if defined(__cpp_char8_t) || defined(U_IN_DOXYGEN)
  /**
   * Constructs from a const char8_t * pointer and a specified length.
   * @param str a const char8_t * pointer (need not be terminated)
   * @param len the length of the string; must be non-negative
   * @stable ICU 67
   */
  StringPiece(const char8_t* str, int32_t len) :
      StringPiece(reinterpret_cast<const char*>(str), len) {}
#endif

/**
   * Substring of another StringPiece.
   * @param x the other StringPiece
   * @param pos start position in x; must be non-negative and <= x.length().
   * @stable ICU 4.2
   */
  StringPiece(const StringPiece& x, int32_t pos);
  /**
   * Substring of another StringPiece.
   * @param x the other StringPiece
   * @param pos start position in x; must be non-negative and <= x.length().
   * @param len length of the substring;
   *            must be non-negative and will be pinned to at most x.length() - pos.
   * @stable ICU 4.2
   */
  StringPiece(const StringPiece& x, int32_t pos, int32_t len);

/**
   * Returns the string pointer. May be nullptr if it is empty.
   *
   * data() may return a pointer to a buffer with embedded NULs, and the
   * returned buffer may or may not be null terminated.  Therefore it is
   * typically a mistake to pass data() to a routine that expects a NUL
   * terminated string.
   * @return the string pointer
   * @stable ICU 4.2
   */
  const char* data() const { return ptr_; }
  /**
   * Returns the string length. Same as length().
   * @return the string length
   * @stable ICU 4.2
   */
  int32_t size() const { return length_; }
  /**
   * Returns the string length. Same as size().
   * @return the string length
   * @stable ICU 4.2
   */
  int32_t length() const { return length_; }
  /**
   * Returns whether the string is empty.
   * @return true if the string is empty
   * @stable ICU 4.2
   */
  UBool empty() const { return length_ == 0; }

/**
   * Sets to an empty string.
   * @stable ICU 4.2
   */
  void clear() { ptr_ = nullptr; length_ = 0; }

/**
   * Reset the stringpiece to refer to new data.
   * @param xdata pointer the new string data.  Need not be nul terminated.
   * @param len the length of the new data
   * @stable ICU 4.8
   */
  void set(const char* xdata, int32_t len) { ptr_ = xdata; length_ = len; }

/**
   * Reset the stringpiece to refer to new data.
   * @param str a pointer to a NUL-terminated string. 
   * @stable ICU 4.8
   */
  void set(const char* str);

#if defined(__cpp_char8_t) || defined(U_IN_DOXYGEN)
  /**
   * Resets the stringpiece to refer to new data.
   * @param xdata pointer the new string data. Need not be NUL-terminated.
   * @param len the length of the new data
   * @stable ICU 67
   */
  inline void set(const char8_t* xdata, int32_t len) {
      set(reinterpret_cast<const char*>(xdata), len);
  }

/**
   * Resets the stringpiece to refer to new data.
   * @param str a pointer to a NUL-terminated string.
   * @stable ICU 67
   */
  inline void set(const char8_t* str) {
      set(reinterpret_cast<const char*>(str));
  }
#endif

/**
   * Removes the first n string units.
   * @param n prefix length, must be non-negative and <=length()
   * @stable ICU 4.2
   */
  void remove_prefix(int32_t n) {
    if (n >= 0) {
      if (n > length_) {
        n = length_;
      }
      ptr_ += n;
      length_ -= n;
    }
  }

/**
   * Removes the last n string units.
   * @param n suffix length, must be non-negative and <=length()
   * @stable ICU 4.2
   */
  void remove_suffix(int32_t n) {
    if (n >= 0) {
      if (n <= length_) {
        length_ -= n;
      } else {
        length_ = 0;
      }
    }
  }

/**
   * Searches the StringPiece for the given search string (needle);
   * @param needle The string for which to search.
   * @param offset Where to start searching within this string (haystack).
   * @return The offset of needle in haystack, or -1 if not found.
   * @stable ICU 67
   */
  int32_t find(StringPiece needle, int32_t offset);

/**
   * Compares this StringPiece with the other StringPiece, with semantics
   * similar to std::string::compare().
   * @param other The string to compare to.
   * @return below zero if this < other; above zero if this > other; 0 if this == other.
   * @stable ICU 67
   */
  int32_t compare(StringPiece other);

/**
   * Maximum integer, used as a default value for substring methods.
   * @stable ICU 4.2
   */
  static const int32_t npos; // = 0x7fffffff;

/**
   * Returns a substring of this StringPiece.
   * @param pos start position; must be non-negative and <= length().
   * @param len length of the substring;
   *            must be non-negative and will be pinned to at most length() - pos.
   * @return the substring StringPiece
   * @stable ICU 4.2
   */
  StringPiece substr(int32_t pos, int32_t len = npos) const {
    return StringPiece(*this, pos, len);
  }
};

/**
 * Global operator == for StringPiece
 * @param x The first StringPiece to compare.
 * @param y The second StringPiece to compare.
 * @return true if the string data is equal
 * @stable ICU 4.8
 */
U_EXPORT UBool U_EXPORT2 
operator==(const StringPiece& x, const StringPiece& y);

/**
 * Global operator != for StringPiece
 * @param x The first StringPiece to compare.
 * @param y The second StringPiece to compare.
 * @return true if the string data is not equal
 * @stable ICU 4.8
 */
inline UBool operator!=(const StringPiece& x, const StringPiece& y) {
  return !(x == y);
}

U_NAMESPACE_END

#endif /* U_SHOW_CPLUSPLUS_API */

#endif  // __STRINGPIECE_H__