forked from qt-creator/qt-creator
		
	... as structured bindings.
Also add a safety check to Bind that might be needed for invalid code.
Amends ca00b874a7.
Change-Id: I7b174b80ad97ed7424f1e369b876c99acf7e95d2
Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Christian Stenger <christian.stenger@qt.io>
		
	
		
			
				
	
	
		
			349 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			349 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
// Copyright (c) 2008 Roberto Raggi <roberto.raggi@gmail.com>
 | 
						|
//
 | 
						|
// Permission is hereby granted, free of charge, to any person obtaining a copy
 | 
						|
// of this software and associated documentation files (the "Software"), to deal
 | 
						|
// in the Software without restriction, including without limitation the rights
 | 
						|
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 | 
						|
// copies of the Software, and to permit persons to whom the Software is
 | 
						|
// furnished to do so, subject to the following conditions:
 | 
						|
//
 | 
						|
// The above copyright notice and this permission notice shall be included in
 | 
						|
// all copies or substantial portions of the Software.
 | 
						|
//
 | 
						|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 | 
						|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 | 
						|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 | 
						|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 | 
						|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 | 
						|
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 | 
						|
// THE SOFTWARE.
 | 
						|
 | 
						|
#pragma once
 | 
						|
 | 
						|
#include "CPlusPlusForwardDeclarations.h"
 | 
						|
#include "ASTfwd.h"
 | 
						|
#include "Token.h"
 | 
						|
#include "TranslationUnit.h"
 | 
						|
#include "MemoryPool.h"
 | 
						|
#include <map>
 | 
						|
#include <stack>
 | 
						|
 | 
						|
