等效脚本API

Squish 为其支持的所有脚本语言提供了相同的根本性 API，并在需要时添加了一些特定语言的额外功能，例如在 JavaScript 中处理文件，因为标准语言没有提供。在本节中，我们将讨论如何使用 API，注意因脚本语言本身的差异而导致的用法差异。

差异在特定语言的注释中描述。例如，Python 注释展示了如何访问 Python 内置的 type 函数而不是 Squish 的 type(objectOrName, text) 函数；JavaScript 注释和扩展 API描述了 Squish 为文件处理、操作系统交互、使用 XML 和 SQL 等提供的新增 API。

示例类

在审查差异之前，我们先看看在下表中使用的示例类。

对于非 macOS 平台，下表使用以下示例 C++ 类

class C
{
public:
    C();
    C(const char *s);

    void doA(bool b);
    static void doB();

    int p;
    ...
};

对于 macOS，下表使用以下 Objective-C 类

@interface C : NSObject
{
    ...
}

- (void)doA;
- (void)doB:(BOOL)b;
+ (void)doC;
+ (void)doD:(BOOL)b;

- (int)p;
- (void)setP:(int)newP;

...

@end

此外，假设存在一个名为 c 的类型为 C 的对象。

表中某些调用中的下划线与 Objective-C 相关。有关详细信息，请参阅函数和属性（macOS）。

等效脚本函数

下表提供了对创建对象、获取和设置属性、执行比较等最基本任务对应的等效脚本函数的简要概述。尽管执行的操作相同且使用相同的 API，但由于 Squish 支持的脚本语言的语法和结构差异，实际示例代码会有所不同。

Squish API 文档包含示例（几乎总是所有支持的脚本语言）以及到手册中其他示例的链接。如果您的脚本语言中没有示例，请使用下表将其中一种语言的示例转换为所需的语言。

Python

s = str(val) # or
s = unicode(val)

JavaScript

Perl

my $c = new C();  # new-style
my $c = C->new(); # old-style

my $c = new C("apple");  # new-style
my $c = C->new("apple"); # old-style

Ruby

Tcl

macOS 绑定

对于 macOS，以下是与 Objective-C 对象相关的特定绑定