/*
* Copyright (C) 2015 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef AAPT_UTIL_H
#define AAPT_UTIL_H
#include "util/BigBuffer.h"
#include "util/Maybe.h"
#include "util/StringPiece.h"
#include <androidfw/ResourceTypes.h>
#include <functional>
#include <memory>
#include <ostream>
#include <string>
#include <vector>
namespace aapt {
namespace util {
std::vector<std::string> split(const StringPiece& str, char sep);
std::vector<std::string> splitAndLowercase(const StringPiece& str, char sep);
/**
* Returns true if the string starts with prefix.
*/
template <typename T>
bool stringStartsWith(const BasicStringPiece<T>& str, const BasicStringPiece<T>& prefix) {
if (str.size() < prefix.size()) {
return false;
}
return str.substr(0, prefix.size()) == prefix;
}
/**
* Returns true if the string ends with suffix.
*/
template <typename T>
bool stringEndsWith(const BasicStringPiece<T>& str, const BasicStringPiece<T>& suffix) {
if (str.size() < suffix.size()) {
return false;
}
return str.substr(str.size() - suffix.size(), suffix.size()) == suffix;
}
/**
* Creates a new StringPiece16 that points to a substring
* of the original string without leading or trailing whitespace.
*/
StringPiece16 trimWhitespace(const StringPiece16& str);
StringPiece trimWhitespace(const StringPiece& str);
/**
* UTF-16 isspace(). It basically checks for lower range characters that are
* whitespace.
*/
inline bool isspace16(char16_t c) {
return c < 0x0080 && isspace(c);
}
/**
* Returns an iterator to the first character that is not alpha-numeric and that
* is not in the allowedChars set.
*/
StringPiece16::const_iterator findNonAlphaNumericAndNotInSet(const StringPiece16& str,
const StringPiece16& allowedChars);
/**
* Tests that the string is a valid Java class name.
*/
bool isJavaClassName(const StringPiece16& str);
/**
* Tests that the string is a valid Java package name.
*/
bool isJavaPackageName(const StringPiece16& str);
/**
* Converts the class name to a fully qualified class name from the given `package`. Ex:
*
* asdf --> package.asdf
* .asdf --> package.asdf
* .a.b --> package.a.b
* asdf.adsf --> asdf.adsf
*/
Maybe<std::u16string> getFullyQualifiedClassName(const StringPiece16& package,
const StringPiece16& className);
/**
* Makes a std::unique_ptr<> with the template parameter inferred by the compiler.
* This will be present in C++14 and can be removed then.
*/
template <typename T, class... Args>
std::unique_ptr<T> make_unique(Args&&... args) {
return std::unique_ptr<T>(new T{std::forward<Args>(args)...});
}
/**
* Writes a set of items to the std::ostream, joining the times with the provided
* separator.
*/
template <typename Iterator>
::std::function<::std::ostream&(::std::ostream&)> joiner(Iterator begin, Iterator end,
const char* sep) {
return [begin, end, sep](::std::ostream& out) -> ::std::ostream& {
for (auto iter = begin; iter != end; ++iter) {
if (iter != begin) {
out << sep;
}
out << *iter;
}
return out;
};
}
inline ::std::function<::std::ostream&(::std::ostream&)> formatSize(size_t size) {
return [size](::std::ostream& out) -> ::std::ostream& {
constexpr size_t K = 1024u;
constexpr size_t M = K * K;
constexpr size_t G = M * K;
if (size < K) {
out << size << "B";
} else if (size < M) {
out << (double(size) / K) << " KiB";
} else if (size < G) {
out << (double(size) / M) << " MiB";
} else {
out << (double(size) / G) << " GiB";
}
return out;
};
}
/**
* Helper method to extract a string from a StringPool.
*/
inline StringPiece16 getString(const android::ResStringPool& pool, size_t idx) {
size_t len;
const char16_t* str = pool.stringAt(idx, &len);
if (str != nullptr) {
return StringPiece16(str, len);
}
return StringPiece16();
}
inline StringPiece getString8(const android::ResStringPool& pool, size_t idx) {
size_t len;
const char* str = pool.string8At(idx, &len);
if (str != nullptr) {
return StringPiece(str, len);
}
return StringPiece();
}
/**
* Checks that the Java string format contains no non-positional arguments (arguments without
* explicitly specifying an index) when there are more than one argument. This is an error
* because translations may rearrange the order of the arguments in the string, which will
* break the string interpolation.
*/
bool verifyJavaStringFormat(const StringPiece16& str);
class StringBuilder {
public:
StringBuilder& append(const StringPiece16& str);
const std::u16string& str() const;
const std::string& error() const;
operator bool() const;
private:
std::u16string mStr;
bool mQuote = false;
bool mTrailingSpace = false;
bool mLastCharWasEscape = false;
std::string mError;
};
inline const std::u16string& StringBuilder::str() const {
return mStr;
}
inline const std::string& StringBuilder::error() const {
return mError;
}
inline StringBuilder::operator bool() const {
return mError.empty();
}
/**
* Converts a UTF8 string to a UTF16 string.
*/
std::u16string utf8ToUtf16(const StringPiece& utf8);
std::string utf16ToUtf8(const StringPiece16& utf8);
/**
* Writes the entire BigBuffer to the output stream.
*/
bool writeAll(std::ostream& out, const BigBuffer& buffer);
/*
* Copies the entire BigBuffer into a single buffer.
*/
std::unique_ptr<uint8_t[]> copy(const BigBuffer& buffer);
/**
* A Tokenizer implemented as an iterable collection. It does not allocate
* any memory on the heap nor use standard containers.
*/
template <typename Char>
class Tokenizer {
public:
class iterator {
public:
iterator(const iterator&) = default;
iterator& operator=(const iterator&) = default;
iterator& operator++();
BasicStringPiece<Char> operator*();
bool operator==(const iterator& rhs) const;
bool operator!=(const iterator& rhs) const;
private:
friend class Tokenizer<Char>;
iterator(BasicStringPiece<Char> s, Char sep, BasicStringPiece<Char> tok, bool end);
BasicStringPiece<Char> mStr;
Char mSeparator;
BasicStringPiece<Char> mToken;
bool mEnd;
};
Tokenizer(BasicStringPiece<Char> str, Char sep);
iterator begin();
iterator end();
private:
const iterator mBegin;
const iterator mEnd;
};
template <typename Char>
inline Tokenizer<Char> tokenize(BasicStringPiece<Char> str, Char sep) {
return Tokenizer<Char>(str, sep);
}
template <typename Char>
typename Tokenizer<Char>::iterator& Tokenizer<Char>::iterator::operator++() {
const Char* start = mToken.end();
const Char* end = mStr.end();
if (start == end) {
mEnd = true;
mToken.assign(mToken.end(), 0);
return *this;
}
start += 1;
const Char* current = start;
while (current != end) {
if (*current == mSeparator) {
mToken.assign(start, current - start);
return *this;
}
++current;
}
mToken.assign(start, end - start);
return *this;
}
template <typename Char>
inline BasicStringPiece<Char> Tokenizer<Char>::iterator::operator*() {
return mToken;
}
template <typename Char>
inline bool Tokenizer<Char>::iterator::operator==(const iterator& rhs) const {
// We check equality here a bit differently.
// We need to know that the addresses are the same.
return mToken.begin() == rhs.mToken.begin() && mToken.end() == rhs.mToken.end() &&
mEnd == rhs.mEnd;
}
template <typename Char>
inline bool Tokenizer<Char>::iterator::operator!=(const iterator& rhs) const {
return !(*this == rhs);
}
template <typename Char>
inline Tokenizer<Char>::iterator::iterator(BasicStringPiece<Char> s, Char sep,
BasicStringPiece<Char> tok, bool end) :
mStr(s), mSeparator(sep), mToken(tok), mEnd(end) {
}
template <typename Char>
inline typename Tokenizer<Char>::iterator Tokenizer<Char>::begin() {
return mBegin;
}
template <typename Char>
inline typename Tokenizer<Char>::iterator Tokenizer<Char>::end() {
return mEnd;
}
template <typename Char>
inline Tokenizer<Char>::Tokenizer(BasicStringPiece<Char> str, Char sep) :
mBegin(++iterator(str, sep, BasicStringPiece<Char>(str.begin() - 1, 0), false)),
mEnd(str, sep, BasicStringPiece<Char>(str.end(), 0), true) {
}
inline uint16_t hostToDevice16(uint16_t value) {
return htods(value);
}
inline uint32_t hostToDevice32(uint32_t value) {
return htodl(value);
}
inline uint16_t deviceToHost16(uint16_t value) {
return dtohs(value);
}
inline uint32_t deviceToHost32(uint32_t value) {
return dtohl(value);
}
/**
* Given a path like: res/xml-sw600dp/foo.xml
*
* Extracts "res/xml-sw600dp/" into outPrefix.
* Extracts "foo" into outEntry.
* Extracts ".xml" into outSuffix.
*
* Returns true if successful.
*/
bool extractResFilePathParts(const StringPiece16& path, StringPiece16* outPrefix,
StringPiece16* outEntry, StringPiece16* outSuffix);
} // namespace util
/**
* Stream operator for functions. Calls the function with the stream as an argument.
* In the aapt namespace for lookup.
*/
inline ::std::ostream& operator<<(::std::ostream& out,
::std::function<::std::ostream&(::std::ostream&)> f) {
return f(out);
}
} // namespace aapt
#endif // AAPT_UTIL_H