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

: y = spfun (f, S) ¶

计算fS)的非零元素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 ("size", C, k) ¶

: A = cellfun ("isclass", C, class) ¶

: A = cellfun (@fcn, C) ¶

: A = cellfun (fcn, C) ¶

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

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

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

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

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

中的元素C分别传递给命名函数。The functionfcn可以是函数之一

isempty: 对于空元素,返回1。
islogical: 逻辑元素返回1。
isnumeric: 对于数字元素,返回1。
isreal: 对于实际元素,返回1。
length: 返回数组元素长度的向量。
ndims: 返回每个元素的维度数。
numel
prodofsize: 返回每个数组元素中包含的元素数。数字是对象在每个单元元素处的尺寸的乘积。
size: 沿返回大小k-th维度。
isclass: 的元素返回1class.

此外,cellfun接受任意函数fcn以内联函数、函数句柄或函数名称的形式(在一个字符字符串中)。函数可以接受一个或多个参数,输入参数从C1, C2等。例如:

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

请注意,默认情况下,输出参数是与输入参数大小相同的数组。奇异(1x1)数组的输入自变量将自动扩展到其他自变量的大小。

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

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

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

函数[…]=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生成错误。函数的形式是

函数[…]=errfcn(se, ...)

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

详见: cellfun, arrayfun, spfun.

19.3函数应用¶