4cko
/usr/local/rvm/gems/ruby-3.4.7/bin:/usr/local/rvm/gems/ruby-3.4.7@global/bin:/usr/local/rvm/rubies/ruby-3.4.7/bin:/home/codespace/.vscode-remote/data/User/globalStorage/github.copilot-chat/debugCommand:/home/codespace/.vscode-remote/data/User/globalStorage/github.copilot-chat/copilotCli:/vscode/bin/linux-x64/7e7950df89d055b5a378379db9ee14290772148a/bin/remote-cli:/home/codespace/.local/bin:/home/codespace/.dotnet:/home/codespace/nvm/current/bin:/home/codespace/.php/current/bin:/home/codespace/.python/current/bin:/home/codespace/java/current/bin:/home/codespace/.ruby/current/bin:/home/codespace/.local/bin:/usr/local/python/current/bin:/usr/local/py-utils/bin:/usr/local/jupyter:/usr/local/oryx:/usr/local/go/bin:/go/bin:/usr/local/sdkman/bin:/usr/local/sdkman/candidates/java/current/bin:/usr/local/sdkman/candidates/gradle/current/bin:/usr/local/sdkman/candidates/maven/current/bin:/usr/local/sdkman/candidates/ant/current/bin:/usr/local/rvm/gems/default/bin:/usr/local/rvm/gems/default@global/bin:/usr/local/rvm/rubies/default/bin:/usr/local/share/rbenv/bin:/usr/local/php/current/bin:/opt/conda/bin:/usr/local/nvs:/usr/local/share/nvm/versions/node/v24.14.0/bin:/usr/local/hugo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/share/dotnet:/home/codespace/.dotnet/tools:/usr/local/rvm/bin
a2c64e7 | # balanced-match | |
| Match balanced string pairs, like `{` and `}` or `<b>` and | |
| `</b>`. Supports regular expressions as well! | |
| ## Example | |
| Get the first matching pair of braces: | |
| ```js | |
| import { balanced } from 'balanced-match' | |
| console.log(balanced('{', '}', 'pre{in{nested}}post')) | |
| console.log(balanced('{', '}', 'pre{first}between{second}post')) | |
| console.log( | |
| balanced(/\s+\{\s+/, /\s+\}\s+/, 'pre { in{nest} } post'), | |
| ) | |
| ``` | |
| The matches are: | |
| ```bash | |
| $ node example.js | |
| { start: 3, end: 14, pre: 'pre', body: 'in{nested}', post: 'post' } | |
| { start: 3, | |
| end: 9, | |
| pre: 'pre', | |
| body: 'first', | |
| post: 'between{second}post' } | |
| { start: 3, end: 17, pre: 'pre', body: 'in{nest}', post: 'post' } | |
| ``` | |
| ## API | |
| ### const m = balanced(a, b, str) | |
| For the first non-nested matching pair of `a` and `b` in `str`, return an | |
| object with those keys: | |
| - **start** the index of the first match of `a` | |
| - **end** the index of the matching `b` | |
| - **pre** the preamble, `a` and `b` not included | |
| - **body** the match, `a` and `b` not included | |
| - **post** the postscript, `a` and `b` not included | |
| If there's no match, `undefined` will be returned. | |
| If the `str` contains more `a` than `b` / there are unmatched pairs, the first match that was closed will be used. For example, `{{a}` will match `['{', 'a', '']` and `{a}}` will match `['', 'a', '}']`. | |
| ### const r = balanced.range(a, b, str) | |
| For the first non-nested matching pair of `a` and `b` in `str`, return an | |
| array with indexes: `[ <a index>, <b index> ]`. | |
| If there's no match, `undefined` will be returned. | |
| If the `str` contains more `a` than `b` / there are unmatched pairs, the first match that was closed will be used. For example, `{{a}` will match `[ 1, 3 ]` and `{a}}` will match `[0, 2]`. | |