语法
参数
描述
text
(必填)您正在搜索的文本。 不允许使用通配符。 如果文本为空字符串,则返回空文本。您可以输入“text”之类的字符串,或“C4”之类的单元格引用,或“C4: D4”之类的单元格范围引用(在动态数组中工作 )
regular_expression
(必填)将返回匹配此表达式的文本的第一部分。您可以输入“[0-9]+”等字符串,或“C4”等单元格引用。
modifiers
定义模式的修饰符。您可以输入“gi”之类的字符串,或“C4”之类的单元格引用。
修饰符
修饰符
名字
描述
g
global
保留最后一个匹配的索引,允许后续搜索从上一个匹配的末尾开始。没有全局标志,后续搜索将返回相同的匹配。
i
ignore case
使整个表达式不区分大小写。例如,/aBc/i 将匹配 AbC。
m
multiline
启用多行标志后,开始和结束锚点(^ 和 \$)将匹配一行的开始和结束,而不是整个字符串的开始和结束。请注意 /^[ 等模式 \s\S]+$/m 可能会返回跨越多行的匹配项,因为锚点将匹配任何行的开头/结尾。
u
unicode
启用 unicode 标志后,您可以使用 \x{FFFFF} 形式的扩展 unicode 转义符。它还使其他转义符更加严格,导致无法识别的转义符(例如 \j)抛出错误。
y
sticky
该表达式将仅从其最后一个索引位置开始匹配,并忽略全局 (g) 标志(如果已设置)。 因为 RegEx 中的每个搜索都是离散的,所以这个标志对显示的结果没有进一步的影响。
s
dotAll
点 (.) 将匹配任何字符,包括换行符。
请确保您的浏览器支持您使用的修饰符。
SJS不支持修饰符“y”,因为sticky会导致计算结果不一致。如果设置了修饰符“y”,计算时将忽略它。
动态数组
如果将 allowDynamicArray 设置为 false,GC.REGEXEXTRACT 仍然可以工作。 但在某些情况下,您可能需要将 allowDynamicArray 设置为 true 以获得最佳结果。
在下面的示例中,当 allowDynamicArray 标志为 false 时,您将获得“Luve”作为结果,而当标志为 true 时,您将获得 ["Luve", "rose"] 作为结果。
示例
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
spread.options.allowDynamicArray = true;
var sheet = spread.sheets[0];
var defaultStyle = new GC.Spread.Sheets.Style();
defaultStyle.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
defaultStyle.vAlign = GC.Spread.Sheets.VerticalAlign.center;
sheet.setDefaultStyle(defaultStyle);
sheet.setColumnWidth(0, 250);
sheet.setColumnWidth(1, 250);
sheet.setColumnWidth(2, 120);
sheet.setColumnWidth(3, 250);
sheet.setColumnWidth(4, 80);
sheet.setColumnWidth(5, 80);
sheet.addSpan(0, 0, 2, 1);
sheet.addSpan(0, 1, 2, 1);
sheet.addSpan(0, 2, 2, 1);
sheet.addSpan(0, 3, 2, 1);
sheet.addSpan(0, 4, 2, 2);
sheet.getCell(0, 0).value("Text").font("21px bold normal normal");
sheet.getCell(0, 1).value("Regular Expression").font("21px bold normal normal");
sheet.getCell(0, 2).value("Modifiers").font("21px bold normal normal");
sheet.getCell(0, 3).value("Formula Text").font("21px bold normal normal");
sheet.getCell(0, 4).value("Result").font("21px bold normal normal");
var dataArr = [ ["I think SpreadJS is Good", ".*(good).*", "i"],
["there is 300 rabbits grazing", "\\d+", ""],
["O my Luve is like a red, red rose", "O my (\\w+) is like a red, red (\\w+)", ""]];
sheet.setArray(2, 0, dataArr);
for (var i = 0, len = dataArr.length; i < len; i++) {
var row = 3 + i;
sheet.setFormula(row - 1, 4, `=SJS.REGEXEXTRACT(A${row}, B${row}, C${row})`);
sheet.setFormula(row - 1 , 3, `=FORMULATEXT(E${row})`);
}
spread.resumePaint();
document.getElementById("allowDynamicArray").addEventListener('change', function (e) {
var checked = e.target.checked;
spread.options.allowDynamicArray = !!checked;
spread.resumeCalcService();
spread.resumePaint();
});
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="spreadjs culture" content="zh-cn" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-spreadsheets"></div>
<div class="options-container">
<div class="option-row">
<label class="colorLabel">Switch the allowDynamicArray flag.</label>
</div>
<div class="option-row">
<input type="checkbox" id="allowDynamicArray" checked />
<label for="allowDynamicArray">Allow Dynamic Array</label>
</div>
</div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
overflow: auto;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
}
.option-row {
margin-bottom: 12px;
}
label {
user-select: none;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}