2 * Copyright 2013 Facebook, Inc.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
17 // @author Kristina Holst (kholst@fb.com)
18 // @author Andrei Alexandrescu (andrei.alexandrescu@fb.com)
20 #include "folly/Range.h"
26 #include <boost/range/concepts.hpp>
27 #include <gtest/gtest.h>
29 namespace folly { namespace detail {
31 // declaration of functions in Range.cpp
32 size_t qfind_first_byte_of_memchr(const StringPiece& haystack,
33 const StringPiece& needles);
35 size_t qfind_first_byte_of_byteset(const StringPiece& haystack,
36 const StringPiece& needles);
40 using namespace folly;
43 BOOST_CONCEPT_ASSERT((boost::RandomAccessRangeConcept<StringPiece>));
45 TEST(StringPiece, All) {
46 const char* foo = "foo";
47 const char* foo2 = "foo";
51 // we expect the compiler to optimize things so that there's only one copy
52 // of the string literal "foo", even though we've got it in multiple places
53 EXPECT_EQ(foo, foo2); // remember, this uses ==, not strcmp, so it's a ptr
54 // comparison rather than lexical
56 // the string object creates copies though, so the c_str of these should be
58 EXPECT_NE(fooStr.c_str(), foo2Str.c_str());
60 // test the basic StringPiece functionality
62 EXPECT_EQ(s.size(), 3);
64 EXPECT_EQ(s.start(), foo); // ptr comparison
65 EXPECT_NE(s.start(), fooStr.c_str()); // ptr comparison
66 EXPECT_NE(s.start(), foo2Str.c_str()); // ptr comparison
68 EXPECT_EQ(s.toString(), foo); // lexical comparison
69 EXPECT_EQ(s.toString(), fooStr.c_str()); // lexical comparison
70 EXPECT_EQ(s.toString(), foo2Str.c_str()); // lexical comparison
72 EXPECT_EQ(s, foo); // lexical comparison
73 EXPECT_EQ(s, fooStr); // lexical comparison
74 EXPECT_EQ(s, foo2Str); // lexical comparison
77 // check using StringPiece to reference substrings
78 const char* foobarbaz = "foobarbaz";
80 // the full "foobarbaz"
81 s.reset(foobarbaz, strlen(foobarbaz));
82 EXPECT_EQ(s.size(), 9);
83 EXPECT_EQ(s.start(), foobarbaz);
84 EXPECT_EQ(s, "foobarbaz");
87 s.assign(foobarbaz, foobarbaz + 3);
88 EXPECT_EQ(s.size(), 3);
89 EXPECT_EQ(s.start(), foobarbaz);
93 s.reset(foobarbaz, strlen(foobarbaz));
94 EXPECT_EQ(s.find("bar"), 3);
95 EXPECT_EQ(s.find("ba", 3), 3);
96 EXPECT_EQ(s.find("ba", 4), 6);
97 EXPECT_EQ(s.find("notfound"), StringPiece::npos);
98 EXPECT_EQ(s.find("notfound", 1), StringPiece::npos);
99 EXPECT_EQ(s.find("bar", 4), StringPiece::npos); // starting position too far
100 // starting pos that is obviously past the end -- This works for std::string
101 EXPECT_EQ(s.toString().find("notfound", 55), StringPiece::npos);
102 EXPECT_EQ(s.find("z", s.size()), StringPiece::npos);
103 EXPECT_EQ(s.find("z", 55), StringPiece::npos);
105 EXPECT_EQ(s.find(""), std::string().find(""));
106 EXPECT_EQ(s.find(""), 0);
109 EXPECT_EQ(s.find('b'), 3);
110 EXPECT_EQ(s.find('b', 3), 3);
111 EXPECT_EQ(s.find('b', 4), 6);
112 EXPECT_EQ(s.find('o', 2), 2);
113 EXPECT_EQ(s.find('y'), StringPiece::npos);
114 EXPECT_EQ(s.find('y', 1), StringPiece::npos);
115 EXPECT_EQ(s.find('o', 4), StringPiece::npos); // starting position too far
116 // starting pos that is obviously past the end -- This works for std::string
117 EXPECT_EQ(s.toString().find('y', 55), StringPiece::npos);
118 EXPECT_EQ(s.find('z', s.size()), StringPiece::npos);
119 EXPECT_EQ(s.find('z', 55), StringPiece::npos);
121 EXPECT_EQ(s.find('\0'), std::string().find('\0'));
122 EXPECT_EQ(s.find('\0'), StringPiece::npos);
125 s.reset(foobarbaz, strlen(foobarbaz));
126 EXPECT_EQ(s.find_first_of("bar"), 3);
127 EXPECT_EQ(s.find_first_of("ba", 3), 3);
128 EXPECT_EQ(s.find_first_of("ba", 4), 4);
129 EXPECT_EQ(s.find_first_of("xyxy"), StringPiece::npos);
130 EXPECT_EQ(s.find_first_of("xyxy", 1), StringPiece::npos);
131 // starting position too far
132 EXPECT_EQ(s.find_first_of("foo", 4), StringPiece::npos);
133 // starting pos that is obviously past the end -- This works for std::string
134 EXPECT_EQ(s.toString().find_first_of("xyxy", 55), StringPiece::npos);
135 EXPECT_EQ(s.find_first_of("z", s.size()), StringPiece::npos);
136 EXPECT_EQ(s.find_first_of("z", 55), StringPiece::npos);
137 // empty needle. Note that this returns npos, while find() returns 0!
138 EXPECT_EQ(s.find_first_of(""), std::string().find_first_of(""));
139 EXPECT_EQ(s.find_first_of(""), StringPiece::npos);
141 // single char find_first_ofs
142 EXPECT_EQ(s.find_first_of('b'), 3);
143 EXPECT_EQ(s.find_first_of('b', 3), 3);
144 EXPECT_EQ(s.find_first_of('b', 4), 6);
145 EXPECT_EQ(s.find_first_of('o', 2), 2);
146 EXPECT_EQ(s.find_first_of('y'), StringPiece::npos);
147 EXPECT_EQ(s.find_first_of('y', 1), StringPiece::npos);
148 // starting position too far
149 EXPECT_EQ(s.find_first_of('o', 4), StringPiece::npos);
150 // starting pos that is obviously past the end -- This works for std::string
151 EXPECT_EQ(s.toString().find_first_of('y', 55), StringPiece::npos);
152 EXPECT_EQ(s.find_first_of('z', s.size()), StringPiece::npos);
153 EXPECT_EQ(s.find_first_of('z', 55), StringPiece::npos);
155 EXPECT_EQ(s.find_first_of('\0'), std::string().find_first_of('\0'));
156 EXPECT_EQ(s.find_first_of('\0'), StringPiece::npos);
159 s.reset(foobarbaz + 3, strlen(foobarbaz + 3));
160 EXPECT_EQ(s.size(), 6);
161 EXPECT_EQ(s.start(), foobarbaz + 3);
162 EXPECT_EQ(s, "barbaz");
165 s.reset(foobarbaz + 3, 3);
166 EXPECT_EQ(s.size(), 3);
171 EXPECT_EQ(s.toString(), "");
173 // test an empty StringPiece
175 EXPECT_EQ(s2.size(), 0);
177 // Test comparison operators
211 void expectLT(const T& a, const T& b) {
214 EXPECT_FALSE(a == b);
215 EXPECT_FALSE(a >= b);
219 EXPECT_FALSE(b <= a);
225 void expectEQ(const T& a, const T& b) {
233 TEST(StringPiece, EightBitComparisons) {
234 char values[] = {'\x00', '\x20', '\x40', '\x7f', '\x80', '\xc0', '\xff'};
235 constexpr size_t count = sizeof(values) / sizeof(values[0]);
236 for (size_t i = 0; i < count; ++i) {
237 std::string a(1, values[i]);
238 // Defeat copy-on-write
239 std::string aCopy(a.data(), a.size());
241 expectEQ(StringPiece(a), StringPiece(aCopy));
243 for (size_t j = i + 1; j < count; ++j) {
244 std::string b(1, values[j]);
246 expectLT(StringPiece(a), StringPiece(b));
251 TEST(StringPiece, ToByteRange) {
252 StringPiece a("hello");
254 EXPECT_EQ(static_cast<const void*>(a.begin()),
255 static_cast<const void*>(b.begin()));
256 EXPECT_EQ(static_cast<const void*>(a.end()),
257 static_cast<const void*>(b.end()));
259 // and convert back again
261 EXPECT_EQ(a.begin(), c.begin());
262 EXPECT_EQ(a.end(), c.end());
265 TEST(StringPiece, InvalidRange) {
266 StringPiece a("hello");
267 EXPECT_EQ(a, a.subpiece(0, 10));
268 EXPECT_EQ(StringPiece("ello"), a.subpiece(1));
269 EXPECT_EQ(StringPiece("ello"), a.subpiece(1, std::string::npos));
270 EXPECT_EQ(StringPiece("ell"), a.subpiece(1, 3));
271 EXPECT_THROW(a.subpiece(6, 7), std::out_of_range);
272 EXPECT_THROW(a.subpiece(6), std::out_of_range);
274 std::string b("hello");
275 EXPECT_EQ(a, StringPiece(b, 0, 10));
276 EXPECT_EQ("ello", a.subpiece(1));
277 EXPECT_EQ("ello", a.subpiece(1, std::string::npos));
278 EXPECT_EQ("ell", a.subpiece(1, 3));
279 EXPECT_THROW(a.subpiece(6, 7), std::out_of_range);
280 EXPECT_THROW(a.subpiece(6), std::out_of_range);
283 template <typename NeedleFinder>
284 class NeedleFinderTest : public ::testing::Test {
286 static size_t find_first_byte_of(StringPiece haystack, StringPiece needles) {
287 return NeedleFinder::find_first_byte_of(haystack, needles);
291 struct SseNeedleFinder {
292 static size_t find_first_byte_of(StringPiece haystack, StringPiece needles) {
293 // This will only use the SSE version if it is supported on this CPU
294 // (selected using ifunc).
295 return detail::qfind_first_byte_of(haystack, needles);
299 struct NoSseNeedleFinder {
300 static size_t find_first_byte_of(StringPiece haystack, StringPiece needles) {
301 return detail::qfind_first_byte_of_nosse(haystack, needles);
305 struct MemchrNeedleFinder {
306 static size_t find_first_byte_of(StringPiece haystack, StringPiece needles) {
307 return detail::qfind_first_byte_of_memchr(haystack, needles);
311 struct ByteSetNeedleFinder {
312 static size_t find_first_byte_of(StringPiece haystack, StringPiece needles) {
313 return detail::qfind_first_byte_of_byteset(haystack, needles);
317 typedef ::testing::Types<SseNeedleFinder, NoSseNeedleFinder, MemchrNeedleFinder,
318 ByteSetNeedleFinder> NeedleFinders;
319 TYPED_TEST_CASE(NeedleFinderTest, NeedleFinders);
321 TYPED_TEST(NeedleFinderTest, Null) {
322 { // null characters in the string
323 string s(10, char(0));
325 string delims("abc");
326 EXPECT_EQ(5, this->find_first_byte_of(s, delims));
328 { // null characters in delim
330 string delims(10, char(0));
333 EXPECT_EQ(1, this->find_first_byte_of(s, delims));
335 { // range not terminated by null character
336 string buf = "abcdefghijklmnopqrstuvwxyz";
337 StringPiece s(buf.data() + 5, 3);
338 StringPiece delims("z");
339 EXPECT_EQ(string::npos, this->find_first_byte_of(s, delims));
343 TYPED_TEST(NeedleFinderTest, DelimDuplicates) {
344 string delims(1000, 'b');
345 EXPECT_EQ(1, this->find_first_byte_of("abc", delims));
346 EXPECT_EQ(string::npos, this->find_first_byte_of("ac", delims));
349 TYPED_TEST(NeedleFinderTest, Empty) {
352 EXPECT_EQ(string::npos, this->find_first_byte_of(a, b));
353 EXPECT_EQ(string::npos, this->find_first_byte_of(b, a));
354 EXPECT_EQ(string::npos, this->find_first_byte_of(b, b));
357 TYPED_TEST(NeedleFinderTest, Unaligned) {
358 // works correctly even if input buffers are not 16-byte aligned
359 string s = "0123456789ABCDEFGH";
360 for (int i = 0; i < s.size(); ++i) {
361 StringPiece a(s.c_str() + i);
362 for (int j = 0; j < s.size(); ++j) {
363 StringPiece b(s.c_str() + j);
364 EXPECT_EQ((i > j) ? 0 : j - i, this->find_first_byte_of(a, b));
369 // for some algorithms (specifically those that create a set of needles),
370 // we check for the edge-case of _all_ possible needles being sought.
371 TYPED_TEST(NeedleFinderTest, Needles256) {
373 const auto minValue = std::numeric_limits<StringPiece::value_type>::min();
374 const auto maxValue = std::numeric_limits<StringPiece::value_type>::max();
375 // make the size ~big to avoid any edge-case branches for tiny haystacks
376 const int haystackSize = 50;
377 for (int i = minValue; i <= maxValue; i++) { // <=
378 needles.push_back(i);
380 EXPECT_EQ(StringPiece::npos, this->find_first_byte_of("", needles));
381 for (int i = minValue; i <= maxValue; i++) {
382 EXPECT_EQ(0, this->find_first_byte_of(string(haystackSize, i), needles));
385 needles.append("these are redundant characters");
386 EXPECT_EQ(StringPiece::npos, this->find_first_byte_of("", needles));
387 for (int i = minValue; i <= maxValue; i++) {
388 EXPECT_EQ(0, this->find_first_byte_of(string(haystackSize, i), needles));
392 TYPED_TEST(NeedleFinderTest, Base) {
393 for (int i = 0; i < 32; ++i) {
394 for (int j = 0; j < 32; ++j) {
395 string s = string(i, 'X') + "abca" + string(i, 'X');
396 string delims = string(j, 'Y') + "a" + string(j, 'Y');
397 EXPECT_EQ(i, this->find_first_byte_of(s, delims));
402 const size_t kPageSize = 4096;
403 // Updates contents so that any read accesses past the last byte will
404 // cause a SIGSEGV. It accomplishes this by changing access to the page that
405 // begins immediately after the end of the contents (as allocators and mmap()
406 // all operate on page boundaries, this is a reasonable assumption).
407 // This function will also initialize buf, which caller must free().
408 void createProtectedBuf(StringPiece& contents, char** buf) {
409 ASSERT_LE(contents.size(), kPageSize);
410 const size_t kSuccess = 0;
412 if (kSuccess != posix_memalign((void**)buf, kPageSize, 2 * kPageSize)) {
415 mprotect(*buf + kPageSize, kPageSize, PROT_NONE);
416 size_t newBegin = kPageSize - contents.size();
417 memcpy(*buf + newBegin, contents.data(), contents.size());
418 contents.reset(*buf + newBegin, contents.size());
421 TYPED_TEST(NeedleFinderTest, NoSegFault) {
422 const string base = string(32, 'a') + string("b");
423 const string delims = string(32, 'c') + string("b");
424 for (int i = 0; i <= 32; i++) {
425 for (int j = 0; j <= 33; j++) {
426 for (int shouldFind = 0; shouldFind <= 1; ++shouldFind) {
427 StringPiece s1(base);
429 ASSERT_TRUE(!s1.empty());
433 StringPiece s2(delims);
437 createProtectedBuf(s1, &buf1);
438 createProtectedBuf(s2, &buf2);
439 // printf("s1: '%s' (%ld) \ts2: '%s' (%ld)\n",
440 // string(s1.data(), s1.size()).c_str(), s1.size(),
441 // string(s2.data(), s2.size()).c_str(), s2.size());
442 auto r1 = this->find_first_byte_of(s1, s2);
443 auto f1 = std::find_first_of(s1.begin(), s1.end(),
444 s2.begin(), s2.end());
445 auto e1 = (f1 == s1.end()) ? StringPiece::npos : f1 - s1.begin();
447 auto r2 = this->find_first_byte_of(s2, s1);
448 auto f2 = std::find_first_of(s2.begin(), s2.end(),
449 s1.begin(), s1.end());
450 auto e2 = (f2 == s2.end()) ? StringPiece::npos : f2 - s2.begin();