FormatString.cpp 30 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010
  1. // FormatString.cpp - Common stuff for handling printf/scanf formats -*- C++ -*-
  2. //
  3. // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
  4. // See https://llvm.org/LICENSE.txt for license information.
  5. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
  6. //
  7. //===----------------------------------------------------------------------===//
  8. //
  9. // Shared details for processing format strings of printf and scanf
  10. // (and friends).
  11. //
  12. //===----------------------------------------------------------------------===//
  13. #include "FormatStringParsing.h"
  14. #include "clang/Basic/LangOptions.h"
  15. #include "clang/Basic/TargetInfo.h"
  16. #include "llvm/Support/ConvertUTF.h"
  17. using clang::analyze_format_string::ArgType;
  18. using clang::analyze_format_string::FormatStringHandler;
  19. using clang::analyze_format_string::FormatSpecifier;
  20. using clang::analyze_format_string::LengthModifier;
  21. using clang::analyze_format_string::OptionalAmount;
  22. using clang::analyze_format_string::PositionContext;
  23. using clang::analyze_format_string::ConversionSpecifier;
  24. using namespace clang;
  25. // Key function to FormatStringHandler.
  26. FormatStringHandler::~FormatStringHandler() {}
  27. //===----------------------------------------------------------------------===//
  28. // Functions for parsing format strings components in both printf and
  29. // scanf format strings.
  30. //===----------------------------------------------------------------------===//
  31. OptionalAmount
  32. clang::analyze_format_string::ParseAmount(const char *&Beg, const char *E) {
  33. const char *I = Beg;
  34. UpdateOnReturn <const char*> UpdateBeg(Beg, I);
  35. unsigned accumulator = 0;
  36. bool hasDigits = false;
  37. for ( ; I != E; ++I) {
  38. char c = *I;
  39. if (c >= '0' && c <= '9') {
  40. hasDigits = true;
  41. accumulator = (accumulator * 10) + (c - '0');
  42. continue;
  43. }
  44. if (hasDigits)
  45. return OptionalAmount(OptionalAmount::Constant, accumulator, Beg, I - Beg,
  46. false);
  47. break;
  48. }
  49. return OptionalAmount();
  50. }
  51. OptionalAmount
  52. clang::analyze_format_string::ParseNonPositionAmount(const char *&Beg,
  53. const char *E,
  54. unsigned &argIndex) {
  55. if (*Beg == '*') {
  56. ++Beg;
  57. return OptionalAmount(OptionalAmount::Arg, argIndex++, Beg, 0, false);
  58. }
  59. return ParseAmount(Beg, E);
  60. }
  61. OptionalAmount
  62. clang::analyze_format_string::ParsePositionAmount(FormatStringHandler &H,
  63. const char *Start,
  64. const char *&Beg,
  65. const char *E,
  66. PositionContext p) {
  67. if (*Beg == '*') {
  68. const char *I = Beg + 1;
  69. const OptionalAmount &Amt = ParseAmount(I, E);
  70. if (Amt.getHowSpecified() == OptionalAmount::NotSpecified) {
  71. H.HandleInvalidPosition(Beg, I - Beg, p);
  72. return OptionalAmount(false);
  73. }
  74. if (I == E) {
  75. // No more characters left?
  76. H.HandleIncompleteSpecifier(Start, E - Start);
  77. return OptionalAmount(false);
  78. }
  79. assert(Amt.getHowSpecified() == OptionalAmount::Constant);
  80. if (*I == '$') {
  81. // Handle positional arguments
  82. // Special case: '*0$', since this is an easy mistake.
  83. if (Amt.getConstantAmount() == 0) {
  84. H.HandleZeroPosition(Beg, I - Beg + 1);
  85. return OptionalAmount(false);
  86. }
  87. const char *Tmp = Beg;
  88. Beg = ++I;
  89. return OptionalAmount(OptionalAmount::Arg, Amt.getConstantAmount() - 1,
  90. Tmp, 0, true);
  91. }
  92. H.HandleInvalidPosition(Beg, I - Beg, p);
  93. return OptionalAmount(false);
  94. }
  95. return ParseAmount(Beg, E);
  96. }
  97. bool
  98. clang::analyze_format_string::ParseFieldWidth(FormatStringHandler &H,
  99. FormatSpecifier &CS,
  100. const char *Start,
  101. const char *&Beg, const char *E,
  102. unsigned *argIndex) {
  103. // FIXME: Support negative field widths.
  104. if (argIndex) {
  105. CS.setFieldWidth(ParseNonPositionAmount(Beg, E, *argIndex));
  106. }
  107. else {
  108. const OptionalAmount Amt =
  109. ParsePositionAmount(H, Start, Beg, E,
  110. analyze_format_string::FieldWidthPos);
  111. if (Amt.isInvalid())
  112. return true;
  113. CS.setFieldWidth(Amt);
  114. }
  115. return false;
  116. }
  117. bool
  118. clang::analyze_format_string::ParseArgPosition(FormatStringHandler &H,
  119. FormatSpecifier &FS,
  120. const char *Start,
  121. const char *&Beg,
  122. const char *E) {
  123. const char *I = Beg;
  124. const OptionalAmount &Amt = ParseAmount(I, E);
  125. if (I == E) {
  126. // No more characters left?
  127. H.HandleIncompleteSpecifier(Start, E - Start);
  128. return true;
  129. }
  130. if (Amt.getHowSpecified() == OptionalAmount::Constant && *(I++) == '$') {
  131. // Warn that positional arguments are non-standard.
  132. H.HandlePosition(Start, I - Start);
  133. // Special case: '%0$', since this is an easy mistake.
  134. if (Amt.getConstantAmount() == 0) {
  135. H.HandleZeroPosition(Start, I - Start);
  136. return true;
  137. }
  138. FS.setArgIndex(Amt.getConstantAmount() - 1);
  139. FS.setUsesPositionalArg();
  140. // Update the caller's pointer if we decided to consume
  141. // these characters.
  142. Beg = I;
  143. return false;
  144. }
  145. return false;
  146. }
  147. bool
  148. clang::analyze_format_string::ParseVectorModifier(FormatStringHandler &H,
  149. FormatSpecifier &FS,
  150. const char *&I,
  151. const char *E,
  152. const LangOptions &LO) {
  153. if (!LO.OpenCL)
  154. return false;
  155. const char *Start = I;
  156. if (*I == 'v') {
  157. ++I;
  158. if (I == E) {
  159. H.HandleIncompleteSpecifier(Start, E - Start);
  160. return true;
  161. }
  162. OptionalAmount NumElts = ParseAmount(I, E);
  163. if (NumElts.getHowSpecified() != OptionalAmount::Constant) {
  164. H.HandleIncompleteSpecifier(Start, E - Start);
  165. return true;
  166. }
  167. FS.setVectorNumElts(NumElts);
  168. }
  169. return false;
  170. }
  171. bool
  172. clang::analyze_format_string::ParseLengthModifier(FormatSpecifier &FS,
  173. const char *&I,
  174. const char *E,
  175. const LangOptions &LO,
  176. bool IsScanf) {
  177. LengthModifier::Kind lmKind = LengthModifier::None;
  178. const char *lmPosition = I;
  179. switch (*I) {
  180. default:
  181. return false;
  182. case 'h':
  183. ++I;
  184. if (I != E && *I == 'h') {
  185. ++I;
  186. lmKind = LengthModifier::AsChar;
  187. } else if (I != E && *I == 'l' && LO.OpenCL) {
  188. ++I;
  189. lmKind = LengthModifier::AsShortLong;
  190. } else {
  191. lmKind = LengthModifier::AsShort;
  192. }
  193. break;
  194. case 'l':
  195. ++I;
  196. if (I != E && *I == 'l') {
  197. ++I;
  198. lmKind = LengthModifier::AsLongLong;
  199. } else {
  200. lmKind = LengthModifier::AsLong;
  201. }
  202. break;
  203. case 'j': lmKind = LengthModifier::AsIntMax; ++I; break;
  204. case 'z': lmKind = LengthModifier::AsSizeT; ++I; break;
  205. case 't': lmKind = LengthModifier::AsPtrDiff; ++I; break;
  206. case 'L': lmKind = LengthModifier::AsLongDouble; ++I; break;
  207. case 'q': lmKind = LengthModifier::AsQuad; ++I; break;
  208. case 'a':
  209. if (IsScanf && !LO.C99 && !LO.CPlusPlus11) {
  210. // For scanf in C90, look at the next character to see if this should
  211. // be parsed as the GNU extension 'a' length modifier. If not, this
  212. // will be parsed as a conversion specifier.
  213. ++I;
  214. if (I != E && (*I == 's' || *I == 'S' || *I == '[')) {
  215. lmKind = LengthModifier::AsAllocate;
  216. break;
  217. }
  218. --I;
  219. }
  220. return false;
  221. case 'm':
  222. if (IsScanf) {
  223. lmKind = LengthModifier::AsMAllocate;
  224. ++I;
  225. break;
  226. }
  227. return false;
  228. // printf: AsInt64, AsInt32, AsInt3264
  229. // scanf: AsInt64
  230. case 'I':
  231. if (I + 1 != E && I + 2 != E) {
  232. if (I[1] == '6' && I[2] == '4') {
  233. I += 3;
  234. lmKind = LengthModifier::AsInt64;
  235. break;
  236. }
  237. if (IsScanf)
  238. return false;
  239. if (I[1] == '3' && I[2] == '2') {
  240. I += 3;
  241. lmKind = LengthModifier::AsInt32;
  242. break;
  243. }
  244. }
  245. ++I;
  246. lmKind = LengthModifier::AsInt3264;
  247. break;
  248. case 'w':
  249. lmKind = LengthModifier::AsWide; ++I; break;
  250. }
  251. LengthModifier lm(lmPosition, lmKind);
  252. FS.setLengthModifier(lm);
  253. return true;
  254. }
  255. bool clang::analyze_format_string::ParseUTF8InvalidSpecifier(
  256. const char *SpecifierBegin, const char *FmtStrEnd, unsigned &Len) {
  257. if (SpecifierBegin + 1 >= FmtStrEnd)
  258. return false;
  259. const llvm::UTF8 *SB =
  260. reinterpret_cast<const llvm::UTF8 *>(SpecifierBegin + 1);
  261. const llvm::UTF8 *SE = reinterpret_cast<const llvm::UTF8 *>(FmtStrEnd);
  262. const char FirstByte = *SB;
  263. // If the invalid specifier is a multibyte UTF-8 string, return the
  264. // total length accordingly so that the conversion specifier can be
  265. // properly updated to reflect a complete UTF-8 specifier.
  266. unsigned NumBytes = llvm::getNumBytesForUTF8(FirstByte);
  267. if (NumBytes == 1)
  268. return false;
  269. if (SB + NumBytes > SE)
  270. return false;
  271. Len = NumBytes + 1;
  272. return true;
  273. }
  274. //===----------------------------------------------------------------------===//
  275. // Methods on ArgType.
  276. //===----------------------------------------------------------------------===//
  277. clang::analyze_format_string::ArgType::MatchKind
  278. ArgType::matchesType(ASTContext &C, QualType argTy) const {
  279. if (Ptr) {
  280. // It has to be a pointer.
  281. const PointerType *PT = argTy->getAs<PointerType>();
  282. if (!PT)
  283. return NoMatch;
  284. // We cannot write through a const qualified pointer.
  285. if (PT->getPointeeType().isConstQualified())
  286. return NoMatch;
  287. argTy = PT->getPointeeType();
  288. }
  289. switch (K) {
  290. case InvalidTy:
  291. llvm_unreachable("ArgType must be valid");
  292. case UnknownTy:
  293. return Match;
  294. case AnyCharTy: {
  295. if (const EnumType *ETy = argTy->getAs<EnumType>()) {
  296. // If the enum is incomplete we know nothing about the underlying type.
  297. // Assume that it's 'int'.
  298. if (!ETy->getDecl()->isComplete())
  299. return NoMatch;
  300. argTy = ETy->getDecl()->getIntegerType();
  301. }
  302. if (const BuiltinType *BT = argTy->getAs<BuiltinType>())
  303. switch (BT->getKind()) {
  304. default:
  305. break;
  306. case BuiltinType::Char_S:
  307. case BuiltinType::SChar:
  308. case BuiltinType::UChar:
  309. case BuiltinType::Char_U:
  310. case BuiltinType::Bool:
  311. return Match;
  312. }
  313. return NoMatch;
  314. }
  315. case SpecificTy: {
  316. if (const EnumType *ETy = argTy->getAs<EnumType>()) {
  317. // If the enum is incomplete we know nothing about the underlying type.
  318. // Assume that it's 'int'.
  319. if (!ETy->getDecl()->isComplete())
  320. argTy = C.IntTy;
  321. else
  322. argTy = ETy->getDecl()->getIntegerType();
  323. }
  324. argTy = C.getCanonicalType(argTy).getUnqualifiedType();
  325. if (T == argTy)
  326. return Match;
  327. // Check for "compatible types".
  328. if (const BuiltinType *BT = argTy->getAs<BuiltinType>())
  329. switch (BT->getKind()) {
  330. default:
  331. break;
  332. case BuiltinType::Char_S:
  333. case BuiltinType::SChar:
  334. case BuiltinType::Char_U:
  335. case BuiltinType::UChar:
  336. case BuiltinType::Bool:
  337. if (T == C.UnsignedShortTy || T == C.ShortTy)
  338. return NoMatchTypeConfusion;
  339. return T == C.UnsignedCharTy || T == C.SignedCharTy ? Match
  340. : NoMatch;
  341. case BuiltinType::Short:
  342. return T == C.UnsignedShortTy ? Match : NoMatch;
  343. case BuiltinType::UShort:
  344. return T == C.ShortTy ? Match : NoMatch;
  345. case BuiltinType::Int:
  346. return T == C.UnsignedIntTy ? Match : NoMatch;
  347. case BuiltinType::UInt:
  348. return T == C.IntTy ? Match : NoMatch;
  349. case BuiltinType::Long:
  350. return T == C.UnsignedLongTy ? Match : NoMatch;
  351. case BuiltinType::ULong:
  352. return T == C.LongTy ? Match : NoMatch;
  353. case BuiltinType::LongLong:
  354. return T == C.UnsignedLongLongTy ? Match : NoMatch;
  355. case BuiltinType::ULongLong:
  356. return T == C.LongLongTy ? Match : NoMatch;
  357. }
  358. return NoMatch;
  359. }
  360. case CStrTy: {
  361. const PointerType *PT = argTy->getAs<PointerType>();
  362. if (!PT)
  363. return NoMatch;
  364. QualType pointeeTy = PT->getPointeeType();
  365. if (const BuiltinType *BT = pointeeTy->getAs<BuiltinType>())
  366. switch (BT->getKind()) {
  367. case BuiltinType::Void:
  368. case BuiltinType::Char_U:
  369. case BuiltinType::UChar:
  370. case BuiltinType::Char_S:
  371. case BuiltinType::SChar:
  372. return Match;
  373. default:
  374. break;
  375. }
  376. return NoMatch;
  377. }
  378. case WCStrTy: {
  379. const PointerType *PT = argTy->getAs<PointerType>();
  380. if (!PT)
  381. return NoMatch;
  382. QualType pointeeTy =
  383. C.getCanonicalType(PT->getPointeeType()).getUnqualifiedType();
  384. return pointeeTy == C.getWideCharType() ? Match : NoMatch;
  385. }
  386. case WIntTy: {
  387. QualType WInt = C.getCanonicalType(C.getWIntType()).getUnqualifiedType();
  388. if (C.getCanonicalType(argTy).getUnqualifiedType() == WInt)
  389. return Match;
  390. QualType PromoArg = argTy->isPromotableIntegerType()
  391. ? C.getPromotedIntegerType(argTy)
  392. : argTy;
  393. PromoArg = C.getCanonicalType(PromoArg).getUnqualifiedType();
  394. // If the promoted argument is the corresponding signed type of the
  395. // wint_t type, then it should match.
  396. if (PromoArg->hasSignedIntegerRepresentation() &&
  397. C.getCorrespondingUnsignedType(PromoArg) == WInt)
  398. return Match;
  399. return WInt == PromoArg ? Match : NoMatch;
  400. }
  401. case CPointerTy:
  402. if (argTy->isVoidPointerType()) {
  403. return Match;
  404. } if (argTy->isPointerType() || argTy->isObjCObjectPointerType() ||
  405. argTy->isBlockPointerType() || argTy->isNullPtrType()) {
  406. return NoMatchPedantic;
  407. } else {
  408. return NoMatch;
  409. }
  410. case ObjCPointerTy: {
  411. if (argTy->getAs<ObjCObjectPointerType>() ||
  412. argTy->getAs<BlockPointerType>())
  413. return Match;
  414. // Handle implicit toll-free bridging.
  415. if (const PointerType *PT = argTy->getAs<PointerType>()) {
  416. // Things such as CFTypeRef are really just opaque pointers
  417. // to C structs representing CF types that can often be bridged
  418. // to Objective-C objects. Since the compiler doesn't know which
  419. // structs can be toll-free bridged, we just accept them all.
  420. QualType pointee = PT->getPointeeType();
  421. if (pointee->getAsStructureType() || pointee->isVoidType())
  422. return Match;
  423. }
  424. return NoMatch;
  425. }
  426. }
  427. llvm_unreachable("Invalid ArgType Kind!");
  428. }
  429. ArgType ArgType::makeVectorType(ASTContext &C, unsigned NumElts) const {
  430. // Check for valid vector element types.
  431. if (T.isNull())
  432. return ArgType::Invalid();
  433. QualType Vec = C.getExtVectorType(T, NumElts);
  434. return ArgType(Vec, Name);
  435. }
  436. QualType ArgType::getRepresentativeType(ASTContext &C) const {
  437. QualType Res;
  438. switch (K) {
  439. case InvalidTy:
  440. llvm_unreachable("No representative type for Invalid ArgType");
  441. case UnknownTy:
  442. llvm_unreachable("No representative type for Unknown ArgType");
  443. case AnyCharTy:
  444. Res = C.CharTy;
  445. break;
  446. case SpecificTy:
  447. Res = T;
  448. break;
  449. case CStrTy:
  450. Res = C.getPointerType(C.CharTy);
  451. break;
  452. case WCStrTy:
  453. Res = C.getPointerType(C.getWideCharType());
  454. break;
  455. case ObjCPointerTy:
  456. Res = C.ObjCBuiltinIdTy;
  457. break;
  458. case CPointerTy:
  459. Res = C.VoidPtrTy;
  460. break;
  461. case WIntTy: {
  462. Res = C.getWIntType();
  463. break;
  464. }
  465. }
  466. if (Ptr)
  467. Res = C.getPointerType(Res);
  468. return Res;
  469. }
  470. std::string ArgType::getRepresentativeTypeName(ASTContext &C) const {
  471. std::string S = getRepresentativeType(C).getAsString();
  472. std::string Alias;
  473. if (Name) {
  474. // Use a specific name for this type, e.g. "size_t".
  475. Alias = Name;
  476. if (Ptr) {
  477. // If ArgType is actually a pointer to T, append an asterisk.
  478. Alias += (Alias[Alias.size()-1] == '*') ? "*" : " *";
  479. }
  480. // If Alias is the same as the underlying type, e.g. wchar_t, then drop it.
  481. if (S == Alias)
  482. Alias.clear();
  483. }
  484. if (!Alias.empty())
  485. return std::string("'") + Alias + "' (aka '" + S + "')";
  486. return std::string("'") + S + "'";
  487. }
  488. //===----------------------------------------------------------------------===//
  489. // Methods on OptionalAmount.
  490. //===----------------------------------------------------------------------===//
  491. ArgType
  492. analyze_format_string::OptionalAmount::getArgType(ASTContext &Ctx) const {
  493. return Ctx.IntTy;
  494. }
  495. //===----------------------------------------------------------------------===//
  496. // Methods on LengthModifier.
  497. //===----------------------------------------------------------------------===//
  498. const char *
  499. analyze_format_string::LengthModifier::toString() const {
  500. switch (kind) {
  501. case AsChar:
  502. return "hh";
  503. case AsShort:
  504. return "h";
  505. case AsShortLong:
  506. return "hl";
  507. case AsLong: // or AsWideChar
  508. return "l";
  509. case AsLongLong:
  510. return "ll";
  511. case AsQuad:
  512. return "q";
  513. case AsIntMax:
  514. return "j";
  515. case AsSizeT:
  516. return "z";
  517. case AsPtrDiff:
  518. return "t";
  519. case AsInt32:
  520. return "I32";
  521. case AsInt3264:
  522. return "I";
  523. case AsInt64:
  524. return "I64";
  525. case AsLongDouble:
  526. return "L";
  527. case AsAllocate:
  528. return "a";
  529. case AsMAllocate:
  530. return "m";
  531. case AsWide:
  532. return "w";
  533. case None:
  534. return "";
  535. }
  536. return nullptr;
  537. }
  538. //===----------------------------------------------------------------------===//
  539. // Methods on ConversionSpecifier.
  540. //===----------------------------------------------------------------------===//
  541. const char *ConversionSpecifier::toString() const {
  542. switch (kind) {
  543. case dArg: return "d";
  544. case DArg: return "D";
  545. case iArg: return "i";
  546. case oArg: return "o";
  547. case OArg: return "O";
  548. case uArg: return "u";
  549. case UArg: return "U";
  550. case xArg: return "x";
  551. case XArg: return "X";
  552. case fArg: return "f";
  553. case FArg: return "F";
  554. case eArg: return "e";
  555. case EArg: return "E";
  556. case gArg: return "g";
  557. case GArg: return "G";
  558. case aArg: return "a";
  559. case AArg: return "A";
  560. case cArg: return "c";
  561. case sArg: return "s";
  562. case pArg: return "p";
  563. case PArg:
  564. return "P";
  565. case nArg: return "n";
  566. case PercentArg: return "%";
  567. case ScanListArg: return "[";
  568. case InvalidSpecifier: return nullptr;
  569. // POSIX unicode extensions.
  570. case CArg: return "C";
  571. case SArg: return "S";
  572. // Objective-C specific specifiers.
  573. case ObjCObjArg: return "@";
  574. // FreeBSD kernel specific specifiers.
  575. case FreeBSDbArg: return "b";
  576. case FreeBSDDArg: return "D";
  577. case FreeBSDrArg: return "r";
  578. case FreeBSDyArg: return "y";
  579. // GlibC specific specifiers.
  580. case PrintErrno: return "m";
  581. // MS specific specifiers.
  582. case ZArg: return "Z";
  583. }
  584. return nullptr;
  585. }
  586. Optional<ConversionSpecifier>
  587. ConversionSpecifier::getStandardSpecifier() const {
  588. ConversionSpecifier::Kind NewKind;
  589. switch (getKind()) {
  590. default:
  591. return None;
  592. case DArg:
  593. NewKind = dArg;
  594. break;
  595. case UArg:
  596. NewKind = uArg;
  597. break;
  598. case OArg:
  599. NewKind = oArg;
  600. break;
  601. }
  602. ConversionSpecifier FixedCS(*this);
  603. FixedCS.setKind(NewKind);
  604. return FixedCS;
  605. }
  606. //===----------------------------------------------------------------------===//
  607. // Methods on OptionalAmount.
  608. //===----------------------------------------------------------------------===//
  609. void OptionalAmount::toString(raw_ostream &os) const {
  610. switch (hs) {
  611. case Invalid:
  612. case NotSpecified:
  613. return;
  614. case Arg:
  615. if (UsesDotPrefix)
  616. os << ".";
  617. if (usesPositionalArg())
  618. os << "*" << getPositionalArgIndex() << "$";
  619. else
  620. os << "*";
  621. break;
  622. case Constant:
  623. if (UsesDotPrefix)
  624. os << ".";
  625. os << amt;
  626. break;
  627. }
  628. }
  629. bool FormatSpecifier::hasValidLengthModifier(const TargetInfo &Target,
  630. const LangOptions &LO) const {
  631. switch (LM.getKind()) {
  632. case LengthModifier::None:
  633. return true;
  634. // Handle most integer flags
  635. case LengthModifier::AsShort:
  636. // Length modifier only applies to FP vectors.
  637. if (LO.OpenCL && CS.isDoubleArg())
  638. return !VectorNumElts.isInvalid();
  639. if (Target.getTriple().isOSMSVCRT()) {
  640. switch (CS.getKind()) {
  641. case ConversionSpecifier::cArg:
  642. case ConversionSpecifier::CArg:
  643. case ConversionSpecifier::sArg:
  644. case ConversionSpecifier::SArg:
  645. case ConversionSpecifier::ZArg:
  646. return true;
  647. default:
  648. break;
  649. }
  650. }
  651. LLVM_FALLTHROUGH;
  652. case LengthModifier::AsChar:
  653. case LengthModifier::AsLongLong:
  654. case LengthModifier::AsQuad:
  655. case LengthModifier::AsIntMax:
  656. case LengthModifier::AsSizeT:
  657. case LengthModifier::AsPtrDiff:
  658. switch (CS.getKind()) {
  659. case ConversionSpecifier::dArg:
  660. case ConversionSpecifier::DArg:
  661. case ConversionSpecifier::iArg:
  662. case ConversionSpecifier::oArg:
  663. case ConversionSpecifier::OArg:
  664. case ConversionSpecifier::uArg:
  665. case ConversionSpecifier::UArg:
  666. case ConversionSpecifier::xArg:
  667. case ConversionSpecifier::XArg:
  668. case ConversionSpecifier::nArg:
  669. return true;
  670. case ConversionSpecifier::FreeBSDrArg:
  671. case ConversionSpecifier::FreeBSDyArg:
  672. return Target.getTriple().isOSFreeBSD() || Target.getTriple().isPS4();
  673. default:
  674. return false;
  675. }
  676. case LengthModifier::AsShortLong:
  677. return LO.OpenCL && !VectorNumElts.isInvalid();
  678. // Handle 'l' flag
  679. case LengthModifier::AsLong: // or AsWideChar
  680. if (CS.isDoubleArg()) {
  681. // Invalid for OpenCL FP scalars.
  682. if (LO.OpenCL && VectorNumElts.isInvalid())
  683. return false;
  684. return true;
  685. }
  686. switch (CS.getKind()) {
  687. case ConversionSpecifier::dArg:
  688. case ConversionSpecifier::DArg:
  689. case ConversionSpecifier::iArg:
  690. case ConversionSpecifier::oArg:
  691. case ConversionSpecifier::OArg:
  692. case ConversionSpecifier::uArg:
  693. case ConversionSpecifier::UArg:
  694. case ConversionSpecifier::xArg:
  695. case ConversionSpecifier::XArg:
  696. case ConversionSpecifier::nArg:
  697. case ConversionSpecifier::cArg:
  698. case ConversionSpecifier::sArg:
  699. case ConversionSpecifier::ScanListArg:
  700. case ConversionSpecifier::ZArg:
  701. return true;
  702. case ConversionSpecifier::FreeBSDrArg:
  703. case ConversionSpecifier::FreeBSDyArg:
  704. return Target.getTriple().isOSFreeBSD() || Target.getTriple().isPS4();
  705. default:
  706. return false;
  707. }
  708. case LengthModifier::AsLongDouble:
  709. switch (CS.getKind()) {
  710. case ConversionSpecifier::aArg:
  711. case ConversionSpecifier::AArg:
  712. case ConversionSpecifier::fArg:
  713. case ConversionSpecifier::FArg:
  714. case ConversionSpecifier::eArg:
  715. case ConversionSpecifier::EArg:
  716. case ConversionSpecifier::gArg:
  717. case ConversionSpecifier::GArg:
  718. return true;
  719. // GNU libc extension.
  720. case ConversionSpecifier::dArg:
  721. case ConversionSpecifier::iArg:
  722. case ConversionSpecifier::oArg:
  723. case ConversionSpecifier::uArg:
  724. case ConversionSpecifier::xArg:
  725. case ConversionSpecifier::XArg:
  726. return !Target.getTriple().isOSDarwin() &&
  727. !Target.getTriple().isOSWindows();
  728. default:
  729. return false;
  730. }
  731. case LengthModifier::AsAllocate:
  732. switch (CS.getKind()) {
  733. case ConversionSpecifier::sArg:
  734. case ConversionSpecifier::SArg:
  735. case ConversionSpecifier::ScanListArg:
  736. return true;
  737. default:
  738. return false;
  739. }
  740. case LengthModifier::AsMAllocate:
  741. switch (CS.getKind()) {
  742. case ConversionSpecifier::cArg:
  743. case ConversionSpecifier::CArg:
  744. case ConversionSpecifier::sArg:
  745. case ConversionSpecifier::SArg:
  746. case ConversionSpecifier::ScanListArg:
  747. return true;
  748. default:
  749. return false;
  750. }
  751. case LengthModifier::AsInt32:
  752. case LengthModifier::AsInt3264:
  753. case LengthModifier::AsInt64:
  754. switch (CS.getKind()) {
  755. case ConversionSpecifier::dArg:
  756. case ConversionSpecifier::iArg:
  757. case ConversionSpecifier::oArg:
  758. case ConversionSpecifier::uArg:
  759. case ConversionSpecifier::xArg:
  760. case ConversionSpecifier::XArg:
  761. return Target.getTriple().isOSMSVCRT();
  762. default:
  763. return false;
  764. }
  765. case LengthModifier::AsWide:
  766. switch (CS.getKind()) {
  767. case ConversionSpecifier::cArg:
  768. case ConversionSpecifier::CArg:
  769. case ConversionSpecifier::sArg:
  770. case ConversionSpecifier::SArg:
  771. case ConversionSpecifier::ZArg:
  772. return Target.getTriple().isOSMSVCRT();
  773. default:
  774. return false;
  775. }
  776. }
  777. llvm_unreachable("Invalid LengthModifier Kind!");
  778. }
  779. bool FormatSpecifier::hasStandardLengthModifier() const {
  780. switch (LM.getKind()) {
  781. case LengthModifier::None:
  782. case LengthModifier::AsChar:
  783. case LengthModifier::AsShort:
  784. case LengthModifier::AsLong:
  785. case LengthModifier::AsLongLong:
  786. case LengthModifier::AsIntMax:
  787. case LengthModifier::AsSizeT:
  788. case LengthModifier::AsPtrDiff:
  789. case LengthModifier::AsLongDouble:
  790. return true;
  791. case LengthModifier::AsAllocate:
  792. case LengthModifier::AsMAllocate:
  793. case LengthModifier::AsQuad:
  794. case LengthModifier::AsInt32:
  795. case LengthModifier::AsInt3264:
  796. case LengthModifier::AsInt64:
  797. case LengthModifier::AsWide:
  798. case LengthModifier::AsShortLong: // ???
  799. return false;
  800. }
  801. llvm_unreachable("Invalid LengthModifier Kind!");
  802. }
  803. bool FormatSpecifier::hasStandardConversionSpecifier(
  804. const LangOptions &LangOpt) const {
  805. switch (CS.getKind()) {
  806. case ConversionSpecifier::cArg:
  807. case ConversionSpecifier::dArg:
  808. case ConversionSpecifier::iArg:
  809. case ConversionSpecifier::oArg:
  810. case ConversionSpecifier::uArg:
  811. case ConversionSpecifier::xArg:
  812. case ConversionSpecifier::XArg:
  813. case ConversionSpecifier::fArg:
  814. case ConversionSpecifier::FArg:
  815. case ConversionSpecifier::eArg:
  816. case ConversionSpecifier::EArg:
  817. case ConversionSpecifier::gArg:
  818. case ConversionSpecifier::GArg:
  819. case ConversionSpecifier::aArg:
  820. case ConversionSpecifier::AArg:
  821. case ConversionSpecifier::sArg:
  822. case ConversionSpecifier::pArg:
  823. case ConversionSpecifier::nArg:
  824. case ConversionSpecifier::ObjCObjArg:
  825. case ConversionSpecifier::ScanListArg:
  826. case ConversionSpecifier::PercentArg:
  827. case ConversionSpecifier::PArg:
  828. return true;
  829. case ConversionSpecifier::CArg:
  830. case ConversionSpecifier::SArg:
  831. return LangOpt.ObjC;
  832. case ConversionSpecifier::InvalidSpecifier:
  833. case ConversionSpecifier::FreeBSDbArg:
  834. case ConversionSpecifier::FreeBSDDArg:
  835. case ConversionSpecifier::FreeBSDrArg:
  836. case ConversionSpecifier::FreeBSDyArg:
  837. case ConversionSpecifier::PrintErrno:
  838. case ConversionSpecifier::DArg:
  839. case ConversionSpecifier::OArg:
  840. case ConversionSpecifier::UArg:
  841. case ConversionSpecifier::ZArg:
  842. return false;
  843. }
  844. llvm_unreachable("Invalid ConversionSpecifier Kind!");
  845. }
  846. bool FormatSpecifier::hasStandardLengthConversionCombination() const {
  847. if (LM.getKind() == LengthModifier::AsLongDouble) {
  848. switch(CS.getKind()) {
  849. case ConversionSpecifier::dArg:
  850. case ConversionSpecifier::iArg:
  851. case ConversionSpecifier::oArg:
  852. case ConversionSpecifier::uArg:
  853. case ConversionSpecifier::xArg:
  854. case ConversionSpecifier::XArg:
  855. return false;
  856. default:
  857. return true;
  858. }
  859. }
  860. return true;
  861. }
  862. Optional<LengthModifier> FormatSpecifier::getCorrectedLengthModifier() const {
  863. if (CS.isAnyIntArg() || CS.getKind() == ConversionSpecifier::nArg) {
  864. if (LM.getKind() == LengthModifier::AsLongDouble ||
  865. LM.getKind() == LengthModifier::AsQuad) {
  866. LengthModifier FixedLM(LM);
  867. FixedLM.setKind(LengthModifier::AsLongLong);
  868. return FixedLM;
  869. }
  870. }
  871. return None;
  872. }
  873. bool FormatSpecifier::namedTypeToLengthModifier(QualType QT,
  874. LengthModifier &LM) {
  875. assert(isa<TypedefType>(QT) && "Expected a TypedefType");
  876. const TypedefNameDecl *Typedef = cast<TypedefType>(QT)->getDecl();
  877. for (;;) {
  878. const IdentifierInfo *Identifier = Typedef->getIdentifier();
  879. if (Identifier->getName() == "size_t") {
  880. LM.setKind(LengthModifier::AsSizeT);
  881. return true;
  882. } else if (Identifier->getName() == "ssize_t") {
  883. // Not C99, but common in Unix.
  884. LM.setKind(LengthModifier::AsSizeT);
  885. return true;
  886. } else if (Identifier->getName() == "intmax_t") {
  887. LM.setKind(LengthModifier::AsIntMax);
  888. return true;
  889. } else if (Identifier->getName() == "uintmax_t") {
  890. LM.setKind(LengthModifier::AsIntMax);
  891. return true;
  892. } else if (Identifier->getName() == "ptrdiff_t") {
  893. LM.setKind(LengthModifier::AsPtrDiff);
  894. return true;
  895. }
  896. QualType T = Typedef->getUnderlyingType();
  897. if (!isa<TypedefType>(T))
  898. break;
  899. Typedef = cast<TypedefType>(T)->getDecl();
  900. }
  901. return false;
  902. }