namespace CPlusPlus {
 | 
						|
 | 
						|
class CPLUSPLUS_EXPORT Parser
 | 
						|
{
 | 
						|
public:
 | 
						|
    Parser(TranslationUnit *translationUnit);
 | 
						|
    ~Parser();
 | 
						|
 | 
						|
    bool parseTranslationUnit(TranslationUnitAST *&node);
 | 
						|
 | 
						|
public:
 | 
						|
    bool parseExpressionList(ExpressionListAST *&node);
 | 
						|
    bool parseAbstractCoreDeclarator(DeclaratorAST *&node, SpecifierListAST *decl_specifier_list);
 | 
						|
    bool parseAbstractDeclarator(DeclaratorAST *&node, SpecifierListAST *decl_specifier_list);
 | 
						|
    bool parseEmptyDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseAccessDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseQtPropertyDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseQtEnumDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseQtFlags(DeclarationAST *&node);
 | 
						|
    bool parseQtInterfaces(DeclarationAST *&node);
 | 
						|
    bool parseAdditiveExpression(ExpressionAST *&node);
 | 
						|
    bool parseAndExpression(ExpressionAST *&node);
 | 
						|
    bool parseAsmDefinition(DeclarationAST *&node);
 | 
						|
    bool parseAsmOperandList();
 | 
						|
    bool parseAsmOperand();
 | 
						|
    bool parseAsmClobberList();
 | 
						|
    bool parseAssignmentExpression(ExpressionAST *&node);
 | 
						|
    bool parseBaseClause(BaseSpecifierListAST *&node);
 | 
						|
    bool parseBaseSpecifier(BaseSpecifierListAST *&node);
 | 
						|
    bool parseBlockDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseCppCastExpression(ExpressionAST *&node);
 | 
						|
    bool parseCastExpression(ExpressionAST *&node);
 | 
						|
    bool parseClassSpecifier(SpecifierListAST *&node);
 | 
						|
    bool parseCommaExpression(ExpressionAST *&node);
 | 
						|
    bool parseCompoundStatement(StatementAST *&node);
 | 
						|
    bool parseBreakStatement(StatementAST *&node);
 | 
						|
    bool parseContinueStatement(StatementAST *&node);
 | 
						|
    bool parseGotoStatement(StatementAST *&node);
 | 
						|
    bool parseReturnStatement(StatementAST *&node);
 | 
						|
    bool parseCondition(ExpressionAST *&node);
 | 
						|
    bool parseConditionalExpression(ExpressionAST *&node);
 | 
						|
    bool parseConstantExpression(ExpressionAST *&node);
 | 
						|
    bool parseCtorInitializer(CtorInitializerAST *&node);
 | 
						|
    bool parseCvQualifiers(SpecifierListAST *&node);
 | 
						|
    bool parseRefQualifier(int &ref_qualifier);
 | 
						|
    bool parseOverrideFinalQualifiers(SpecifierListAST *&node);
 | 
						|
    bool parseDeclaratorOrAbstractDeclarator(DeclaratorAST *&node, SpecifierListAST *decl_specifier_list);
 | 
						|
    bool parseDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseSimpleDeclaration(DeclarationAST *&node, ClassSpecifierAST *declaringClass = nullptr);
 | 
						|
    bool parseDeclarationStatement(StatementAST *&node);
 | 
						|
    bool parseCoreDeclarator(DeclaratorAST *&node, SpecifierListAST *decl_specifier_list, ClassSpecifierAST *declaringClass);
 | 
						|
    DecompositionDeclaratorAST *parseDecompositionDeclarator(SpecifierListAST *decl_specifier_list);
 | 
						|
    bool parseDeclarator(DeclaratorAST *&node, SpecifierListAST *decl_specifier_list, ClassSpecifierAST *declaringClass = nullptr);
 | 
						|
    bool parseDeleteExpression(ExpressionAST *&node);
 | 
						|
    bool parseDoStatement(StatementAST *&node);
 | 
						|
    bool parseElaboratedTypeSpecifier(SpecifierListAST *&node);
 | 
						|
    bool parseEnumSpecifier(SpecifierListAST *&node);
 | 
						|
    bool parseEnumerator(EnumeratorListAST *&node);
 | 
						|
    bool parseEqualityExpression(ExpressionAST *&node);
 | 
						|
    bool parseExceptionDeclaration(ExceptionDeclarationAST *&node);
 | 
						|
    bool parseExceptionSpecification(ExceptionSpecificationAST *&node);
 | 
						|
    bool parseExclusiveOrExpression(ExpressionAST *&node);
 | 
						|
    bool parseExpression(ExpressionAST *&node);
 | 
						|
    bool parseExpressionOrDeclarationStatement(StatementAST *&node);
 | 
						|
    bool parseExpressionStatement(StatementAST *&node);
 | 
						|
    bool parseForInitStatement(StatementAST *&node);
 | 
						|
    bool parseForeachStatement(StatementAST *&node);
 | 
						|
    bool parseForStatement(StatementAST *&node);
 | 
						|
    bool parseFunctionBody(StatementAST *&node);
 | 
						|
    bool parseIfStatement(StatementAST *&node);
 | 
						|
    bool parseInclusiveOrExpression(ExpressionAST *&node);
 | 
						|
    bool parseInitDeclarator(DeclaratorAST *&node, SpecifierListAST *decl_specifier_list, ClassSpecifierAST *declaringClass);
 | 
						|
    bool parseInitializerList(ExpressionListAST *&node);
 | 
						|
    bool parseInitializer(ExpressionAST *&node, int *equals_token);
 | 
						|
    bool parseInitializerClause(ExpressionAST *&node);
 | 
						|
    bool parseLabeledStatement(StatementAST *&node);
 | 
						|
    bool parseLinkageBody(DeclarationAST *&node);
 | 
						|
    bool parseLinkageSpecification(DeclarationAST *&node);
 | 
						|
    bool parseLogicalAndExpression(ExpressionAST *&node);
 | 
						|
    bool parseLogicalOrExpression(ExpressionAST *&node);
 | 
						|
    bool parseMemInitializer(MemInitializerListAST *&node);
 | 
						|
    bool parseMemInitializerList(MemInitializerListAST *&node);
 | 
						|
    bool parseMemberSpecification(DeclarationAST *&node, ClassSpecifierAST *declaringClass);
 | 
						|
    bool parseMultiplicativeExpression(ExpressionAST *&node);
 | 
						|
    bool parseTemplateId(NameAST *&node, int template_token = 0);
 | 
						|
    bool parseClassOrNamespaceName(NameAST *&node);
 | 
						|
    bool parseNameId(NameAST *&node);
 | 
						|
    bool parseName(NameAST *&node, bool acceptTemplateId = true);
 | 
						|
    bool parseNestedNameSpecifier(NestedNameSpecifierListAST *&node, bool acceptTemplateId);
 | 
						|
    bool parseNestedNameSpecifierOpt(NestedNameSpecifierListAST *&name, bool acceptTemplateId);
 | 
						|
    bool parseStaticAssertDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseNamespace(DeclarationAST *&node);
 | 
						|
    bool parseNestedNamespace(DeclarationAST *&node);
 | 
						|
    bool parseNamespaceAliasDefinition(DeclarationAST *&node);
 | 
						|
    bool parseNewArrayDeclarator(NewArrayDeclaratorListAST *&node);
 | 
						|
    bool parseNewExpression(ExpressionAST *&node);
 | 
						|
    bool parseExpressionListParen(ExpressionAST *&node);
 | 
						|
    bool parseNewInitializer(ExpressionAST *&node);
 | 
						|
    bool parseNewTypeId(NewTypeIdAST *&node);
 | 
						|
    bool parseOperator(OperatorAST *&node);
 | 
						|
    bool parseConversionFunctionId(NameAST *&node);
 | 
						|
    bool parseOperatorFunctionId(NameAST *&node);
 | 
						|
    bool parseParameterDeclaration(ParameterDeclarationAST *&node);
 | 
						|
    bool parseParameterDeclarationClause(ParameterDeclarationClauseAST *&node);
 | 
						|
    bool parseParameterDeclarationList(ParameterDeclarationListAST *&node);
 | 
						|
    bool parsePmExpression(ExpressionAST *&node);
 | 
						|
    bool parseTypeidExpression(ExpressionAST *&node);
 | 
						|
    bool parseTypenameCallExpression(ExpressionAST *&node);
 | 
						|
    bool parseCorePostfixExpression(ExpressionAST *&node);
 | 
						|
    bool parsePostfixExpression(ExpressionAST *&node);
 | 
						|
    bool parsePrimaryExpression(ExpressionAST *&node);
 | 
						|
    bool parseNestedExpression(ExpressionAST *&node);
 | 
						|
    bool parsePtrOperator(PtrOperatorListAST *&node);
 | 
						|
    bool parseRelationalExpression(ExpressionAST *&node);
 | 
						|
    bool parseShiftExpression(ExpressionAST *&node);
 | 
						|
    bool parseStatement(StatementAST *&node, bool blockLabeledStatement = false);
 | 
						|
    bool parseThisExpression(ExpressionAST *&node);
 | 
						|
    bool parseBoolLiteral(ExpressionAST *&node);
 | 
						|
    bool parseNumericLiteral(ExpressionAST *&node);
 | 
						|
    bool parsePointerLiteral(ExpressionAST *&node);
 | 
						|
    bool parseStringLiteral(ExpressionAST *&node);
 | 
						|
    bool parseSwitchStatement(StatementAST *&node);
 | 
						|
    bool parseTemplateArgument(ExpressionAST *&node);
 | 
						|
    bool parseTemplateArgumentList(ExpressionListAST *&node);
 | 
						|
    bool parseTemplateDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseTemplateParameter(DeclarationAST *&node);
 | 
						|
    bool parseTemplateParameterList(DeclarationListAST *&node);
 | 
						|
    bool parseThrowExpression(ExpressionAST *&node);
 | 
						|
    bool parseNoExceptOperatorExpression(ExpressionAST *&node);
 | 
						|
    bool parseTryBlockStatement(StatementAST *&node, CtorInitializerAST **placeholder);
 | 
						|
    bool parseCatchClause(CatchClauseListAST *&node);
 | 
						|
    bool parseTypeId(ExpressionAST *&node);
 | 
						|
    bool parseTypeIdList(ExpressionListAST *&node);
 | 
						|
    bool parseTypenameTypeParameter(DeclarationAST *&node);
 | 
						|
    bool parseTemplateTypeParameter(DeclarationAST *&node);
 | 
						|
    bool parseTypeParameter(DeclarationAST *&node);
 | 
						|
 | 
						|
    bool parseBuiltinTypeSpecifier(SpecifierListAST *&node);
 | 
						|
    bool parseOptionalAttributeSpecifierSequence(SpecifierListAST *&attribute_list);
 | 
						|
    bool parseAttributeSpecifier(SpecifierListAST *&attribute_list);
 | 
						|
    bool parseGnuAttributeSpecifier(SpecifierListAST *&node);
 | 
						|
    bool parseGnuAttributeList(GnuAttributeListAST *&node);
 | 
						|
 | 
						|
    bool parseMsvcDeclspecSpecifier(SpecifierListAST *&node);
 | 
						|
    bool parseStdAttributeSpecifier(SpecifierListAST *&node);
 | 
						|
 | 
						|
    bool parseDeclSpecifierSeq(SpecifierListAST *&node,
 | 
						|
                               bool noStorageSpecifiers = false,
 | 
						|
                               bool onlySimpleTypeSpecifiers = false);
 | 
						|
 | 
						|
    bool parseTrailingTypeSpecifierSeq(SpecifierListAST *&node)
 | 
						|
    { return parseDeclSpecifierSeq(node, true); }
 | 
						|
    /// This actually parses a trailing-type-specifier sequence
 | 
						|
    bool parseTypeSpecifier(SpecifierListAST *&node)
 | 
						|
    { return parseTrailingTypeSpecifierSeq(node); }
 | 
						|
    bool parseSimpleTypeSpecifier(SpecifierListAST *&node)
 | 
						|
    { return parseDeclSpecifierSeq(node, true, true); }
 | 
						|
 | 
						|
    bool parseUnaryExpression(ExpressionAST *&node);
 | 
						|
    bool parseUnqualifiedName(NameAST *&node, bool acceptTemplateId = true);
 | 
						|
    bool parseUsing(DeclarationAST *&node);
 | 
						|
    bool parseUsingDirective(DeclarationAST *&node);
 | 
						|
    bool parseAliasDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseWhileStatement(StatementAST *&node);
 | 
						|
 | 
						|
    void parseExpressionWithOperatorPrecedence(ExpressionAST *&lhs, int minPrecedence);
 | 
						|
 | 
						|
    // Qt MOC run
 | 
						|
    bool parseQtMethod(ExpressionAST *&node);
 | 
						|
 | 
						|
    // C++0x
 | 
						|
    bool parseInitializer0x(ExpressionAST *&node, int *equals_token);
 | 
						|
    bool parseBraceOrEqualInitializer0x(ExpressionAST *&node);
 | 
						|
    bool parseInitializerClause0x(ExpressionAST *&node);
 | 
						|
    bool parseInitializerList0x(ExpressionListAST *&node);
 | 
						|
    bool parseBracedInitList0x(ExpressionAST *&node);
 | 
						|
 | 
						|
    bool parseLambdaExpression(ExpressionAST *&node);
 | 
						|
    bool parseLambdaIntroducer(LambdaIntroducerAST *&node);
 | 
						|
    bool parseLambdaCapture(LambdaCaptureAST *&node);
 | 
						|
    bool parseLambdaDeclarator(LambdaDeclaratorAST *&node);
 | 
						|
    bool parseCapture(CaptureAST *&node);
 | 
						|
    bool parseCaptureList(CaptureListAST *&node);
 | 
						|
    bool parseTrailingReturnType(TrailingReturnTypeAST *&node);
 | 
						|
 | 
						|
    // ObjC++
 | 
						|
    bool parseObjCExpression(ExpressionAST *&node);
 | 
						|
    bool parseObjCClassForwardDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseObjCInterface(DeclarationAST *&node,
 | 
						|
                            SpecifierListAST *attributes = nullptr);
 | 
						|
    bool parseObjCProtocol(DeclarationAST *&node,
 | 
						|
                           SpecifierListAST *attributes = nullptr);
 | 
						|
 | 
						|
    bool parseObjCTryStatement(StatementAST *&node);
 | 
						|
    bool parseObjCSynchronizedStatement(StatementAST *&node);
 | 
						|
    bool parseObjCThrowStatement(StatementAST *&node);
 | 
						|
    bool parseObjCEncodeExpression(ExpressionAST *&node);
 | 
						|
    bool parseObjCProtocolExpression(ExpressionAST *&node);
 | 
						|
    bool parseObjCSelectorExpression(ExpressionAST *&node);
 | 
						|
    bool parseObjCStringLiteral(ExpressionAST *&node);
 | 
						|
    bool parseObjCMessageExpression(ExpressionAST *&node);
 | 
						|
    bool parseObjCMessageReceiver(ExpressionAST *&node);
 | 
						|
    bool parseObjCMessageArguments(ObjCSelectorAST *&selNode, ObjCMessageArgumentListAST *& argNode);
 | 
						|
    bool parseObjCSelectorArg(ObjCSelectorArgumentAST *&selNode, ObjCMessageArgumentAST *&argNode);
 | 
						|
    bool parseObjCMethodDefinitionList(DeclarationListAST *&node);
 | 
						|
    bool parseObjCMethodDefinition(DeclarationAST *&node);
 | 
						|
 | 
						|
    bool parseObjCProtocolRefs(ObjCProtocolRefsAST *&node);
 | 
						|
    bool parseObjClassInstanceVariables(ObjCInstanceVariablesDeclarationAST *&node);
 | 
						|
    bool parseObjCInterfaceMemberDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseObjCInstanceVariableDeclaration(DeclarationAST *&node);
 | 
						|
    bool parseObjCPropertyDeclaration(DeclarationAST *&node,
 | 
						|
                                      SpecifierListAST *attributes = nullptr);
 | 
						|
    bool parseObjCImplementation(DeclarationAST *&node);
 | 
						|
    bool parseObjCMethodPrototype(ObjCMethodPrototypeAST *&node);
 | 
						|
    bool parseObjCPropertyAttribute(ObjCPropertyAttributeAST *&node);
 | 
						|
    bool parseObjCTypeName(ObjCTypeNameAST *&node);
 | 
						|
    bool parseObjCSelector(int &selector_token);
 | 
						|
    bool parseObjCKeywordDeclaration(ObjCSelectorArgumentAST *&argument, ObjCMessageArgumentDeclarationAST *&node);
 | 
						|
    bool parseObjCTypeQualifiers(int &type_qualifier);
 | 
						|
    bool peekAtObjCContextKeyword(int kind);
 | 
						|
    bool parseObjCContextKeyword(int kind, int &in_token);
 | 
						|
 | 
						|
    bool lookAtStdAttribute() const;
 | 
						|
 | 
						|
    bool lookAtObjCSelector() const;
 | 
						|
 | 
						|
    // c99
 | 
						|
    bool parseDesignatedInitializer(ExpressionAST *&node);
 | 
						|
    bool parseDesignator(DesignatorAST *&node);
 | 
						|
 | 
						|
    bool skipUntil(int token);
 | 
						|
    void skipUntilDeclaration();
 | 
						|
    bool skipUntilStatement();
 | 
						|
    bool skip(int l, int r);
 | 
						|
    int find(int token, int stopAt);
 | 
						|
 | 
						|
    bool lookAtTypeParameter();
 | 
						|
    bool lookAtCVQualifier() const;
 | 
						|
    bool lookAtFunctionSpecifier() const;
 | 
						|
    bool lookAtStorageClassSpecifier() const;
 | 
						|
    bool lookAtBuiltinTypeSpecifier() const;
 | 
						|
    bool lookAtClassKey() const;
 | 
						|
 | 
						|
    const Identifier *className(ClassSpecifierAST *ast) const;
 | 
						|
    const Identifier *identifier(NameAST *name) const;
 | 
						|
 | 
						|
    void match(int kind, int *token);
 | 
						|
 | 
						|
    bool maybeAmbiguousStatement(DeclarationStatementAST *ast, StatementAST *&node);
 | 
						|
    bool maybeForwardOrClassDeclaration(SpecifierListAST *decl_specifier_seq) const;
 | 
						|
 | 
						|
    int peekAtQtContextKeyword() const;
 | 
						|
 | 
						|
    bool switchTemplateArguments(bool templateArguments);
 | 
						|
    bool maybeSplitGreaterGreaterToken(int n = 1);
 | 
						|
 | 
						|
    bool blockErrors(bool block) { return _translationUnit->blockErrors(block); }
 | 
						|
    void warning(int index, const char *format, ...);
 | 
						|
    void error(int index, const char *format, ...);
 | 
						|
    void fatal(int index, const char *format, ...);
 | 
						|
 | 
						|
    inline const Token &tok(int i = 1) const
 | 
						|
    { return _translationUnit->tokenAt(_tokenIndex + i - 1); }
 | 
						|
 | 
						|
    inline int LA(int n = 1) const
 | 
						|
    { return _translationUnit->tokenKind(_tokenIndex + n - 1); }
 | 
						|
 | 
						|
    inline int consumeToken()
 | 
						|
    { return _tokenIndex++; }
 | 
						|
 | 
						|
    inline int cursor() const
 | 
						|
    { return _tokenIndex; }
 | 
						|
 | 
						|
    void rewind(int cursor);
 | 
						|
 | 
						|
    struct TemplateArgumentListEntry {
 | 
						|
        int index;
 | 
						|
        int cursor;
 | 
						|
        ExpressionListAST *ast;
 | 
						|
 | 
						|
        TemplateArgumentListEntry(int index = 0, int cursor = 0, ExpressionListAST *ast = nullptr)
 | 
						|
            : index(index), cursor(cursor), ast(ast) {}
 | 
						|
    };
 | 
						|
 | 
						|
    TemplateArgumentListEntry *templateArgumentListEntry(int tokenIndex);
 | 
						|
    void clearTemplateArgumentList() { _templateArgumentList.clear(); }
 | 
						|
 | 
						|
private:
 | 
						|
    bool hasAuto(SpecifierListAST *decl_specifier_list) const;
 | 
						|
 | 
						|
    TranslationUnit *_translationUnit;
 | 
						|
    Control *_control;
 | 
						|
    MemoryPool *_pool;
 | 
						|
    LanguageFeatures _languageFeatures;
 | 
						|
    int _tokenIndex;
 | 
						|
    bool _templateArguments: 1;
 | 
						|
    bool _inFunctionBody: 1;
 | 
						|
    bool _inExpressionStatement: 1;
 | 
						|
    int _expressionDepth;
 | 
						|
    int _statementDepth;
 | 
						|
    std::stack<int> _initializerClauseDepth;
 | 
						|
 | 
						|
    MemoryPool _expressionStatementTempPool;
 | 
						|
    std::map<int, TemplateArgumentListEntry> _templateArgumentList;
 | 
						|
 | 
						|
    class ASTCache;
 | 
						|
    ASTCache *_astCache;
 | 
						|
    ASTCache *_expressionStatementAstCache;
 | 
						|
 | 
						|
private:
 | 
						|
    Parser(const Parser& source);
 | 
						|
    void operator =(const Parser& source);
 | 
						|
 | 
						|
    bool isNestedNamespace() const;
 | 
						|
};
 | 
						|
 | 
						|
} // namespace CPlusPlus
 |