通用服务

这些操作不属于任何其他类别。它们在任何 Qbs 项目文件或 JavaScript 文件中自动可用。

可用的操作

require

require(identifier: string): any

加载一个扩展并返回表示扩展的对象。如果 identifier 是一个相对或绝对文件路径，则此函数将加载一个 JavaScript 文件并返回包含该文件评估上下文的对象。否则，加载名为 identifier 的 Qbs 扩展并返回包含扩展上下文的对象。此函数仅在 JavaScript 文件中可用，并设计为与 CommonJS/RequireJS/Node.js 模块解析系统类似。

var MyFunctions = require("./myfunctions.js");
MyFunctions.doSomething();
var FileInfo = require("qbs.FileInfo");
var fileName = FileInfo.fileName(filePath);

JavaScript 内置对象的扩展

Array.containsAll

Array.containsAll(other: any[]): boolean

如果数组包含 other 数组中的每个元素，则返回 true。否则返回 false。

Array.containsAny

Array.containsAny(other: any[]): boolean

如果数组包含 other 数组中的某些元素，则返回 true。否则返回 false。

Array.uniqueConcat

Array.uniqueConcat(other: any[]): any[]

返回此数组和数组 other 连接的副本。从连接中删除重复项。保留元素顺序。

Console API

Qbs 提供了与大多数 ECMAScript 运行时中可用的非标准 Console API 的一部分。

这些函数中每个函数的输出只有在日志级别至少为函数输出的级别时才会显示。日志级别从低到高为：'error'、'warning'、'info'、'debug' 和 'trace'。默认为 'info'。

console.debug

console.debug(s: string): void

此方法是对 console.log() 的别名。

console.error

console.error(s: string): void

记录一个 error 级别的消息。当日志输出是终端时输出到 stderr。字符串前缀为 "ERROR: "，并且在支持颜色的终端中是红色的。

console.info

console.info(s: string): void

记录一个 info 级别的消息。当日志输出是终端时输出到 stdout。

console.log

console.log(s: string): void

记录一个 debug 级别的消息。当日志输出是终端时输出到 stderr。

console.warn

console.warn(s: string): void

记录警告级别的消息。当日志输出为终端时输出到stderr。字符串将带有前缀"WARNING: "并且当日志输出为支持颜色的终端时将变为黄色。