escape()

Author: J-Fields

src/vimscript/expression/evaluate.ts

@@ -993,6 +993,12 @@ export class EvaluationContext {
             return bool(false);
         }
       }
+      case 'escape': {
+        const [s, chars] = getArgs(2);
+        return str(
+          toString(s!).replace(new RegExp(`[${escapeRegExp(toString(chars!))}]`, 'g'), '\\$&'),
+        );
+      }
       case 'eval': {
         const [expr] = getArgs(1);
         return this.evaluate(expressionParser.tryParse(toString(expr!)));

test/vimscript/expression.test.ts

@@ -642,6 +642,15 @@ suite('Vimscript expressions', () => {
       exprTest('empty(0z00)', { value: bool(false) });
     });
 
+    suite('escape', () => {
+      exprTest("escape('abc', '')", {
+        value: str('abc'),
+      });
+      exprTest("escape('c:\\program files\\vim', ' \\')", {
+        value: str('c:\\\\program\\ files\\\\vim'),
+      });
+    });
+
     suite('function', () => {
       exprTest("function('abs')", { display: 'abs' });
       exprTest("function('abs', [])", { display: 'abs' });