license

获取许可证状态，测试许可证是否存在，或签出功能许可证

全页折叠

语法

license

license('inuse')

S = license('inuse')

S = license('inuse',feature)

status = license('test',feature)

license('test',feature,toggle)

[status,errmsg] = license('checkout',feature)

说明

使用 license 函数返回正在使用的许可证编号，列出在当前会话中签出的许可证，确定许可证关联的特定功能是否已签出，并签出许可证关联的特定功能。要执行许可证管理任务，包括如何续订或反激活许可证，请参阅管理您的许可证。

license 返回此 MATLAB^® 的许可证编号。返回值也可以是非数字，例如，'demo' 表示 MATLAB 的演示版，或 'student' 表示 MATLAB 的学生版。

license('inuse') 显示当前 MATLAB 会话中签出的功能的列表。此列表按许可产品代名字母顺序排列。这些名称与 feature 输入的有效值相同。

示例

S = license('inuse') 返回列出在当前会话中签出的功能的结构体数组。

示例

S = license('inuse',feature) 检查在当前 MATLAB 会话中是否签出了 feature。如果该功能已签出，则 license 返回在当前会话中使用的许可证名称。否则，S 的字段为空。

示例

status = license('test',feature) 测试 feature 指定的值是否存在许可证。

示例

license('test',feature,toggle) 允许或禁止对 feature 指定的值进行测试，具体取决于 toggle 的值。

[status,errmsg] = license('checkout',feature) 签出指定功能的许可证。如果您指定可选的第二个输出参量 errmsg，license 将返回签出失败时遇到的任何错误消息的文本。

示例

全部折叠

显示使用中的许可证

显示当前正在使用的许可证列表。license 按您的配置的许可证功能名称的字母顺序显示功能列表。

license('inuse')

image_toolbox
map_toolbox
matlab

获取使用中的许可证

获取使用中的许可证的列表。license 返回一个结构体数组。

S = license('inuse');

查看 S 的第一个元素。

S(1)

ans = 

    feature: 'image_toolbox'
       user: ''

尽管该结构体包含一个用户字段，但该字段始终为空。

确定许可证是否在使用中

确定是否正在使用 MATLAB 的许可证。如果许可证正在使用中，则 S 是一个包含签出功能名称的结构体数组。

S = license('inuse','MATLAB')

S = 

    feature: 'matlab'
       user: ''

确定许可证是否存在

确定 Mapping Toolbox™ 是否存在许可证。如果存在许可证，则 license 返回 1。

status = license('test','MAP_Toolbox')

status =

    1

签出许可证

签出 Control System Toolbox™ 的许可证。如果签出成功，status 输出为 1，errmsg 输出为空。

[status,errmsg] = license('checkout','Control_Toolbox')

status =

     1


errmsg =

     ''

输入参数

全部折叠

`feature` — 许可产品代名
字符向量

许可产品代名，指定为字符向量。feature 的值不区分大小写。许可证文件中的 INCREMENT 行指示有效功能。要找到您的许可证文件，请参阅 Where can I find MATLAB license files?

`toggle` — 测试许可证的能力
`'enable'` | `'disable'`

能够测试许可证是否存在，指定为 'enable' 或 'disable'。

如果 toggle 为 'enable'，则语法 license('test',feature) 返回 1（存在许可证时）和 0（不存在许可证时）。
如果 toggle 为 'disable'，则语法 license('test',feature) 始终为指定功能返回 0（许可证不存在）。

注意

禁止对特定许可证进行测试会影响其他确认许可证是否存在的测试，而不仅仅是影响由 license 命令执行的测试。

输出参量

全部折叠

`S` — 已签出许可证
结构体数组

以结构体数组形式返回签出的许可证，其中每个结构体表示一个签出的许可证。结构体包含两个字段：

feature - 许可产品代名
user - 始终为空的字段

如果这两个字段为空，则当前未签出许可证。

`status` — 检验状态或签出状态
`1` | `0`

检验状态或签出状态，以 1 或 0 形式返回。

检验许可证是否存在时，1 指示许可证存在，0 指示许可证不存在。
许可证存在并不一定意味着该许可证可签出或与许可证相关的功能已安装。如果许可证的所有密钥都在使用中，则测试仍将返回 1，但实际签出会失败。
在签出许可证时，1 指示签出成功，0 指示 license 函数无法签出许可证。

`errmsg` — 错误消息
字符向量

许可证签出不成功的错误消息，以字符向量形式返回。如果签出成功，则 errmsg 为空。

错误消息通常会指示您应如何解决问题。例如：

License checkout failed.
License Manager Error -5
Cannot find a license for FEATURENAME.

Troubleshoot this issue by visiting:
https://www.mathworks.com/support/lme/R2021b/5

您遇到的许可证签出错误可能取决于您拥有的许可证类型。