1 //===- lib/Support/YAMLTraits.cpp -----------------------------------------===//
2 //
3 //                             The LLVM Linker
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "llvm/Support/YAMLTraits.h"
11 #include "llvm/ADT/SmallString.h"
12 #include "llvm/ADT/Twine.h"
13 #include "llvm/Support/Casting.h"
14 #include "llvm/Support/Errc.h"
15 #include "llvm/Support/ErrorHandling.h"
16 #include "llvm/Support/Format.h"
17 #include "llvm/Support/LineIterator.h"
18 #include "llvm/Support/YAMLParser.h"
19 #include "llvm/Support/raw_ostream.h"
20 #include <cctype>
21 #include <cstring>
22 using namespace llvm;
23 using namespace yaml;
24 
25 //===----------------------------------------------------------------------===//
26 //  IO
27 //===----------------------------------------------------------------------===//
28 
29 IO::IO(void *Context) : Ctxt(Context) {
30 }
31 
32 IO::~IO() {
33 }
34 
35 void *IO::getContext() {
36   return Ctxt;
37 }
38 
39 void IO::setContext(void *Context) {
40   Ctxt = Context;
41 }
42 
43 //===----------------------------------------------------------------------===//
44 //  Input
45 //===----------------------------------------------------------------------===//
46 
47 Input::Input(StringRef InputContent, void *Ctxt,
48              SourceMgr::DiagHandlerTy DiagHandler, void *DiagHandlerCtxt)
49     : IO(Ctxt), Strm(new Stream(InputContent, SrcMgr, false, &EC)),
50       CurrentNode(nullptr) {
51   if (DiagHandler)
52     SrcMgr.setDiagHandler(DiagHandler, DiagHandlerCtxt);
53   DocIterator = Strm->begin();
54 }
55 
56 Input::~Input() {
57 }
58 
59 std::error_code Input::error() { return EC; }
60 
61 // Pin the vtables to this file.
62 void Input::HNode::anchor() {}
63 void Input::EmptyHNode::anchor() {}
64 void Input::ScalarHNode::anchor() {}
65 void Input::MapHNode::anchor() {}
66 void Input::SequenceHNode::anchor() {}
67 
68 bool Input::outputting() {
69   return false;
70 }
71 
72 bool Input::setCurrentDocument() {
73   if (DocIterator != Strm->end()) {
74     Node *N = DocIterator->getRoot();
75     if (!N) {
76       assert(Strm->failed() && "Root is NULL iff parsing failed");
77       EC = make_error_code(errc::invalid_argument);
78       return false;
79     }
80 
81     if (isa<NullNode>(N)) {
82       // Empty files are allowed and ignored
83       ++DocIterator;
84       return setCurrentDocument();
85     }
86     TopNode = this->createHNodes(N);
87     CurrentNode = TopNode.get();
88     return true;
89   }
90   return false;
91 }
92 
93 bool Input::nextDocument() {
94   return ++DocIterator != Strm->end();
95 }
96 
97 const Node *Input::getCurrentNode() const {
98   return CurrentNode ? CurrentNode->_node : nullptr;
99 }
100 
101 bool Input::mapTag(StringRef Tag, bool Default) {
102   std::string foundTag = CurrentNode->_node->getVerbatimTag();
103   if (foundTag.empty()) {
104     // If no tag found and 'Tag' is the default, say it was found.
105     return Default;
106   }
107   // Return true iff found tag matches supplied tag.
108   return Tag.equals(foundTag);
109 }
110 
111 void Input::beginMapping() {
112   if (EC)
113     return;
114   // CurrentNode can be null if the document is empty.
115   MapHNode *MN = dyn_cast_or_null<MapHNode>(CurrentNode);
116   if (MN) {
117     MN->ValidKeys.clear();
118   }
119 }
120 
121 std::vector<StringRef> Input::keys() {
122   MapHNode *MN = dyn_cast<MapHNode>(CurrentNode);
123   std::vector<StringRef> Ret;
124   if (!MN) {
125     setError(CurrentNode, "not a mapping");
126     return Ret;
127   }
128   for (auto &P : MN->Mapping)
129     Ret.push_back(P.first());
130   return Ret;
131 }
132 
133 bool Input::preflightKey(const char *Key, bool Required, bool, bool &UseDefault,
134                          void *&SaveInfo) {
135   UseDefault = false;
136   if (EC)
137     return false;
138 
139   // CurrentNode is null for empty documents, which is an error in case required
140   // nodes are present.
141   if (!CurrentNode) {
142     if (Required)
143       EC = make_error_code(errc::invalid_argument);
144     return false;
145   }
146 
147   MapHNode *MN = dyn_cast<MapHNode>(CurrentNode);
148   if (!MN) {
149     setError(CurrentNode, "not a mapping");
150     return false;
151   }
152   MN->ValidKeys.push_back(Key);
153   HNode *Value = MN->Mapping[Key].get();
154   if (!Value) {
155     if (Required)
156       setError(CurrentNode, Twine("missing required key '") + Key + "'");
157     else
158       UseDefault = true;
159     return false;
160   }
161   SaveInfo = CurrentNode;
162   CurrentNode = Value;
163   return true;
164 }
165 
166 void Input::postflightKey(void *saveInfo) {
167   CurrentNode = reinterpret_cast<HNode *>(saveInfo);
168 }
169 
170 void Input::endMapping() {
171   if (EC)
172     return;
173   // CurrentNode can be null if the document is empty.
174   MapHNode *MN = dyn_cast_or_null<MapHNode>(CurrentNode);
175   if (!MN)
176     return;
177   for (const auto &NN : MN->Mapping) {
178     if (!is_contained(MN->ValidKeys, NN.first())) {
179       setError(NN.second.get(), Twine("unknown key '") + NN.first() + "'");
180       break;
181     }
182   }
183 }
184 
185 void Input::beginFlowMapping() { beginMapping(); }
186 
187 void Input::endFlowMapping() { endMapping(); }
188 
189 unsigned Input::beginSequence() {
190   if (SequenceHNode *SQ = dyn_cast<SequenceHNode>(CurrentNode))
191     return SQ->Entries.size();
192   if (isa<EmptyHNode>(CurrentNode))
193     return 0;
194   // Treat case where there's a scalar "null" value as an empty sequence.
195   if (ScalarHNode *SN = dyn_cast<ScalarHNode>(CurrentNode)) {
196     if (isNull(SN->value()))
197       return 0;
198   }
199   // Any other type of HNode is an error.
200   setError(CurrentNode, "not a sequence");
201   return 0;
202 }
203 
204 void Input::endSequence() {
205 }
206 
207 bool Input::preflightElement(unsigned Index, void *&SaveInfo) {
208   if (EC)
209     return false;
210   if (SequenceHNode *SQ = dyn_cast<SequenceHNode>(CurrentNode)) {
211     SaveInfo = CurrentNode;
212     CurrentNode = SQ->Entries[Index].get();
213     return true;
214   }
215   return false;
216 }
217 
218 void Input::postflightElement(void *SaveInfo) {
219   CurrentNode = reinterpret_cast<HNode *>(SaveInfo);
220 }
221 
222 unsigned Input::beginFlowSequence() { return beginSequence(); }
223 
224 bool Input::preflightFlowElement(unsigned index, void *&SaveInfo) {
225   if (EC)
226     return false;
227   if (SequenceHNode *SQ = dyn_cast<SequenceHNode>(CurrentNode)) {
228     SaveInfo = CurrentNode;
229     CurrentNode = SQ->Entries[index].get();
230     return true;
231   }
232   return false;
233 }
234 
235 void Input::postflightFlowElement(void *SaveInfo) {
236   CurrentNode = reinterpret_cast<HNode *>(SaveInfo);
237 }
238 
239 void Input::endFlowSequence() {
240 }
241 
242 void Input::beginEnumScalar() {
243   ScalarMatchFound = false;
244 }
245 
246 bool Input::matchEnumScalar(const char *Str, bool) {
247   if (ScalarMatchFound)
248     return false;
249   if (ScalarHNode *SN = dyn_cast<ScalarHNode>(CurrentNode)) {
250     if (SN->value().equals(Str)) {
251       ScalarMatchFound = true;
252       return true;
253     }
254   }
255   return false;
256 }
257 
258 bool Input::matchEnumFallback() {
259   if (ScalarMatchFound)
260     return false;
261   ScalarMatchFound = true;
262   return true;
263 }
264 
265 void Input::endEnumScalar() {
266   if (!ScalarMatchFound) {
267     setError(CurrentNode, "unknown enumerated scalar");
268   }
269 }
270 
271 bool Input::beginBitSetScalar(bool &DoClear) {
272   BitValuesUsed.clear();
273   if (SequenceHNode *SQ = dyn_cast<SequenceHNode>(CurrentNode)) {
274     BitValuesUsed.insert(BitValuesUsed.begin(), SQ->Entries.size(), false);
275   } else {
276     setError(CurrentNode, "expected sequence of bit values");
277   }
278   DoClear = true;
279   return true;
280 }
281 
282 bool Input::bitSetMatch(const char *Str, bool) {
283   if (EC)
284     return false;
285   if (SequenceHNode *SQ = dyn_cast<SequenceHNode>(CurrentNode)) {
286     unsigned Index = 0;
287     for (auto &N : SQ->Entries) {
288       if (ScalarHNode *SN = dyn_cast<ScalarHNode>(N.get())) {
289         if (SN->value().equals(Str)) {
290           BitValuesUsed[Index] = true;
291           return true;
292         }
293       } else {
294         setError(CurrentNode, "unexpected scalar in sequence of bit values");
295       }
296       ++Index;
297     }
298   } else {
299     setError(CurrentNode, "expected sequence of bit values");
300   }
301   return false;
302 }
303 
304 void Input::endBitSetScalar() {
305   if (EC)
306     return;
307   if (SequenceHNode *SQ = dyn_cast<SequenceHNode>(CurrentNode)) {
308     assert(BitValuesUsed.size() == SQ->Entries.size());
309     for (unsigned i = 0; i < SQ->Entries.size(); ++i) {
310       if (!BitValuesUsed[i]) {
311         setError(SQ->Entries[i].get(), "unknown bit value");
312         return;
313       }
314     }
315   }
316 }
317 
318 void Input::scalarString(StringRef &S, bool) {
319   if (ScalarHNode *SN = dyn_cast<ScalarHNode>(CurrentNode)) {
320     S = SN->value();
321   } else {
322     setError(CurrentNode, "unexpected scalar");
323   }
324 }
325 
326 void Input::blockScalarString(StringRef &S) { scalarString(S, false); }
327 
328 void Input::setError(HNode *hnode, const Twine &message) {
329   assert(hnode && "HNode must not be NULL");
330   this->setError(hnode->_node, message);
331 }
332 
333 void Input::setError(Node *node, const Twine &message) {
334   Strm->printError(node, message);
335   EC = make_error_code(errc::invalid_argument);
336 }
337 
338 std::unique_ptr<Input::HNode> Input::createHNodes(Node *N) {
339   SmallString<128> StringStorage;
340   if (ScalarNode *SN = dyn_cast<ScalarNode>(N)) {
341     StringRef KeyStr = SN->getValue(StringStorage);
342     if (!StringStorage.empty()) {
343       // Copy string to permanent storage
344       KeyStr = StringStorage.str().copy(StringAllocator);
345     }
346     return llvm::make_unique<ScalarHNode>(N, KeyStr);
347   } else if (BlockScalarNode *BSN = dyn_cast<BlockScalarNode>(N)) {
348     StringRef ValueCopy = BSN->getValue().copy(StringAllocator);
349     return llvm::make_unique<ScalarHNode>(N, ValueCopy);
350   } else if (SequenceNode *SQ = dyn_cast<SequenceNode>(N)) {
351     auto SQHNode = llvm::make_unique<SequenceHNode>(N);
352     for (Node &SN : *SQ) {
353       auto Entry = this->createHNodes(&SN);
354       if (EC)
355         break;
356       SQHNode->Entries.push_back(std::move(Entry));
357     }
358     return std::move(SQHNode);
359   } else if (MappingNode *Map = dyn_cast<MappingNode>(N)) {
360     auto mapHNode = llvm::make_unique<MapHNode>(N);
361     for (KeyValueNode &KVN : *Map) {
362       Node *KeyNode = KVN.getKey();
363       ScalarNode *KeyScalar = dyn_cast<ScalarNode>(KeyNode);
364       if (!KeyScalar) {
365         setError(KeyNode, "Map key must be a scalar");
366         break;
367       }
368       StringStorage.clear();
369       StringRef KeyStr = KeyScalar->getValue(StringStorage);
370       if (!StringStorage.empty()) {
371         // Copy string to permanent storage
372         KeyStr = StringStorage.str().copy(StringAllocator);
373       }
374       auto ValueHNode = this->createHNodes(KVN.getValue());
375       if (EC)
376         break;
377       mapHNode->Mapping[KeyStr] = std::move(ValueHNode);
378     }
379     return std::move(mapHNode);
380   } else if (isa<NullNode>(N)) {
381     return llvm::make_unique<EmptyHNode>(N);
382   } else {
383     setError(N, "unknown node kind");
384     return nullptr;
385   }
386 }
387 
388 void Input::setError(const Twine &Message) {
389   this->setError(CurrentNode, Message);
390 }
391 
392 bool Input::canElideEmptySequence() {
393   return false;
394 }
395 
396 //===----------------------------------------------------------------------===//
397 //  Output
398 //===----------------------------------------------------------------------===//
399 
400 Output::Output(raw_ostream &yout, void *context, int WrapColumn)
401     : IO(context), Out(yout), WrapColumn(WrapColumn), Column(0),
402       ColumnAtFlowStart(0), ColumnAtMapFlowStart(0), NeedBitValueComma(false),
403       NeedFlowSequenceComma(false), EnumerationMatchFound(false),
404       NeedsNewLine(false), WriteDefaultValues(false) {}
405 
406 Output::~Output() {
407 }
408 
409 bool Output::outputting() {
410   return true;
411 }
412 
413 void Output::beginMapping() {
414   StateStack.push_back(inMapFirstKey);
415   NeedsNewLine = true;
416 }
417 
418 bool Output::mapTag(StringRef Tag, bool Use) {
419   if (Use) {
420     // If this tag is being written inside a sequence we should write the start
421     // of the sequence before writing the tag, otherwise the tag won't be
422     // attached to the element in the sequence, but rather the sequence itself.
423     bool SequenceElement =
424         StateStack.size() > 1 && (StateStack[StateStack.size() - 2] == inSeq ||
425           StateStack[StateStack.size() - 2] == inFlowSeq);
426     if (SequenceElement && StateStack.back() == inMapFirstKey) {
427       this->newLineCheck();
428     } else {
429       this->output(" ");
430     }
431     this->output(Tag);
432     if (SequenceElement) {
433       // If we're writing the tag during the first element of a map, the tag
434       // takes the place of the first element in the sequence.
435       if (StateStack.back() == inMapFirstKey) {
436         StateStack.pop_back();
437         StateStack.push_back(inMapOtherKey);
438       }
439       // Tags inside maps in sequences should act as keys in the map from a
440       // formatting perspective, so we always want a newline in a sequence.
441       NeedsNewLine = true;
442     }
443   }
444   return Use;
445 }
446 
447 void Output::endMapping() {
448   StateStack.pop_back();
449 }
450 
451 std::vector<StringRef> Output::keys() {
452   report_fatal_error("invalid call");
453 }
454 
455 bool Output::preflightKey(const char *Key, bool Required, bool SameAsDefault,
456                           bool &UseDefault, void *&) {
457   UseDefault = false;
458   if (Required || !SameAsDefault || WriteDefaultValues) {
459     auto State = StateStack.back();
460     if (State == inFlowMapFirstKey || State == inFlowMapOtherKey) {
461       flowKey(Key);
462     } else {
463       this->newLineCheck();
464       this->paddedKey(Key);
465     }
466     return true;
467   }
468   return false;
469 }
470 
471 void Output::postflightKey(void *) {
472   if (StateStack.back() == inMapFirstKey) {
473     StateStack.pop_back();
474     StateStack.push_back(inMapOtherKey);
475   } else if (StateStack.back() == inFlowMapFirstKey) {
476     StateStack.pop_back();
477     StateStack.push_back(inFlowMapOtherKey);
478   }
479 }
480 
481 void Output::beginFlowMapping() {
482   StateStack.push_back(inFlowMapFirstKey);
483   this->newLineCheck();
484   ColumnAtMapFlowStart = Column;
485   output("{ ");
486 }
487 
488 void Output::endFlowMapping() {
489   StateStack.pop_back();
490   this->outputUpToEndOfLine(" }");
491 }
492 
493 void Output::beginDocuments() {
494   this->outputUpToEndOfLine("---");
495 }
496 
497 bool Output::preflightDocument(unsigned index) {
498   if (index > 0)
499     this->outputUpToEndOfLine("\n---");
500   return true;
501 }
502 
503 void Output::postflightDocument() {
504 }
505 
506 void Output::endDocuments() {
507   output("\n...\n");
508 }
509 
510 unsigned Output::beginSequence() {
511   StateStack.push_back(inSeq);
512   NeedsNewLine = true;
513   return 0;
514 }
515 
516 void Output::endSequence() {
517   StateStack.pop_back();
518 }
519 
520 bool Output::preflightElement(unsigned, void *&) {
521   return true;
522 }
523 
524 void Output::postflightElement(void *) {
525 }
526 
527 unsigned Output::beginFlowSequence() {
528   StateStack.push_back(inFlowSeq);
529   this->newLineCheck();
530   ColumnAtFlowStart = Column;
531   output("[ ");
532   NeedFlowSequenceComma = false;
533   return 0;
534 }
535 
536 void Output::endFlowSequence() {
537   StateStack.pop_back();
538   this->outputUpToEndOfLine(" ]");
539 }
540 
541 bool Output::preflightFlowElement(unsigned, void *&) {
542   if (NeedFlowSequenceComma)
543     output(", ");
544   if (WrapColumn && Column > WrapColumn) {
545     output("\n");
546     for (int i = 0; i < ColumnAtFlowStart; ++i)
547       output(" ");
548     Column = ColumnAtFlowStart;
549     output("  ");
550   }
551   return true;
552 }
553 
554 void Output::postflightFlowElement(void *) {
555   NeedFlowSequenceComma = true;
556 }
557 
558 void Output::beginEnumScalar() {
559   EnumerationMatchFound = false;
560 }
561 
562 bool Output::matchEnumScalar(const char *Str, bool Match) {
563   if (Match && !EnumerationMatchFound) {
564     this->newLineCheck();
565     this->outputUpToEndOfLine(Str);
566     EnumerationMatchFound = true;
567   }
568   return false;
569 }
570 
571 bool Output::matchEnumFallback() {
572   if (EnumerationMatchFound)
573     return false;
574   EnumerationMatchFound = true;
575   return true;
576 }
577 
578 void Output::endEnumScalar() {
579   if (!EnumerationMatchFound)
580     llvm_unreachable("bad runtime enum value");
581 }
582 
583 bool Output::beginBitSetScalar(bool &DoClear) {
584   this->newLineCheck();
585   output("[ ");
586   NeedBitValueComma = false;
587   DoClear = false;
588   return true;
589 }
590 
591 bool Output::bitSetMatch(const char *Str, bool Matches) {
592   if (Matches) {
593     if (NeedBitValueComma)
594       output(", ");
595     this->output(Str);
596     NeedBitValueComma = true;
597   }
598   return false;
599 }
600 
601 void Output::endBitSetScalar() {
602   this->outputUpToEndOfLine(" ]");
603 }
604 
605 void Output::scalarString(StringRef &S, bool MustQuote) {
606   this->newLineCheck();
607   if (S.empty()) {
608     // Print '' for the empty string because leaving the field empty is not
609     // allowed.
610     this->outputUpToEndOfLine("''");
611     return;
612   }
613   if (!MustQuote) {
614     // Only quote if we must.
615     this->outputUpToEndOfLine(S);
616     return;
617   }
618   unsigned i = 0;
619   unsigned j = 0;
620   unsigned End = S.size();
621   output("'"); // Starting single quote.
622   const char *Base = S.data();
623   while (j < End) {
624     // Escape a single quote by doubling it.
625     if (S[j] == '\'') {
626       output(StringRef(&Base[i], j - i + 1));
627       output("'");
628       i = j + 1;
629     }
630     ++j;
631   }
632   output(StringRef(&Base[i], j - i));
633   this->outputUpToEndOfLine("'"); // Ending single quote.
634 }
635 
636 void Output::blockScalarString(StringRef &S) {
637   if (!StateStack.empty())
638     newLineCheck();
639   output(" |");
640   outputNewLine();
641 
642   unsigned Indent = StateStack.empty() ? 1 : StateStack.size();
643 
644   auto Buffer = MemoryBuffer::getMemBuffer(S, "", false);
645   for (line_iterator Lines(*Buffer, false); !Lines.is_at_end(); ++Lines) {
646     for (unsigned I = 0; I < Indent; ++I) {
647       output("  ");
648     }
649     output(*Lines);
650     outputNewLine();
651   }
652 }
653 
654 void Output::setError(const Twine &message) {
655 }
656 
657 bool Output::canElideEmptySequence() {
658   // Normally, with an optional key/value where the value is an empty sequence,
659   // the whole key/value can be not written.  But, that produces wrong yaml
660   // if the key/value is the only thing in the map and the map is used in
661   // a sequence.  This detects if the this sequence is the first key/value
662   // in map that itself is embedded in a sequnce.
663   if (StateStack.size() < 2)
664     return true;
665   if (StateStack.back() != inMapFirstKey)
666     return true;
667   return (StateStack[StateStack.size()-2] != inSeq);
668 }
669 
670 void Output::output(StringRef s) {
671   Column += s.size();
672   Out << s;
673 }
674 
675 void Output::outputUpToEndOfLine(StringRef s) {
676   this->output(s);
677   if (StateStack.empty() || (StateStack.back() != inFlowSeq &&
678                              StateStack.back() != inFlowMapFirstKey &&
679                              StateStack.back() != inFlowMapOtherKey))
680     NeedsNewLine = true;
681 }
682 
683 void Output::outputNewLine() {
684   Out << "\n";
685   Column = 0;
686 }
687 
688 // if seq at top, indent as if map, then add "- "
689 // if seq in middle, use "- " if firstKey, else use "  "
690 //
691 
692 void Output::newLineCheck() {
693   if (!NeedsNewLine)
694     return;
695   NeedsNewLine = false;
696 
697   this->outputNewLine();
698 
699   assert(StateStack.size() > 0);
700   unsigned Indent = StateStack.size() - 1;
701   bool OutputDash = false;
702 
703   if (StateStack.back() == inSeq) {
704     OutputDash = true;
705   } else if ((StateStack.size() > 1) && ((StateStack.back() == inMapFirstKey) ||
706              (StateStack.back() == inFlowSeq) ||
707              (StateStack.back() == inFlowMapFirstKey)) &&
708              (StateStack[StateStack.size() - 2] == inSeq)) {
709     --Indent;
710     OutputDash = true;
711   }
712 
713   for (unsigned i = 0; i < Indent; ++i) {
714     output("  ");
715   }
716   if (OutputDash) {
717     output("- ");
718   }
719 
720 }
721 
722 void Output::paddedKey(StringRef key) {
723   output(key);
724   output(":");
725   const char *spaces = "                ";
726   if (key.size() < strlen(spaces))
727     output(&spaces[key.size()]);
728   else
729     output(" ");
730 }
731 
732 void Output::flowKey(StringRef Key) {
733   if (StateStack.back() == inFlowMapOtherKey)
734     output(", ");
735   if (WrapColumn && Column > WrapColumn) {
736     output("\n");
737     for (int I = 0; I < ColumnAtMapFlowStart; ++I)
738       output(" ");
739     Column = ColumnAtMapFlowStart;
740     output("  ");
741   }
742   output(Key);
743   output(": ");
744 }
745 
746 //===----------------------------------------------------------------------===//
747 //  traits for built-in types
748 //===----------------------------------------------------------------------===//
749 
750 void ScalarTraits<bool>::output(const bool &Val, void *, raw_ostream &Out) {
751   Out << (Val ? "true" : "false");
752 }
753 
754 StringRef ScalarTraits<bool>::input(StringRef Scalar, void *, bool &Val) {
755   if (Scalar.equals("true")) {
756     Val = true;
757     return StringRef();
758   } else if (Scalar.equals("false")) {
759     Val = false;
760     return StringRef();
761   }
762   return "invalid boolean";
763 }
764 
765 void ScalarTraits<StringRef>::output(const StringRef &Val, void *,
766                                      raw_ostream &Out) {
767   Out << Val;
768 }
769 
770 StringRef ScalarTraits<StringRef>::input(StringRef Scalar, void *,
771                                          StringRef &Val) {
772   Val = Scalar;
773   return StringRef();
774 }
775 
776 void ScalarTraits<std::string>::output(const std::string &Val, void *,
777                                      raw_ostream &Out) {
778   Out << Val;
779 }
780 
781 StringRef ScalarTraits<std::string>::input(StringRef Scalar, void *,
782                                          std::string &Val) {
783   Val = Scalar.str();
784   return StringRef();
785 }
786 
787 void ScalarTraits<uint8_t>::output(const uint8_t &Val, void *,
788                                    raw_ostream &Out) {
789   // use temp uin32_t because ostream thinks uint8_t is a character
790   uint32_t Num = Val;
791   Out << Num;
792 }
793 
794 StringRef ScalarTraits<uint8_t>::input(StringRef Scalar, void *, uint8_t &Val) {
795   unsigned long long n;
796   if (getAsUnsignedInteger(Scalar, 0, n))
797     return "invalid number";
798   if (n > 0xFF)
799     return "out of range number";
800   Val = n;
801   return StringRef();
802 }
803 
804 void ScalarTraits<uint16_t>::output(const uint16_t &Val, void *,
805                                     raw_ostream &Out) {
806   Out << Val;
807 }
808 
809 StringRef ScalarTraits<uint16_t>::input(StringRef Scalar, void *,
810                                         uint16_t &Val) {
811   unsigned long long n;
812   if (getAsUnsignedInteger(Scalar, 0, n))
813     return "invalid number";
814   if (n > 0xFFFF)
815     return "out of range number";
816   Val = n;
817   return StringRef();
818 }
819 
820 void ScalarTraits<uint32_t>::output(const uint32_t &Val, void *,
821                                     raw_ostream &Out) {
822   Out << Val;
823 }
824 
825 StringRef ScalarTraits<uint32_t>::input(StringRef Scalar, void *,
826                                         uint32_t &Val) {
827   unsigned long long n;
828   if (getAsUnsignedInteger(Scalar, 0, n))
829     return "invalid number";
830   if (n > 0xFFFFFFFFUL)
831     return "out of range number";
832   Val = n;
833   return StringRef();
834 }
835 
836 void ScalarTraits<uint64_t>::output(const uint64_t &Val, void *,
837                                     raw_ostream &Out) {
838   Out << Val;
839 }
840 
841 StringRef ScalarTraits<uint64_t>::input(StringRef Scalar, void *,
842                                         uint64_t &Val) {
843   unsigned long long N;
844   if (getAsUnsignedInteger(Scalar, 0, N))
845     return "invalid number";
846   Val = N;
847   return StringRef();
848 }
849 
850 void ScalarTraits<int8_t>::output(const int8_t &Val, void *, raw_ostream &Out) {
851   // use temp in32_t because ostream thinks int8_t is a character
852   int32_t Num = Val;
853   Out << Num;
854 }
855 
856 StringRef ScalarTraits<int8_t>::input(StringRef Scalar, void *, int8_t &Val) {
857   long long N;
858   if (getAsSignedInteger(Scalar, 0, N))
859     return "invalid number";
860   if ((N > 127) || (N < -128))
861     return "out of range number";
862   Val = N;
863   return StringRef();
864 }
865 
866 void ScalarTraits<int16_t>::output(const int16_t &Val, void *,
867                                    raw_ostream &Out) {
868   Out << Val;
869 }
870 
871 StringRef ScalarTraits<int16_t>::input(StringRef Scalar, void *, int16_t &Val) {
872   long long N;
873   if (getAsSignedInteger(Scalar, 0, N))
874     return "invalid number";
875   if ((N > INT16_MAX) || (N < INT16_MIN))
876     return "out of range number";
877   Val = N;
878   return StringRef();
879 }
880 
881 void ScalarTraits<int32_t>::output(const int32_t &Val, void *,
882                                    raw_ostream &Out) {
883   Out << Val;
884 }
885 
886 StringRef ScalarTraits<int32_t>::input(StringRef Scalar, void *, int32_t &Val) {
887   long long N;
888   if (getAsSignedInteger(Scalar, 0, N))
889     return "invalid number";
890   if ((N > INT32_MAX) || (N < INT32_MIN))
891     return "out of range number";
892   Val = N;
893   return StringRef();
894 }
895 
896 void ScalarTraits<int64_t>::output(const int64_t &Val, void *,
897                                    raw_ostream &Out) {
898   Out << Val;
899 }
900 
901 StringRef ScalarTraits<int64_t>::input(StringRef Scalar, void *, int64_t &Val) {
902   long long N;
903   if (getAsSignedInteger(Scalar, 0, N))
904     return "invalid number";
905   Val = N;
906   return StringRef();
907 }
908 
909 void ScalarTraits<double>::output(const double &Val, void *, raw_ostream &Out) {
910   Out << format("%g", Val);
911 }
912 
913 StringRef ScalarTraits<double>::input(StringRef Scalar, void *, double &Val) {
914   SmallString<32> buff(Scalar.begin(), Scalar.end());
915   char *end;
916   Val = strtod(buff.c_str(), &end);
917   if (*end != '\0')
918     return "invalid floating point number";
919   return StringRef();
920 }
921 
922 void ScalarTraits<float>::output(const float &Val, void *, raw_ostream &Out) {
923   Out << format("%g", Val);
924 }
925 
926 StringRef ScalarTraits<float>::input(StringRef Scalar, void *, float &Val) {
927   SmallString<32> buff(Scalar.begin(), Scalar.end());
928   char *end;
929   Val = strtod(buff.c_str(), &end);
930   if (*end != '\0')
931     return "invalid floating point number";
932   return StringRef();
933 }
934 
935 void ScalarTraits<Hex8>::output(const Hex8 &Val, void *, raw_ostream &Out) {
936   uint8_t Num = Val;
937   Out << format("0x%02X", Num);
938 }
939 
940 StringRef ScalarTraits<Hex8>::input(StringRef Scalar, void *, Hex8 &Val) {
941   unsigned long long n;
942   if (getAsUnsignedInteger(Scalar, 0, n))
943     return "invalid hex8 number";
944   if (n > 0xFF)
945     return "out of range hex8 number";
946   Val = n;
947   return StringRef();
948 }
949 
950 void ScalarTraits<Hex16>::output(const Hex16 &Val, void *, raw_ostream &Out) {
951   uint16_t Num = Val;
952   Out << format("0x%04X", Num);
953 }
954 
955 StringRef ScalarTraits<Hex16>::input(StringRef Scalar, void *, Hex16 &Val) {
956   unsigned long long n;
957   if (getAsUnsignedInteger(Scalar, 0, n))
958     return "invalid hex16 number";
959   if (n > 0xFFFF)
960     return "out of range hex16 number";
961   Val = n;
962   return StringRef();
963 }
964 
965 void ScalarTraits<Hex32>::output(const Hex32 &Val, void *, raw_ostream &Out) {
966   uint32_t Num = Val;
967   Out << format("0x%08X", Num);
968 }
969 
970 StringRef ScalarTraits<Hex32>::input(StringRef Scalar, void *, Hex32 &Val) {
971   unsigned long long n;
972   if (getAsUnsignedInteger(Scalar, 0, n))
973     return "invalid hex32 number";
974   if (n > 0xFFFFFFFFUL)
975     return "out of range hex32 number";
976   Val = n;
977   return StringRef();
978 }
979 
980 void ScalarTraits<Hex64>::output(const Hex64 &Val, void *, raw_ostream &Out) {
981   uint64_t Num = Val;
982   Out << format("0x%016llX", Num);
983 }
984 
985 StringRef ScalarTraits<Hex64>::input(StringRef Scalar, void *, Hex64 &Val) {
986   unsigned long long Num;
987   if (getAsUnsignedInteger(Scalar, 0, Num))
988     return "invalid hex64 number";
989   Val = Num;
990   return StringRef();
991 }
992