Spis treści

# Funkcja CInt

Przetwarza dowolny ciąg lub wyrażenie numeryczne na liczbę całkowitą.

### Składnia:

    CInt (Expression As Variant) As Integer

### Zwracana wartość:

Integer

### Parametry:

Wyrażenie: dowolny ciąg znaków lub wyrażenie numeryczne, które chcesz przekonwertować. Aby przekonwertować wyrażenie ciągu, liczbę należy wprowadzić jako zwykły tekst, stosując domyślny format liczb zgodny z ustawieniami regionalnymi LibreOffice. Na przykład numer należy wprowadzić za pomocą kropki „.” jako kropka dziesiętna i przecinek „,” jako separator tysięcy (na przykład 123 456,78) dla ustawień regionalnych języka angielskiego.

Jeśli argumentem jest ciąg znaków, funkcja przycina początkowe białe znaki; następnie próbuje rozpoznać liczbę w kolejnych znakach. Rozpoznawana jest poniższa składnia:

- Liczby dziesiętne (opcjonalnie ze znakiem wiodącym) przy użyciu separatora dziesiętnego i tysięcy w ustawieniach regionalnych LibreOffice (separatory grup mogą znajdować się na dowolnej pozycji), opcjonalnie w notacji wykładniczej, takiej jak "-12e+1" (gdzie cała liczba dziesiętna po e lub E albo d lub D, opcjonalnie ze znakiem, określa potęgę 10).

- Liczby ósemkowe, takie jak "&Onnn...", gdzie "nnn…" po "&O" lub "&o" to sekwencja nie dłuższa niż 11 cyfr, od 0 do 7, do następnego znaku niealfanumerycznego;

- Liczby szesnastkowe, takie jak "&Hnnn…", gdzie "nnn…" po "&H" lub "&h" to ciąg znaków do następnego znaku niealfanumerycznego i nie może być dłuższy niż 8 cyfr, od 0 do 9, od A do F lub od a do f.

Reszta łańcucha jest ignorowana. Jeśli ciąg znaków nie zostanie rozpoznany, np. gdy po przycięciu spacji początkowej nie zaczyna się od plusa, minusa, cyfry dziesiętnej, ani "&" lub gdy ciąg po "&O" jest dłuższy niż 11 znaków lub zawiera znak alfabetu, wartość liczbowa wyrażenia wynosi 0.

Jeśli argumentem jest błąd, numer błędu jest używany jako wartość liczbowa wyrażenia.

Jeśli argumentem jest data, liczba dni od 1899-12-30 (data szeregowa) jest używana jako wartość liczbowa wyrażenia. Czas jest reprezentowany jako ułamek dnia.

Po obliczeniu wartości liczbowej wyrażenia jest ona zaokrąglana do najbliższej liczby całkowitej (w razie potrzeby), a jeśli wynik nie mieści się w przedziale od -32768 do 32767, LibreOffice Basic zgłasza błąd przepełnienia. W przeciwnym razie wynik jest zwracany.

### Kody błędów:

5 Nieprawidłowe wywołanie procedury

### Przykład:

Wyrażenia liczbowe są wyświetlane zgodnie z ustawieniami regionalnymi LibreOffice:

    Sub ExampleCountryConvert
        MsgBox CDbl(1234.5678) ' 1234,5678
        MsgBox CInt(1234.5678) ' 1235
        MsgBox CLng(1234+5678) ' 6912
        MsgBox CSng(1234.5678) ' 1234,567749023

        MsgBox CDbl(expression := 5678.1234) ' 5678,1234
        MsgBox CInt(expression := 5678.1234) ' 5678
        MsgBox CLng(expression := 5678+1234) ' 6912
        MsgBox CSng(expression := 5678.1234) ' 5678,123535156
    End Sub