ab2621d3e2
- make descriptions of table entries phrases instead of sentences; lower case start, no ending period (not enforced, yet) - add #Line markup to move one line descriptions to the #Method body. Later, will generate tables like Member_Functions from this - add #In markup to associate a #Method with a #Subtopic. Later, will generate tables of related methods from this - remove return type from operator overloads in tables - add new colorTypes to examples that index into arrays of strings to name them Docs-Preview: https://skia.org/?cl=100422 TBR=caryclark@google.com Bug: skia:6898 Change-Id: I8558048866369f419f1944832b99c05da3fd52bb Reviewed-on: https://skia-review.googlesource.com/100422 Reviewed-by: Cary Clark <caryclark@skia.org> Commit-Queue: Cary Clark <caryclark@skia.org>
1296 lines
46 KiB
C++
1296 lines
46 KiB
C++
/*
|
|
* Copyright 2017 Google Inc.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
|
|
#include "bookmaker.h"
|
|
#include "SkOSPath.h"
|
|
|
|
static size_t count_indent(const string& text, size_t test, size_t end) {
|
|
size_t result = test;
|
|
while (test < end) {
|
|
if (' ' != text[test]) {
|
|
break;
|
|
}
|
|
++test;
|
|
}
|
|
return test - result;
|
|
}
|
|
|
|
static void add_code(const string& text, int pos, int end,
|
|
size_t outIndent, size_t textIndent, string& example) {
|
|
do {
|
|
// fix this to move whole paragraph in, out, but preserve doc indent
|
|
int nextIndent = count_indent(text, pos, end);
|
|
size_t len = text.find('\n', pos);
|
|
if (string::npos == len) {
|
|
len = end;
|
|
}
|
|
if ((size_t) (pos + nextIndent) < len) {
|
|
size_t indent = outIndent + nextIndent;
|
|
SkASSERT(indent >= textIndent);
|
|
indent -= textIndent;
|
|
for (size_t index = 0; index < indent; ++index) {
|
|
example += ' ';
|
|
}
|
|
pos += nextIndent;
|
|
while ((size_t) pos < len) {
|
|
example += '"' == text[pos] ? "\\\"" :
|
|
'\\' == text[pos] ? "\\\\" :
|
|
text.substr(pos, 1);
|
|
++pos;
|
|
}
|
|
example += "\\n";
|
|
} else {
|
|
pos += nextIndent;
|
|
}
|
|
if ('\n' == text[pos]) {
|
|
++pos;
|
|
}
|
|
} while (pos < end);
|
|
}
|
|
|
|
#ifdef CONST
|
|
#undef CONST
|
|
#endif
|
|
|
|
#ifdef FRIEND
|
|
#undef FRIEND
|
|
#endif
|
|
|
|
#ifdef BLANK
|
|
#undef BLANK
|
|
#endif
|
|
|
|
#ifdef ANY
|
|
#undef ANY
|
|
#endif
|
|
|
|
#ifdef DEFOP
|
|
#undef DEFOP
|
|
#endif
|
|
|
|
#define CONST 1
|
|
#define STATIC 2
|
|
#define BLANK 0
|
|
#define ANY -1
|
|
#define DEFOP Definition::Operator
|
|
|
|
enum class OpType : int8_t {
|
|
kNone,
|
|
kVoid,
|
|
kBool,
|
|
kChar,
|
|
kFloat,
|
|
kInt,
|
|
kScalar,
|
|
kSizeT,
|
|
kThis,
|
|
kAny,
|
|
};
|
|
|
|
enum class OpMod : int8_t {
|
|
kNone,
|
|
kArray,
|
|
kMove,
|
|
kPointer,
|
|
kReference,
|
|
kAny,
|
|
};
|
|
|
|
const struct OperatorParser {
|
|
DEFOP fOperator;
|
|
const char* fSymbol;
|
|
const char* fName;
|
|
int8_t fFriend;
|
|
OpType fReturnType;
|
|
OpMod fReturnMod;
|
|
int8_t fConstMethod;
|
|
struct Param {
|
|
int8_t fConst;
|
|
OpType fType;
|
|
OpMod fMod;
|
|
} fParams[2];
|
|
} opData[] = {
|
|
{ DEFOP::kUnknown, "??", "???", BLANK, OpType::kNone, OpMod::kNone, BLANK,
|
|
{ } },
|
|
{ DEFOP::kAdd, "+", "add", BLANK, OpType::kThis, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kAddTo, "+=", "addto", BLANK, OpType::kVoid, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kAddTo, "+=", "addto1", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kAddTo, "+=", "addto2", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ CONST, OpType::kChar, OpMod::kArray, }}},
|
|
{ DEFOP::kAddTo, "+=", "addto3", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ CONST, OpType::kChar, OpMod::kNone, }}},
|
|
{ DEFOP::kArray, "[]", "array", BLANK, OpType::kScalar, OpMod::kNone, CONST,
|
|
{{ BLANK, OpType::kInt, OpMod::kNone, }}},
|
|
{ DEFOP::kArray, "[]", "array1", BLANK, OpType::kScalar, OpMod::kReference, BLANK,
|
|
{{ BLANK, OpType::kInt, OpMod::kNone, }}},
|
|
{ DEFOP::kArray, "[]", "array2", BLANK, OpType::kChar, OpMod::kNone, CONST,
|
|
{{ BLANK, OpType::kSizeT, OpMod::kNone, }}},
|
|
{ DEFOP::kArray, "[]", "array3", BLANK, OpType::kChar, OpMod::kReference, BLANK,
|
|
{{ BLANK, OpType::kSizeT, OpMod::kNone, }}},
|
|
{ DEFOP::kCast, "()", "cast", BLANK, OpType::kAny, OpMod::kAny, ANY,
|
|
{{ ANY, OpType::kAny, OpMod::kAny, }}},
|
|
{ DEFOP::kCopy, "=", "copy", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kCopy, "=", "copy1", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ CONST, OpType::kChar, OpMod::kArray, }}},
|
|
{ DEFOP::kDelete, "delete", "delete", BLANK, OpType::kVoid, OpMod::kNone, BLANK,
|
|
{{ BLANK, OpType::kVoid, OpMod::kPointer, }}},
|
|
{ DEFOP::kDereference, "->", "deref", ANY, OpType::kThis, OpMod::kPointer, CONST,
|
|
{ } },
|
|
{ DEFOP::kDereference, "*", "deref", BLANK, OpType::kThis, OpMod::kReference, CONST,
|
|
{ } },
|
|
{ DEFOP::kEqual, "==", "equal", BLANK, OpType::kBool, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kEqual, "==", "equal1", BLANK, OpType::kBool, OpMod::kNone, CONST,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kEqual, "==", "equal2", ANY, OpType::kBool, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kMinus, "-", "minus", BLANK, OpType::kThis, OpMod::kNone, CONST,
|
|
{ } },
|
|
{ DEFOP::kMove, "=", "move", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ BLANK, OpType::kThis, OpMod::kMove, }}},
|
|
{ DEFOP::kMultiply, "*", "multiply", BLANK, OpType::kThis, OpMod::kNone, CONST,
|
|
{{ BLANK, OpType::kScalar, OpMod::kNone, }}},
|
|
{ DEFOP::kMultiply, "*", "multiply1", BLANK, OpType::kThis, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kMultiplyBy, "*=", "multiplyby", BLANK, OpType::kThis, OpMod::kReference, BLANK,
|
|
{{ BLANK, OpType::kScalar, OpMod::kNone, }}},
|
|
{ DEFOP::kNew, "new", "new", BLANK, OpType::kVoid, OpMod::kPointer, BLANK,
|
|
{{ BLANK, OpType::kSizeT, OpMod::kNone, }}},
|
|
{ DEFOP::kNotEqual, "!=", "notequal", BLANK, OpType::kBool, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kNotEqual, "!=", "notequal1", BLANK, OpType::kBool, OpMod::kNone, CONST,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kNotEqual, "!=", "notequal2", ANY, OpType::kBool, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kSubtract, "-", "subtract", BLANK, OpType::kThis, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, },
|
|
{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
{ DEFOP::kSubtractFrom, "-=", "subtractfrom", BLANK, OpType::kVoid, OpMod::kNone, BLANK,
|
|
{{ CONST, OpType::kThis, OpMod::kReference, }}},
|
|
};
|
|
|
|
OpType lookup_type(const string& typeWord, const string& name) {
|
|
if (typeWord == name || (typeWord == "SkIVector" && name == "SkIPoint")
|
|
|| (typeWord == "SkVector" && name == "SkPoint")) {
|
|
return OpType::kThis;
|
|
}
|
|
const char* keyWords[] = { "void", "bool", "char", "float", "int", "SkScalar", "size_t" };
|
|
for (unsigned i = 0; i < SK_ARRAY_COUNT(keyWords); ++i) {
|
|
if (typeWord == keyWords[i]) {
|
|
return (OpType) (i + 1);
|
|
}
|
|
}
|
|
return OpType::kNone;
|
|
}
|
|
|
|
OpMod lookup_mod(TextParser& iParser) {
|
|
OpMod mod = OpMod::kNone;
|
|
if ('&' == iParser.peek()) {
|
|
mod = OpMod::kReference;
|
|
iParser.next();
|
|
if ('&' == iParser.peek()) {
|
|
mod = OpMod::kMove;
|
|
iParser.next();
|
|
}
|
|
} else if ('*' == iParser.peek()) {
|
|
mod = OpMod::kPointer;
|
|
iParser.next();
|
|
}
|
|
iParser.skipWhiteSpace();
|
|
return mod;
|
|
}
|
|
|
|
bool Definition::parseOperator(size_t doubleColons, string& result) {
|
|
const char operatorStr[] = "operator";
|
|
size_t opPos = fName.find(operatorStr, doubleColons);
|
|
if (string::npos == opPos) {
|
|
return false;
|
|
}
|
|
string className(fName, 0, doubleColons - 2);
|
|
TextParser iParser(fFileName, fStart, fContentStart, fLineCount);
|
|
SkAssertResult(iParser.skipWord("#Method"));
|
|
iParser.skipExact("SK_API");
|
|
iParser.skipWhiteSpace();
|
|
bool isStatic = iParser.skipExact("static");
|
|
iParser.skipWhiteSpace();
|
|
iParser.skipExact("SK_API");
|
|
iParser.skipWhiteSpace();
|
|
bool returnsConst = iParser.skipExact("const");
|
|
if (returnsConst) {
|
|
SkASSERT(0); // incomplete
|
|
}
|
|
SkASSERT(isStatic == false || returnsConst == false);
|
|
iParser.skipWhiteSpace();
|
|
const char* returnTypeStart = iParser.fChar;
|
|
iParser.skipToNonAlphaNum();
|
|
SkASSERT(iParser.fChar > returnTypeStart);
|
|
string returnType(returnTypeStart, iParser.fChar - returnTypeStart);
|
|
OpType returnOpType = lookup_type(returnType, className);
|
|
iParser.skipWhiteSpace();
|
|
OpMod returnMod = lookup_mod(iParser);
|
|
SkAssertResult(iParser.skipExact("operator"));
|
|
iParser.skipWhiteSpace();
|
|
fMethodType = Definition::MethodType::kOperator;
|
|
TextParser::Save save(&iParser);
|
|
for (auto parser : opData) {
|
|
save.restore();
|
|
if (!iParser.skipExact(parser.fSymbol)) {
|
|
continue;
|
|
}
|
|
iParser.skipWhiteSpace();
|
|
if ('(' != iParser.peek()) {
|
|
continue;
|
|
}
|
|
if (parser.fFriend != ANY && (parser.fFriend == STATIC) != isStatic) {
|
|
continue;
|
|
}
|
|
if (parser.fReturnType != OpType::kAny && parser.fReturnType != returnOpType) {
|
|
continue;
|
|
}
|
|
if (parser.fReturnMod != OpMod::kAny && parser.fReturnMod != returnMod) {
|
|
continue;
|
|
}
|
|
iParser.next(); // skip '('
|
|
iParser.skipWhiteSpace();
|
|
int parserCount = (parser.fParams[0].fType != OpType::kNone) +
|
|
(parser.fParams[1].fType != OpType::kNone);
|
|
bool countsMatch = true;
|
|
for (int pIndex = 0; pIndex < 2; ++pIndex) {
|
|
if (')' == iParser.peek()) {
|
|
countsMatch = pIndex == parserCount;
|
|
break;
|
|
}
|
|
if (',' == iParser.peek()) {
|
|
iParser.next();
|
|
iParser.skipWhiteSpace();
|
|
}
|
|
bool paramConst = iParser.skipExact("const");
|
|
if (parser.fParams[pIndex].fConst != ANY &&
|
|
paramConst != (parser.fParams[pIndex].fConst == CONST)) {
|
|
countsMatch = false;
|
|
break;
|
|
}
|
|
iParser.skipWhiteSpace();
|
|
const char* paramStart = iParser.fChar;
|
|
iParser.skipToNonAlphaNum();
|
|
SkASSERT(iParser.fChar > paramStart);
|
|
string paramType(paramStart, iParser.fChar - paramStart);
|
|
OpType paramOpType = lookup_type(paramType, className);
|
|
if (parser.fParams[pIndex].fType != OpType::kAny &&
|
|
parser.fParams[pIndex].fType != paramOpType) {
|
|
countsMatch = false;
|
|
break;
|
|
}
|
|
iParser.skipWhiteSpace();
|
|
OpMod paramMod = lookup_mod(iParser);
|
|
if (parser.fParams[pIndex].fMod != OpMod::kAny &&
|
|
parser.fParams[pIndex].fMod != paramMod) {
|
|
countsMatch = false;
|
|
break;
|
|
}
|
|
iParser.skipToNonAlphaNum();
|
|
if ('[' == iParser.peek()) {
|
|
paramMod = OpMod::kArray;
|
|
SkAssertResult(iParser.skipExact("[]"));
|
|
}
|
|
iParser.skipWhiteSpace();
|
|
}
|
|
if (!countsMatch) {
|
|
continue;
|
|
}
|
|
if (')' != iParser.peek()) {
|
|
continue;
|
|
}
|
|
iParser.next();
|
|
bool constMethod = iParser.skipExact("_const");
|
|
if (parser.fConstMethod != ANY && (parser.fConstMethod == CONST) != constMethod) {
|
|
continue;
|
|
}
|
|
result += parser.fName;
|
|
result += "_operator";
|
|
fOperator = parser.fOperator;
|
|
fOperatorConst = constMethod;
|
|
return true;
|
|
}
|
|
SkASSERT(0); // incomplete
|
|
return false;
|
|
#if 0
|
|
if ('!' == fName[opPos]) {
|
|
SkASSERT('=' == fName[opPos + 1]);
|
|
result += "not_equal_operator";
|
|
} else if ('=' == fName[opPos]) {
|
|
if ('(' == fName[opPos + 1]) {
|
|
result += isMove ? "move_" : "copy_";
|
|
result += "assignment_operator";
|
|
} else {
|
|
SkASSERT('=' == fName[opPos + 1]);
|
|
result += "equal_operator";
|
|
}
|
|
} else if ('[' == fName[opPos]) {
|
|
result += "subscript_operator";
|
|
const char* end = fContentStart;
|
|
while (end > fStart && ' ' >= end[-1]) {
|
|
--end;
|
|
}
|
|
string constCheck(fStart, end - fStart);
|
|
size_t constPos = constCheck.rfind("const");
|
|
if (constCheck.length() == constPos + 5) {
|
|
result += "_const";
|
|
}
|
|
} else if ('*' == fName[opPos]) {
|
|
result += "multiply_operator";
|
|
} else if ('-' == fName[opPos]) {
|
|
result += "subtract_operator";
|
|
} else if ('+' == fName[opPos]) {
|
|
result += "add_operator";
|
|
} else {
|
|
SkASSERT(0); // todo: incomplete
|
|
}
|
|
#endif
|
|
return true;
|
|
}
|
|
|
|
#undef CONST
|
|
#undef FRIEND
|
|
#undef BLANK
|
|
#undef DEFOP
|
|
|
|
bool Definition::boilerplateIfDef(Definition* parent) {
|
|
const Definition& label = fTokens.front();
|
|
if (Type::kWord != label.fType) {
|
|
return false;
|
|
}
|
|
fName = string(label.fContentStart, label.fContentEnd - label.fContentStart);
|
|
return true;
|
|
}
|
|
|
|
// todo: this is matching #ifndef SkXXX_DEFINED for no particular reason
|
|
// it doesn't do anything useful with arbitrary input, e.g. #ifdef SK_SUPPORT_LEGACY_CANVAS_HELPERS
|
|
// also doesn't know what to do with SK_REQUIRE_LOCAL_VAR()
|
|
bool Definition::boilerplateDef(Definition* parent) {
|
|
if (!this->boilerplateIfDef(parent)) {
|
|
return false;
|
|
}
|
|
const char* s = fName.c_str();
|
|
const char* e = strchr(s, '_');
|
|
return true; // fixme: if this is trying to do something useful with define, do it here
|
|
if (!e) {
|
|
return false;
|
|
}
|
|
string prefix(s, e - s);
|
|
const char* inName = strstr(parent->fName.c_str(), prefix.c_str());
|
|
if (!inName) {
|
|
return false;
|
|
}
|
|
if ('/' != inName[-1] && '\\' != inName[-1]) {
|
|
return false;
|
|
}
|
|
if (strcmp(inName + prefix.size(), ".h")) {
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
// fixme: this will need to be more complicated to handle all of Skia
|
|
// for now, just handle paint -- maybe fiddle will loosen naming restrictions
|
|
void Definition::setCanonicalFiddle() {
|
|
fMethodType = Definition::MethodType::kNone;
|
|
size_t doubleColons = fName.find("::", 0);
|
|
SkASSERT(string::npos != doubleColons);
|
|
string base = fName.substr(0, doubleColons);
|
|
string result = base + "_";
|
|
doubleColons += 2;
|
|
if (string::npos != fName.find('~', doubleColons)) {
|
|
fMethodType = Definition::MethodType::kDestructor;
|
|
result += "destructor";
|
|
} else if (!this->parseOperator(doubleColons, result)) {
|
|
bool isMove = string::npos != fName.find("&&", doubleColons);
|
|
size_t parens = fName.find("()", doubleColons);
|
|
if (string::npos != parens) {
|
|
string methodName = fName.substr(doubleColons, parens - doubleColons);
|
|
do {
|
|
size_t nextDouble = methodName.find("::");
|
|
if (string::npos == nextDouble) {
|
|
break;
|
|
}
|
|
base = methodName.substr(0, nextDouble);
|
|
result += base + '_';
|
|
methodName = methodName.substr(nextDouble + 2);
|
|
doubleColons += nextDouble + 2;
|
|
} while (true);
|
|
if (base == methodName) {
|
|
fMethodType = Definition::MethodType::kConstructor;
|
|
result += "empty_constructor";
|
|
} else {
|
|
result += fName.substr(doubleColons, fName.length() - doubleColons - 2);
|
|
}
|
|
} else {
|
|
size_t openParen = fName.find('(', doubleColons);
|
|
if (string::npos == openParen) {
|
|
result += fName.substr(doubleColons);
|
|
} else {
|
|
size_t comma = fName.find(',', doubleColons);
|
|
if (string::npos == comma) {
|
|
result += isMove ? "move_" : "copy_";
|
|
}
|
|
fMethodType = Definition::MethodType::kConstructor;
|
|
// name them by their param types,
|
|
// e.g. SkCanvas__int_int_const_SkSurfaceProps_star
|
|
// TODO: move forward until parens are balanced and terminator =,)
|
|
TextParser params("", &fName[openParen] + 1, &*fName.end(), 0);
|
|
bool underline = false;
|
|
while (!params.eof()) {
|
|
// SkDEBUGCODE(const char* end = params.anyOf("(),=")); // unused for now
|
|
// SkASSERT(end[0] != '('); // fixme: put off handling nested parentheseses
|
|
if (params.startsWith("const") || params.startsWith("int")
|
|
|| params.startsWith("Sk")) {
|
|
const char* wordStart = params.fChar;
|
|
params.skipToNonAlphaNum();
|
|
if (underline) {
|
|
result += '_';
|
|
} else {
|
|
underline = true;
|
|
}
|
|
result += string(wordStart, params.fChar - wordStart);
|
|
} else {
|
|
params.skipToNonAlphaNum();
|
|
}
|
|
if (!params.eof() && '*' == params.peek()) {
|
|
if (underline) {
|
|
result += '_';
|
|
} else {
|
|
underline = true;
|
|
}
|
|
result += "star";
|
|
params.next();
|
|
params.skipSpace();
|
|
}
|
|
params.skipToAlpha();
|
|
}
|
|
}
|
|
}
|
|
}
|
|
fFiddle = Definition::NormalizedName(result);
|
|
}
|
|
|
|
void Definition::setWrapper() {
|
|
const char drawWrapper[] = "void draw(SkCanvas* canvas) {";
|
|
const char drawNoCanvas[] = "void draw(SkCanvas* ) {";
|
|
string text = this->extractText(Definition::TrimExtract::kNo);
|
|
size_t nonSpace = 0;
|
|
while (nonSpace < text.length() && ' ' >= text[nonSpace]) {
|
|
++nonSpace;
|
|
}
|
|
bool hasFunc = !text.compare(nonSpace, sizeof(drawWrapper) - 1, drawWrapper);
|
|
bool noCanvas = !text.compare(nonSpace, sizeof(drawNoCanvas) - 1, drawNoCanvas);
|
|
bool hasCanvas = string::npos != text.find("SkCanvas canvas");
|
|
SkASSERT(!hasFunc || !noCanvas);
|
|
bool preprocessor = text[0] == '#';
|
|
bool wrapCode = !hasFunc && !noCanvas && !preprocessor;
|
|
if (wrapCode) {
|
|
fWrapper = hasCanvas ? string(drawNoCanvas) : string(drawWrapper);
|
|
}
|
|
}
|
|
|
|
bool Definition::exampleToScript(string* result, ExampleOptions exampleOptions) const {
|
|
bool hasFiddle = true;
|
|
const Definition* platform = this->hasChild(MarkType::kPlatform);
|
|
if (platform) {
|
|
TextParser platParse(platform);
|
|
hasFiddle = !platParse.strnstr("!fiddle", platParse.fEnd);
|
|
}
|
|
if (!hasFiddle) {
|
|
*result = "";
|
|
return true;
|
|
}
|
|
string text = this->extractText(Definition::TrimExtract::kNo);
|
|
bool textOut = string::npos != text.find("SkDebugf(")
|
|
|| string::npos != text.find("dump(")
|
|
|| string::npos != text.find("dumpHex(");
|
|
string heightStr = "256";
|
|
string widthStr = "256";
|
|
string normalizedName(fFiddle);
|
|
string code;
|
|
string imageStr = "0";
|
|
string srgbStr = "false";
|
|
string durationStr = "0";
|
|
for (auto const& iter : fChildren) {
|
|
switch (iter->fMarkType) {
|
|
case MarkType::kDuration:
|
|
durationStr = string(iter->fContentStart, iter->fContentEnd - iter->fContentStart);
|
|
break;
|
|
case MarkType::kError:
|
|
result->clear();
|
|
return true;
|
|
case MarkType::kHeight:
|
|
heightStr = string(iter->fContentStart, iter->fContentEnd - iter->fContentStart);
|
|
break;
|
|
case MarkType::kWidth:
|
|
widthStr = string(iter->fContentStart, iter->fContentEnd - iter->fContentStart);
|
|
break;
|
|
case MarkType::kDescription:
|
|
// ignore for now
|
|
break;
|
|
case MarkType::kFunction: {
|
|
// emit this, but don't wrap this in draw()
|
|
string funcText(iter->fContentStart, iter->fContentEnd - iter->fContentStart);
|
|
size_t pos = 0;
|
|
while (pos < funcText.length() && ' ' > funcText[pos]) {
|
|
++pos;
|
|
}
|
|
size_t indent = count_indent(funcText, pos, funcText.length());
|
|
add_code(funcText, pos, funcText.length(), 0, indent, code);
|
|
code += "\\n";
|
|
} break;
|
|
case MarkType::kComment:
|
|
break;
|
|
case MarkType::kImage:
|
|
imageStr = string(iter->fContentStart, iter->fContentEnd - iter->fContentStart);
|
|
break;
|
|
case MarkType::kToDo:
|
|
break;
|
|
case MarkType::kMarkChar:
|
|
case MarkType::kPlatform:
|
|
// ignore for now
|
|
break;
|
|
case MarkType::kSet:
|
|
if ("sRGB" == string(iter->fContentStart,
|
|
iter->fContentEnd - iter->fContentStart)) {
|
|
srgbStr = "true";
|
|
} else {
|
|
SkASSERT(0); // more work to do
|
|
return false;
|
|
}
|
|
break;
|
|
case MarkType::kStdOut:
|
|
textOut = true;
|
|
break;
|
|
default:
|
|
SkASSERT(0); // more coding to do
|
|
}
|
|
}
|
|
string animatedStr = "0" != durationStr ? "true" : "false";
|
|
string textOutStr = textOut ? "true" : "false";
|
|
size_t pos = 0;
|
|
while (pos < text.length() && ' ' > text[pos]) {
|
|
++pos;
|
|
}
|
|
size_t end = text.length();
|
|
size_t outIndent = 0;
|
|
size_t textIndent = count_indent(text, pos, end);
|
|
if (fWrapper.length() > 0) {
|
|
code += fWrapper;
|
|
code += "\\n";
|
|
outIndent = 4;
|
|
}
|
|
add_code(text, pos, end, outIndent, textIndent, code);
|
|
if (fWrapper.length() > 0) {
|
|
code += "}";
|
|
}
|
|
string example = "\"" + normalizedName + "\": {\n";
|
|
size_t nameStart = fFileName.find(SkOSPath::SEPARATOR, 0);
|
|
SkASSERT(string::npos != nameStart);
|
|
string baseFile = fFileName.substr(nameStart + 1, fFileName.length() - nameStart - 5);
|
|
if (ExampleOptions::kText == exampleOptions) {
|
|
example += " \"code\": \"" + code + "\",\n";
|
|
example += " \"hash\": \"" + fHash + "\",\n";
|
|
example += " \"file\": \"" + baseFile + "\",\n";
|
|
example += " \"name\": \"" + fName + "\",";
|
|
} else {
|
|
example += " \"code\": \"" + code + "\",\n";
|
|
if (ExampleOptions::kPng == exampleOptions) {
|
|
example += " \"width\": " + widthStr + ",\n";
|
|
example += " \"height\": " + heightStr + ",\n";
|
|
example += " \"hash\": \"" + fHash + "\",\n";
|
|
example += " \"file\": \"" + baseFile + "\",\n";
|
|
example += " \"name\": \"" + fName + "\"\n";
|
|
example += "}";
|
|
} else {
|
|
example += " \"options\": {\n";
|
|
example += " \"width\": " + widthStr + ",\n";
|
|
example += " \"height\": " + heightStr + ",\n";
|
|
example += " \"source\": " + imageStr + ",\n";
|
|
example += " \"srgb\": " + srgbStr + ",\n";
|
|
example += " \"f16\": false,\n";
|
|
example += " \"textOnly\": " + textOutStr + ",\n";
|
|
example += " \"animated\": " + animatedStr + ",\n";
|
|
example += " \"duration\": " + durationStr + "\n";
|
|
example += " },\n";
|
|
example += " \"fast\": true";
|
|
}
|
|
}
|
|
*result = example;
|
|
return true;
|
|
}
|
|
|
|
string Definition::extractText(TrimExtract trimExtract) const {
|
|
string result;
|
|
TextParser parser(fFileName, fContentStart, fContentEnd, fLineCount);
|
|
int childIndex = 0;
|
|
char mc = '#';
|
|
while (parser.fChar < parser.fEnd) {
|
|
if (TrimExtract::kYes == trimExtract && !parser.skipWhiteSpace()) {
|
|
break;
|
|
}
|
|
if (parser.next() == mc) {
|
|
if (parser.next() == mc) {
|
|
if (parser.next() == mc) {
|
|
mc = parser.next();
|
|
}
|
|
} else {
|
|
// fixme : more work to do if # style comment is in text
|
|
// if in method definition, could be alternate method name
|
|
--parser.fChar;
|
|
if (' ' < parser.fChar[0]) {
|
|
if (islower(parser.fChar[0])) {
|
|
result += '\n';
|
|
parser.skipLine();
|
|
} else {
|
|
SkASSERT(isupper(parser.fChar[0]));
|
|
parser.skipTo(fChildren[childIndex]->fTerminator);
|
|
if (mc == parser.fChar[0] && mc == parser.fChar[1]) {
|
|
parser.next();
|
|
parser.next();
|
|
}
|
|
childIndex++;
|
|
}
|
|
} else {
|
|
parser.skipLine();
|
|
}
|
|
continue;
|
|
}
|
|
} else {
|
|
--parser.fChar;
|
|
}
|
|
const char* end = parser.fEnd;
|
|
const char* mark = parser.strnchr(mc, end);
|
|
if (mark) {
|
|
end = mark;
|
|
}
|
|
string fragment(parser.fChar, end - parser.fChar);
|
|
trim_end(fragment);
|
|
if (TrimExtract::kYes == trimExtract) {
|
|
trim_start(fragment);
|
|
if (result.length()) {
|
|
result += '\n';
|
|
result += '\n';
|
|
}
|
|
}
|
|
if (TrimExtract::kYes == trimExtract || has_nonwhitespace(fragment)) {
|
|
result += fragment;
|
|
}
|
|
parser.skipTo(end);
|
|
}
|
|
return result;
|
|
}
|
|
|
|
static void space_pad(string* str) {
|
|
size_t len = str->length();
|
|
if (len == 0) {
|
|
return;
|
|
}
|
|
char last = (*str)[len - 1];
|
|
if ('~' == last || ' ' >= last) {
|
|
return;
|
|
}
|
|
*str += ' ';
|
|
}
|
|
|
|
//start here;
|
|
// see if it possible to abstract this a little bit so it can
|
|
// additionally be used to find params and return in method prototype that
|
|
// does not have corresponding doxygen comments
|
|
bool Definition::checkMethod() const {
|
|
SkASSERT(MarkType::kMethod == fMarkType);
|
|
// if method returns a value, look for a return child
|
|
// for each parameter, look for a corresponding child
|
|
const char* end = fContentStart;
|
|
while (end > fStart && ' ' >= end[-1]) {
|
|
--end;
|
|
}
|
|
TextParser methodParser(fFileName, fStart, end, fLineCount);
|
|
methodParser.skipWhiteSpace();
|
|
SkASSERT(methodParser.startsWith("#Method"));
|
|
methodParser.skipName("#Method");
|
|
methodParser.skipSpace();
|
|
string name = this->methodName();
|
|
if (MethodType::kNone == fMethodType && name.length() > 2 &&
|
|
"()" == name.substr(name.length() - 2)) {
|
|
name = name.substr(0, name.length() - 2);
|
|
}
|
|
bool expectReturn = this->methodHasReturn(name, &methodParser);
|
|
bool foundReturn = false;
|
|
bool foundException = false;
|
|
for (auto& child : fChildren) {
|
|
foundException |= MarkType::kDeprecated == child->fMarkType
|
|
|| MarkType::kExperimental == child->fMarkType;
|
|
if (MarkType::kReturn != child->fMarkType) {
|
|
if (MarkType::kParam == child->fMarkType) {
|
|
child->fVisited = false;
|
|
}
|
|
continue;
|
|
}
|
|
if (!expectReturn) {
|
|
return methodParser.reportError<bool>("no #Return expected");
|
|
}
|
|
if (foundReturn) {
|
|
return methodParser.reportError<bool>("multiple #Return markers");
|
|
}
|
|
foundReturn = true;
|
|
}
|
|
if (expectReturn && !foundReturn && !foundException) {
|
|
return methodParser.reportError<bool>("missing #Return marker");
|
|
}
|
|
const char* paren = methodParser.strnchr('(', methodParser.fEnd);
|
|
if (!paren) {
|
|
return methodParser.reportError<bool>("missing #Method function definition");
|
|
}
|
|
const char* nextEnd = paren;
|
|
do {
|
|
string paramName;
|
|
methodParser.fChar = nextEnd + 1;
|
|
methodParser.skipSpace();
|
|
if (!this->nextMethodParam(&methodParser, &nextEnd, ¶mName)) {
|
|
continue;
|
|
}
|
|
bool foundParam = false;
|
|
for (auto& child : fChildren) {
|
|
if (MarkType::kParam != child->fMarkType) {
|
|
continue;
|
|
}
|
|
if (paramName != child->fName) {
|
|
continue;
|
|
}
|
|
if (child->fVisited) {
|
|
return methodParser.reportError<bool>("multiple #Method param with same name");
|
|
}
|
|
child->fVisited = true;
|
|
if (foundParam) {
|
|
TextParser paramError(child);
|
|
return methodParser.reportError<bool>("multiple #Param with same name");
|
|
}
|
|
foundParam = true;
|
|
|
|
}
|
|
if (!foundParam && !foundException) {
|
|
return methodParser.reportError<bool>("no #Param found");
|
|
}
|
|
if (')' == nextEnd[0]) {
|
|
break;
|
|
}
|
|
} while (')' != nextEnd[0]);
|
|
for (auto& child : fChildren) {
|
|
if (MarkType::kParam != child->fMarkType) {
|
|
continue;
|
|
}
|
|
if (!child->fVisited) {
|
|
TextParser paramError(child);
|
|
return paramError.reportError<bool>("#Param without param in #Method");
|
|
}
|
|
}
|
|
return true;
|
|
}
|
|
|
|
bool Definition::crossCheck2(const Definition& includeToken) const {
|
|
TextParser parser(fFileName, fStart, fContentStart, fLineCount);
|
|
parser.skipExact("#");
|
|
bool isMethod = parser.skipName("Method");
|
|
const char* contentEnd;
|
|
if (isMethod) {
|
|
contentEnd = fContentStart;
|
|
} else if (parser.skipName("DefinedBy")) {
|
|
contentEnd = fContentEnd;
|
|
while (parser.fChar < contentEnd && ' ' >= contentEnd[-1]) {
|
|
--contentEnd;
|
|
}
|
|
if (parser.fChar < contentEnd - 1 && ')' == contentEnd[-1] && '(' == contentEnd[-2]) {
|
|
contentEnd -= 2;
|
|
}
|
|
} else {
|
|
return parser.reportError<bool>("unexpected crosscheck marktype");
|
|
}
|
|
return crossCheckInside(parser.fChar, contentEnd, includeToken);
|
|
}
|
|
|
|
bool Definition::crossCheck(const Definition& includeToken) const {
|
|
return crossCheckInside(fContentStart, fContentEnd, includeToken);
|
|
}
|
|
|
|
bool Definition::crossCheckInside(const char* start, const char* end,
|
|
const Definition& includeToken) const {
|
|
TextParser def(fFileName, start, end, fLineCount);
|
|
TextParser inc("", includeToken.fContentStart, includeToken.fContentEnd, 0);
|
|
if (inc.startsWith("SK_API")) {
|
|
inc.skipWord("SK_API");
|
|
}
|
|
if (inc.startsWith("friend")) {
|
|
inc.skipWord("friend");
|
|
}
|
|
if (inc.startsWith("SK_API")) {
|
|
inc.skipWord("SK_API");
|
|
}
|
|
inc.skipExact("SkDEBUGCODE(");
|
|
do {
|
|
bool defEof;
|
|
bool incEof;
|
|
do {
|
|
defEof = def.eof() || !def.skipWhiteSpace();
|
|
incEof = inc.eof() || !inc.skipWhiteSpace();
|
|
if (!incEof && '/' == inc.peek() && (defEof || '/' != def.peek())) {
|
|
inc.next();
|
|
if ('*' == inc.peek()) {
|
|
inc.skipToEndBracket("*/");
|
|
inc.next();
|
|
} else if ('/' == inc.peek()) {
|
|
inc.skipToEndBracket('\n');
|
|
}
|
|
} else if (!incEof && '#' == inc.peek() && (defEof || '#' != def.peek())) {
|
|
inc.next();
|
|
if (inc.startsWith("if")) {
|
|
inc.skipToEndBracket("\n");
|
|
} else if (inc.startsWith("endif")) {
|
|
inc.skipToEndBracket("\n");
|
|
} else {
|
|
SkASSERT(0); // incomplete
|
|
return false;
|
|
}
|
|
} else {
|
|
break;
|
|
}
|
|
inc.next();
|
|
} while (true);
|
|
if (defEof || incEof) {
|
|
if (defEof == incEof || (!defEof && ';' == def.peek())) {
|
|
return true;
|
|
}
|
|
return false; // allow setting breakpoint on failure
|
|
}
|
|
char defCh;
|
|
do {
|
|
defCh = def.next();
|
|
char incCh = inc.next();
|
|
if (' ' >= defCh && ' ' >= incCh) {
|
|
break;
|
|
}
|
|
if (defCh != incCh) {
|
|
if ('_' != defCh || ' ' != incCh || !fOperatorConst || !def.startsWith("const")) {
|
|
return false;
|
|
}
|
|
}
|
|
if (';' == defCh) {
|
|
return true;
|
|
}
|
|
} while (!def.eof() && !inc.eof());
|
|
} while (true);
|
|
return false;
|
|
}
|
|
|
|
string Definition::formatFunction() const {
|
|
const char* end = fContentStart;
|
|
while (end > fStart && ' ' >= end[-1]) {
|
|
--end;
|
|
}
|
|
TextParser methodParser(fFileName, fStart, end, fLineCount);
|
|
methodParser.skipWhiteSpace();
|
|
SkASSERT(methodParser.startsWith("#Method"));
|
|
methodParser.skipName("#Method");
|
|
methodParser.skipSpace();
|
|
const char* lastStart = methodParser.fChar;
|
|
const int limit = 100; // todo: allow this to be set by caller or in global or something
|
|
string name = this->methodName();
|
|
const char* nameInParser = methodParser.strnstr(name.c_str(), methodParser.fEnd);
|
|
methodParser.skipTo(nameInParser);
|
|
const char* lastEnd = methodParser.fChar;
|
|
const char* paren = methodParser.strnchr('(', methodParser.fEnd);
|
|
size_t indent;
|
|
if (paren) {
|
|
indent = (size_t) (paren - lastStart) + 1;
|
|
} else {
|
|
indent = (size_t) (lastEnd - lastStart);
|
|
}
|
|
// trim indent so longest line doesn't exceed box width
|
|
TextParser::Save savePlace(&methodParser);
|
|
const char* saveStart = lastStart;
|
|
ptrdiff_t maxLine = 0;
|
|
do {
|
|
const char* nextStart = lastEnd;
|
|
const char* delimiter = methodParser.anyOf(",)");
|
|
const char* nextEnd = delimiter ? delimiter : methodParser.fEnd;
|
|
if (delimiter) {
|
|
while (nextStart < nextEnd && ' ' >= nextStart[0]) {
|
|
++nextStart;
|
|
}
|
|
}
|
|
while (nextEnd > nextStart && ' ' >= nextEnd[-1]) {
|
|
--nextEnd;
|
|
}
|
|
if (delimiter) {
|
|
nextEnd += 1;
|
|
delimiter += 1;
|
|
}
|
|
if (lastEnd > lastStart) {
|
|
maxLine = SkTMax(maxLine, lastEnd - lastStart);
|
|
}
|
|
if (delimiter) {
|
|
methodParser.skipTo(delimiter);
|
|
}
|
|
lastStart = nextStart;
|
|
lastEnd = nextEnd;
|
|
} while (lastStart < lastEnd);
|
|
savePlace.restore();
|
|
lastStart = saveStart;
|
|
lastEnd = methodParser.fChar;
|
|
indent = SkTMin(indent, (size_t) (limit - maxLine));
|
|
// write string wtih trimmmed indent
|
|
string methodStr;
|
|
int written = 0;
|
|
do {
|
|
const char* nextStart = lastEnd;
|
|
SkASSERT(written < limit);
|
|
const char* delimiter = methodParser.anyOf(",)");
|
|
const char* nextEnd = delimiter ? delimiter : methodParser.fEnd;
|
|
if (delimiter) {
|
|
while (nextStart < nextEnd && ' ' >= nextStart[0]) {
|
|
++nextStart;
|
|
}
|
|
}
|
|
while (nextEnd > nextStart && ' ' >= nextEnd[-1]) {
|
|
--nextEnd;
|
|
}
|
|
if (delimiter) {
|
|
nextEnd += 1;
|
|
delimiter += 1;
|
|
}
|
|
if (lastEnd > lastStart) {
|
|
if (lastStart[0] != ' ') {
|
|
space_pad(&methodStr);
|
|
}
|
|
methodStr += string(lastStart, (size_t) (lastEnd - lastStart));
|
|
written += (size_t) (lastEnd - lastStart);
|
|
}
|
|
if (delimiter) {
|
|
if (nextEnd - nextStart >= (ptrdiff_t) (limit - written)) {
|
|
written = indent;
|
|
methodStr += '\n';
|
|
methodStr += string(indent, ' ');
|
|
}
|
|
methodParser.skipTo(delimiter);
|
|
}
|
|
lastStart = nextStart;
|
|
lastEnd = nextEnd;
|
|
} while (lastStart < lastEnd);
|
|
return methodStr;
|
|
}
|
|
|
|
string Definition::fiddleName() const {
|
|
string result;
|
|
size_t start = 0;
|
|
string parent;
|
|
const Definition* parentDef = this;
|
|
while ((parentDef = parentDef->fParent)) {
|
|
if (MarkType::kClass == parentDef->fMarkType || MarkType::kStruct == parentDef->fMarkType) {
|
|
parent = parentDef->fFiddle;
|
|
break;
|
|
}
|
|
}
|
|
if (parent.length() && 0 == fFiddle.compare(0, parent.length(), parent)) {
|
|
start = parent.length();
|
|
while (start < fFiddle.length() && '_' == fFiddle[start]) {
|
|
++start;
|
|
}
|
|
}
|
|
size_t end = fFiddle.find_first_of('(', start);
|
|
return fFiddle.substr(start, end - start);
|
|
}
|
|
|
|
const Definition* Definition::hasChild(MarkType markType) const {
|
|
for (auto iter : fChildren) {
|
|
if (markType == iter->fMarkType) {
|
|
return iter;
|
|
}
|
|
}
|
|
return nullptr;
|
|
}
|
|
|
|
const Definition* Definition::hasParam(const string& ref) const {
|
|
SkASSERT(MarkType::kMethod == fMarkType);
|
|
for (auto iter : fChildren) {
|
|
if (MarkType::kParam != iter->fMarkType) {
|
|
continue;
|
|
}
|
|
if (iter->fName == ref) {
|
|
return &*iter;
|
|
}
|
|
|
|
}
|
|
return nullptr;
|
|
}
|
|
|
|
bool Definition::hasMatch(const string& name) const {
|
|
for (auto child : fChildren) {
|
|
if (name == child->fName) {
|
|
return true;
|
|
}
|
|
if (child->hasMatch(name)) {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
bool Definition::isStructOrClass() const {
|
|
if (MarkType::kStruct != fMarkType && MarkType::kClass != fMarkType) {
|
|
return false;
|
|
}
|
|
if (string::npos != fFileName.find("undocumented.bmh")) {
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
bool Definition::methodHasReturn(const string& name, TextParser* methodParser) const {
|
|
if (methodParser->skipExact("static")) {
|
|
methodParser->skipWhiteSpace();
|
|
}
|
|
const char* lastStart = methodParser->fChar;
|
|
const char* nameInParser = methodParser->strnstr(name.c_str(), methodParser->fEnd);
|
|
methodParser->skipTo(nameInParser);
|
|
const char* lastEnd = methodParser->fChar;
|
|
const char* returnEnd = lastEnd;
|
|
while (returnEnd > lastStart && ' ' == returnEnd[-1]) {
|
|
--returnEnd;
|
|
}
|
|
bool expectReturn = 4 != returnEnd - lastStart || strncmp("void", lastStart, 4);
|
|
if (MethodType::kNone != fMethodType && MethodType::kOperator != fMethodType && !expectReturn) {
|
|
return methodParser->reportError<bool>("unexpected void");
|
|
}
|
|
switch (fMethodType) {
|
|
case MethodType::kNone:
|
|
case MethodType::kOperator:
|
|
// either is fine
|
|
break;
|
|
case MethodType::kConstructor:
|
|
expectReturn = true;
|
|
break;
|
|
case MethodType::kDestructor:
|
|
expectReturn = false;
|
|
break;
|
|
}
|
|
return expectReturn;
|
|
}
|
|
|
|
string Definition::methodName() const {
|
|
string result;
|
|
size_t start = 0;
|
|
string parent;
|
|
const Definition* parentDef = this;
|
|
while ((parentDef = parentDef->fParent)) {
|
|
if (MarkType::kClass == parentDef->fMarkType || MarkType::kStruct == parentDef->fMarkType) {
|
|
parent = parentDef->fName;
|
|
break;
|
|
}
|
|
}
|
|
if (parent.length() && 0 == fName.compare(0, parent.length(), parent)) {
|
|
start = parent.length();
|
|
while (start < fName.length() && ':' == fName[start]) {
|
|
++start;
|
|
}
|
|
}
|
|
if (fClone) {
|
|
int lastUnder = fName.rfind('_');
|
|
return fName.substr(start, (size_t) (lastUnder - start));
|
|
}
|
|
size_t end = fName.find_first_of('(', start);
|
|
if (string::npos == end) {
|
|
return fName.substr(start);
|
|
}
|
|
return fName.substr(start, end - start);
|
|
}
|
|
|
|
bool Definition::nextMethodParam(TextParser* methodParser, const char** nextEndPtr,
|
|
string* paramName) const {
|
|
int parenCount = 0;
|
|
TextParser::Save saveState(methodParser);
|
|
while (true) {
|
|
if (methodParser->eof()) {
|
|
return methodParser->reportError<bool>("#Method function missing close paren");
|
|
}
|
|
char ch = methodParser->peek();
|
|
if ('(' == ch) {
|
|
++parenCount;
|
|
}
|
|
if (parenCount == 0 && (')' == ch || ',' == ch)) {
|
|
*nextEndPtr = methodParser->fChar;
|
|
break;
|
|
}
|
|
if (')' == ch) {
|
|
if (0 > --parenCount) {
|
|
return this->reportError<bool>("mismatched parentheses");
|
|
}
|
|
}
|
|
methodParser->next();
|
|
}
|
|
saveState.restore();
|
|
const char* nextEnd = *nextEndPtr;
|
|
const char* paramEnd = nextEnd;
|
|
const char* assign = methodParser->strnstr(" = ", paramEnd);
|
|
if (assign) {
|
|
paramEnd = assign;
|
|
}
|
|
const char* closeBracket = methodParser->strnstr("]", paramEnd);
|
|
if (closeBracket) {
|
|
const char* openBracket = methodParser->strnstr("[", paramEnd);
|
|
if (openBracket && openBracket < closeBracket) {
|
|
while (openBracket < --closeBracket && isdigit(closeBracket[0]))
|
|
;
|
|
if (openBracket == closeBracket) {
|
|
paramEnd = openBracket;
|
|
}
|
|
}
|
|
}
|
|
const char* function = methodParser->strnstr(")(", paramEnd);
|
|
if (function) {
|
|
paramEnd = function;
|
|
}
|
|
while (paramEnd > methodParser->fChar && ' ' == paramEnd[-1]) {
|
|
--paramEnd;
|
|
}
|
|
const char* paramStart = paramEnd;
|
|
while (paramStart > methodParser->fChar && isalnum(paramStart[-1])) {
|
|
--paramStart;
|
|
}
|
|
if (paramStart > methodParser->fChar && paramStart >= paramEnd) {
|
|
return methodParser->reportError<bool>("#Method missing param name");
|
|
}
|
|
*paramName = string(paramStart, paramEnd - paramStart);
|
|
if (!paramName->length()) {
|
|
if (')' != nextEnd[0]) {
|
|
return methodParser->reportError<bool>("#Method malformed param");
|
|
}
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
string Definition::NormalizedName(string name) {
|
|
string normalizedName = name;
|
|
std::replace(normalizedName.begin(), normalizedName.end(), '-', '_');
|
|
do {
|
|
size_t doubleColon = normalizedName.find("::", 0);
|
|
if (string::npos == doubleColon) {
|
|
break;
|
|
}
|
|
normalizedName = normalizedName.substr(0, doubleColon)
|
|
+ '_' + normalizedName.substr(doubleColon + 2);
|
|
} while (true);
|
|
return normalizedName;
|
|
}
|
|
|
|
bool Definition::paramsMatch(const string& match, const string& name) const {
|
|
TextParser def(fFileName, fStart, fContentStart, fLineCount);
|
|
const char* dName = def.strnstr(name.c_str(), fContentStart);
|
|
if (!dName) {
|
|
return false;
|
|
}
|
|
def.skipTo(dName);
|
|
TextParser m(fFileName, &match.front(), &match.back() + 1, fLineCount);
|
|
const char* mName = m.strnstr(name.c_str(), m.fEnd);
|
|
if (!mName) {
|
|
return false;
|
|
}
|
|
m.skipTo(mName);
|
|
while (!def.eof() && ')' != def.peek() && !m.eof() && ')' != m.peek()) {
|
|
const char* ds = def.fChar;
|
|
const char* ms = m.fChar;
|
|
const char* de = def.anyOf(") \n");
|
|
const char* me = m.anyOf(") \n");
|
|
def.skipTo(de);
|
|
m.skipTo(me);
|
|
if (def.fChar - ds != m.fChar - ms) {
|
|
return false;
|
|
}
|
|
if (strncmp(ds, ms, (int) (def.fChar - ds))) {
|
|
return false;
|
|
}
|
|
def.skipWhiteSpace();
|
|
m.skipWhiteSpace();
|
|
}
|
|
return !def.eof() && ')' == def.peek() && !m.eof() && ')' == m.peek();
|
|
}
|
|
|
|
void RootDefinition::clearVisited() {
|
|
fVisited = false;
|
|
for (auto& leaf : fLeaves) {
|
|
leaf.second.fVisited = false;
|
|
}
|
|
for (auto& branch : fBranches) {
|
|
branch.second->clearVisited();
|
|
}
|
|
}
|
|
|
|
bool RootDefinition::dumpUnVisited() {
|
|
bool success = true;
|
|
for (auto& leaf : fLeaves) {
|
|
if (!leaf.second.fVisited) {
|
|
// FIXME: bugs requiring long tail fixes, suppressed here:
|
|
// SkBitmap::validate() is wrapped in SkDEBUGCODE in .h and not parsed
|
|
if ("SkBitmap::validate()" == leaf.first) {
|
|
continue;
|
|
}
|
|
// SkPath::pathRefIsValid in #ifdef ; prefer to remove chrome dependency to fix
|
|
if ("SkPath::pathRefIsValid" == leaf.first) {
|
|
continue;
|
|
}
|
|
// FIXME: end of long tail bugs
|
|
SkDebugf("defined in bmh but missing in include: %s\n", leaf.first.c_str());
|
|
success = false;
|
|
}
|
|
}
|
|
for (auto& branch : fBranches) {
|
|
success &= branch.second->dumpUnVisited();
|
|
}
|
|
return success;
|
|
}
|
|
|
|
const Definition* RootDefinition::find(const string& ref, AllowParens allowParens) const {
|
|
const auto leafIter = fLeaves.find(ref);
|
|
if (leafIter != fLeaves.end()) {
|
|
return &leafIter->second;
|
|
}
|
|
if (AllowParens::kYes == allowParens && string::npos == ref.find("()")) {
|
|
string withParens = ref + "()";
|
|
const auto parensIter = fLeaves.find(withParens);
|
|
if (parensIter != fLeaves.end()) {
|
|
return &parensIter->second;
|
|
}
|
|
}
|
|
const auto branchIter = fBranches.find(ref);
|
|
if (branchIter != fBranches.end()) {
|
|
const RootDefinition* rootDef = branchIter->second;
|
|
return rootDef;
|
|
}
|
|
const Definition* result = nullptr;
|
|
for (const auto& branch : fBranches) {
|
|
const RootDefinition* rootDef = branch.second;
|
|
result = rootDef->find(ref, allowParens);
|
|
if (result) {
|
|
break;
|
|
}
|
|
}
|
|
return result;
|
|
}
|