函数应用程序(GNU Octave(版本10.2.0))

y = spfun (f, S) ¶

计算f (S)的非零元素S.

输入函数f仅应用于输入矩阵的非零元素S其通常是稀疏的。函数f可以作为字符串、函数句柄或内联函数传递。

输出y是与输入具有相同稀疏性结构体的稀疏矩阵S. spfun保留稀疏性结构体,该结构体不同于简单地应用函数f到稀疏矩阵S当f (0) != 0.

用例

稀疏性保留spfun与正常函数应用程序相比

S = pi * speye (2,2)
S =

Compressed Column Sparse (rows = 2, cols = 2, nnz = 2 [50%])

  (1, 1) -> 3.1416
  (2, 2) -> 3.1416

y = spfun (@cos, S)
y =

Compressed Column Sparse (rows = 2, cols = 2, nnz = 2 [50%])

  (1, 1) -> -1
  (2, 2) -> -1

y = cos (S)
y =

Compressed Column Sparse (rows = 2, cols = 2, nnz = 4 [100%])

  (1, 1) -> -1
  (2, 1) -> 1
  (1, 2) -> 1
  (2, 2) -> -1

详见: arrayfun, cellfun, structfun.

A = cellfun (@fcn, C) ¶

A = cellfun ("fcn", C) ¶

A = cellfun (fcn, C) ¶

A = cellfun (fcn, C1, C2, …) ¶

[A1, A2, …] = cellfun (…) ¶

A = cellfun (…, "UniformOutput", val) ¶

A = cellfun (…, "ErrorHandler", errfcn) ¶

A = cellfun ('isempty', C) ¶

A = cellfun ('islogical', C) ¶

A = cellfun ('isnumeric', C) ¶

A = cellfun ('isreal', C) ¶

A = cellfun ('length', C) ¶

A = cellfun ('numel', C) ¶

A = cellfun ('prodofsize', C) ¶

A = cellfun ('size', C, dim) ¶

A = cellfun ('isclass', C, class) ¶

评估名为fcn的函数在元胞数组的元素上C.

cellfun接受一个任意的函数fcn，可以是函数名称字符串，可以是函数句柄，也可以是内联函数。指定 fcn为函数名称字符串是推荐做法，因为在内置函数中快3倍，并且和在m文件中的函数一样快。

cellfun有少数几个函数被特殊编写以提供更高性能（比函数句柄快8倍）。这些函数只用于当fcn是以字符串形式指定的内置函数，并且只支持最简单的调用格式——没有选项的cellfun('fcn', C)。如果要使用特定classdef文件的重载版本的函数（例如numel），则不能使用函数名称，必须改用函数句柄，例如@numel。

高性能的函数包括：

'isempty': 如果元素为空则返回true
'islogical': 如果元素为逻辑元素则返回true
'isnumeric': 如果元素为数字元素则返回true
'isreal': 如果元素为实数则返回true
'length': 返回数组元素长度的向量。
'ndims': 返回每个元素的维度数。
'numel'
'prodofsize': 返回每个数组元素中包含的元素数。数字是对象在每个单元元素处的尺寸的乘积。
'size': 返回第dim个维度的尺寸
'isclass': 如果元素的类型为class则返回true

在C中的元素都传入函数，然后每个函数的结果都收集到输出参数中。函数可以接受多个输入，通过C1, C2等给出输入参数。奇异(1x1)单元格的输入自变量将自动扩展到其他自变量的大小。例如:

cellfun ("atan2", {1, 0}, {0, 1})
     ⇒ [ 1.57080   0.00000 ]

的输出参数数cellfun匹配函数的outputarguments的数量,并且可以大于一。当函数有多个输出时,它们将被收集到的输出参数中cellfun这样地:

function [a, b] = twoouts (x)
  a = x;
  b = x*x;
endfunction
[aa, bb] = cellfun (@twoouts, {1, 2, 3})
     ⇒
        aa =
           1 2 3
        bb =
           1 4 9

请注意,默认情况下,输出参数是与输入参数大小相同的数组。

如果参数"UniformOutput"如果设置为true(默认值),则函数必须返回标量,标量将连接到returnarray中。如果"UniformOutput"如果为false,则输出连接到一个(或多个)元胞数组。例如

cellfun ("lower", {"Foo", "Bar", "FooBar"},
         "UniformOutput", false)
⇒ {"foo", "bar", "foobar"}

参数"ErrorHandler"指定errfcn调用的函数，如果fcn生成错误。函数的形式是

function [...] = errfcn (s, ...)

其中有一个额外的输入参数errfcn相对于fcn,从给定s。这是一个包含元素的结构体"identifier", "message"和"index"将错误标识符、错误消息和索引分别提供给导致错误的元素的输入参数。例如

function y = foo (s, x), y = NaN; endfunction
cellfun ("factorial", {-1,2}, "ErrorHandler", @foo)
⇒ [NaN 2]

注意：聪明地用cellfun。这里的cellfun函数是避免循环的有用工具。它经常与匿名函数句柄一起使用;然而,调用匿名函数所涉及的开销与m文件函数的开销相当。将句柄传递给内置函数是错误的,因为解释器不参与内部循环。例如:

C = {...}
v = cellfun (@(x) det (x), C); # compute determinants
v = cellfun (@det, C);         # 40% faster

详见: arrayfun, structfun, spfun.

A = structfun (fcn, S) ¶

A = structfun (…, "ErrorHandler", errfcn) ¶

A = structfun (…, "UniformOutput", val) ¶

[A, B, …] = structfun (…) ¶

评估名为的函数name关于结构体的字段S。的字段S传递给函数fcn个别地。

structfun接受任意函数fcn以线性函数、函数句柄或函数名称(在字符串中)的形式。如果是字符串参数,函数必须接受一个名为x,并且它必须返回一个字符串值。如果函数返回多个参数,它们将作为单独的返回变量返回。

如果参数"UniformOutput"如果设置为true(默认值),则函数必须返回一个元素,该元素将连接到返回值中。如果"UniformOutput"如果为false,则输出被放置到与输入结构体具有相同字段名的结构体中。

s.name1 = "John Smith";
s.name2 = "Jill Jones";
structfun (@(x) regexp (x, '(\w+)$', "matches"){1}, s,
           "UniformOutput", false)
  ⇒ scalar structure containing the fields:
       name1 = Smith
       name2 = Jones

给定参数"ErrorHandler", errfcn定义一个函数以在case中调用fcn生成错误。函数的形式是

function [...] = errfcn (se, ...)

其中有一个附加的输入参数errfcn相对于fcn,从给定se。这是一个包含元素的结构体"identifier", "message"和"index",分别给出导致错误的元素的输入自变量的错误标识符、错误消息和索引。有关如何使用错误处理程序的示例,详见cellfun.

详见: cellfun, arrayfun, spfun.

19.3函数应用¶