Qt object: Add exit(int)

This is similar to the Qt.quit() function but also specifies the return
code that the event loop will return.

[ChangeLog][QtQml] Added exit(int retCode) method to the Qt global object.
An application can call Qt.exit to specify a return code of the engine.

Task-number: QTBUG-54360
Change-Id: Iaa319e6dc4d6b99dc3a5c01845e87b936fd2cab0
Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>

2 files changed, 26 insertions, 0 deletions

diff --git a/src/qml/qml/v8/qqmlbuiltinfunctions.cpp b/src/qml/qml/v8/qqmlbuiltinfunctions.cpp
index 76a900c846..db0439ab9e 100644
--- a/src/qml/qml/v8/qqmlbuiltinfunctions.cpp
+++ b/src/qml/qml/v8/qqmlbuiltinfunctions.cpp
@@ -137,6 +137,7 @@ Heap::QtObject::QtObject(QQmlEngine *qmlEngine)
         o->defineDefaultProperty(QStringLiteral("darker"), QV4::QtObject::method_darker);
         o->defineDefaultProperty(QStringLiteral("tint"), QV4::QtObject::method_tint);
         o->defineDefaultProperty(QStringLiteral("quit"), QV4::QtObject::method_quit);
+        o->defineDefaultProperty(QStringLiteral("exit"), QV4::QtObject::method_exit);
         o->defineDefaultProperty(QStringLiteral("createQmlObject"), QV4::QtObject::method_createQmlObject);
         o->defineDefaultProperty(QStringLiteral("createComponent"), QV4::QtObject::method_createComponent);
     }
@@ -992,6 +993,8 @@ This function causes the QQmlEngine::quit() signal to be emitted.
 Within the \l {Prototyping with qmlscene}, this causes the launcher application to exit;
 to quit a C++ application when this method is called, connect the
 QQmlEngine::quit() signal to the QCoreApplication::quit() slot.
+
+\sa exit()
 */
 ReturnedValue QtObject::method_quit(CallContext *ctx)
 {
@@ -1000,6 +1003,28 @@ ReturnedValue QtObject::method_quit(CallContext *ctx)
 }
 
 /*!
+    \qmlmethod Qt::exit(int retCode)
+
+    This function causes the QQmlEngine::exit(int) signal to be emitted.
+    Within the \l {Prototyping with qmlscene}, this causes the launcher application to exit
+    the specified return code. To exit from the event loop with a specified return code when this
+    method is called, a C++ application can connect the QQmlEngine::exit(int) signal
+    to the QCoreApplication::exit(int) slot.
+
+    \sa quit()
+*/
+ReturnedValue QtObject::method_exit(CallContext *ctx)
+{
+    if (ctx->argc() != 1)
+        V4THROW_ERROR("Qt.exit(): Invalid arguments");
+
+    int retCode = ctx->args()[0].toNumber();
+
+    QQmlEnginePrivate::get(ctx->engine()->qmlEngine())->sendExit(retCode);
+    return QV4::Encode::undefined();
+}
+
+/*!
 \qmlmethod object Qt::createQmlObject(string qml, object parent, string filepath)
 
 Returns a new object created from the given \a string of QML which will have the specified \a parent,
diff --git a/src/qml/qml/v8/qqmlbuiltinfunctions_p.h b/src/qml/qml/v8/qqmlbuiltinfunctions_p.h
index d29983c476..8c0759679a 100644
--- a/src/qml/qml/v8/qqmlbuiltinfunctions_p.h
+++ b/src/qml/qml/v8/qqmlbuiltinfunctions_p.h
@@ -122,6 +122,7 @@ struct QtObject : Object
     static ReturnedValue method_btoa(CallContext *ctx);
     static ReturnedValue method_atob(CallContext *ctx);
     static ReturnedValue method_quit(CallContext *ctx);
+    static ReturnedValue method_exit(CallContext *ctx);
     static ReturnedValue method_resolvedUrl(CallContext *ctx);
     static ReturnedValue method_createQmlObject(CallContext *ctx);
     static ReturnedValue method_createComponent(CallContext *ctx);