{"route":"/en-US-v0.13.1/reference/math/cases/","title":"Cases","description":"Documentation for the `cases` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"example","name":"Example","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-delim","name":"delim","children":[]},{"id":"parameters-reverse","name":"reverse","children":[]},{"id":"parameters-gap","name":"gap","children":[]},{"id":"parameters-children","name":"children","children":[]}]}],"body":{"kind":"func","content":{"path":["math"],"name":"cases","title":"Cases","keywords":[],"oneliner":"A case distinction.","element":true,"contextual":false,"deprecation":null,"details":"

A case distinction.

\n

Content across different branches can be aligned with the & symbol.

\n

Example

\n
$ f(x, y) := cases(\n  1 "if" (x dot y)/2 <= 0,\n  2 "if" x "is even",\n  3 "if" x in NN,\n  4 "else",\n) $\n
\"Preview\"
","example":null,"self":false,"params":[{"name":"delim","details":"

The delimiter to use.

\n

Can be a single character specifying the left delimiter, in which case\nthe right delimiter is inferred. Otherwise, can be an array containing a\nleft and a right delimiter.

","example":"
#set math.cases(delim: "[")\n$ x = cases(1, 2) $\n
\"Preview\"
","types":["none","str","array","symbol"],"strings":[],"default":"("{", "}")","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"reverse","details":"

Whether the direction of cases should be reversed.

","example":"
#set math.cases(reverse: true)\n$ cases(1, 2) = x $\n
\"Preview\"
","types":["bool"],"strings":[],"default":"false","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"gap","details":"

The gap between branches.

","example":"
#set math.cases(gap: 1em)\n$ x = cases(1, 2) $\n
\"Preview\"
","types":["relative"],"strings":[],"default":"0% + 0.2em","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"children","details":"

The branches of the case distinction.

","example":null,"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":true,"settable":false}],"returns":["content"],"scope":[]}}}