musique/doc/operators.md

# Lista wbudowanych operatorów języka Musique

## Operatory arytmetyczne

- `+` – operator:
    - dodawania (liczby całkowite i ułamki):

	```
	> 2 + 3
	5
	> (1/3) + (1/4)
	7/12
	> 1 + (up 10)
	[1; 2; 3; 4; 5; 6; 7; 8; 9; 10]
	```

    - inkrementacji zmiennej (liczby lub akordu, w tym w szczególności pojedynczeń nuty):

	```
	> c + 1
	c#
	 c4 + 2
	hord[d; f#]
	```

- `-` – operator odejmowania/dekrementacji – analogicznie do operatora `+`;

- `*` – operator:

    - mnożenia (liczby całkowite i ułamki):

	```
	> 2 * 5
	10
	> (1/3) * (1/4)
	1/12
	> 2 * (up 10)
	[0; 2; 4; 6; 8; 10; 12; 14; 16; 18]
	```

    - powtarzania – zwraca określoną liczbę powtórzeń danego dźwięku:

	```
	> a * 4
	[a; a; a; a]
	> a3 * 4
	[chord[a; c]; chord[a; c]; chord[a; c]; chord[a; c]]
	```

- `/` – operator dzielenia – *wektor może być wyłącznie dzielną*:

```
> 4 / 2
2
> 5 / 7
5/7
> (2/3) / (3/5)
10/9
> (up 10) / 2
[0; 1/2; 1; 3/2; 2; 5/2; 3; 7/2; 4; 9/2]
```

- `%` – operator działania modulo (wynikiem jest reszta z dzielenia) – *nie działa dla ułamków*, *wektor może być wyłącznie dzielną*:

```
> 3 % 3
0
> 6 % 5
1
> (up 10) % 2
[0; 1; 0; 1; 0; 1; 0; 1; 0; 1]
```

- `**` – operator potęgowania – *wykładnikiem nie może być ułamek*:

```
> 2 ** 8
256
> (2/3) ** 3
8/27
> (up 10) ** 2
[0; 1; 4; 9; 16; 25; 36; 49; 64; 81]
> 2 ** (up 10)
[1; 2; 4; 8; 16; 32; 64; 128; 256; 512]
```

## Operatory porównawcze

- `!=` – operator "nie równa się":

```
> 2 != 3
true
> a != a
false
> 3 != (up 5)
[true; true; true; false; true]
```

- `<` – operator "mniejsze niż":

```
> 2 < 3
true
> a < a
false
> 3 < (up 5)
[true; true; true; false; false]
```

- `<=` – operator "mniejsze lub równe":

```
> 2 <= 3
true
> a <= a
true
> 3 <= 2
false
> 3 <= (up 5)
[true; true; true; true; false]
```

- `==` – operator "równe":

```
> 2 == 3
false
> a == a
true
> 3 == (up 5)
[false; false; false; true; false]
```

- `>` – operator "większe niż":

```
> 2 > 3
false
> a > a
true
> 3 > (up 5)
[false; false; false; false; true]
```

- `>=` – operator "większe lub równe":

```
> 2 >= 3
false
> a >= a
true
> 3 >= 2
true
> 3 >= (up 5)
[false; false; false; true; true]
```

## Pozostałe operatory

- `.` – operator indeksu (zwraca wskazany element, liczone od 0):

```
> A:=[1; 3; 5]
> A . 1
3
> (up 7).4
3
```

- `&` – operator łączenia:

```
> c & a
chord[c; a]
> [1;3;5] & [2;4;6]
[1; 3; 5; 2; 4; 6]
> (up 7) & (down 9)
[0; 1; 2; 3; 4; 5; 6; 8; 7; 6; 5; 4; 3; 2; 1; 0]
```