POSNET COMBO LIBRARY: Obsługa parametrów rozkazu

# Obsługa parametrów rozkazu
[Obsługa synchroniczna kasy]

W zależności od typu rozkazu może on posiadać odpowiednią ilość parametrów. Parametry te (w instrukcji programisty opisywane jako DATAxx) odkładane są na listę parametrów za pomocą kolejnych wywołań funkcji POS_PushRequestParamXXXXX. WiÄ™cej...

## Funkcje
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamByte (POSNET_HANDLE hRequest, unsigned char param)
| Wstaw parametr typu liczba całkowita o zakresie 1 bajtowym (0 - 255) (znak).
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamCurrency (POSNET_HANDLE hRequest, char *param)
| Wstaw parametr typu walutowego podawany w "groszach" - najmniejszej jednostce waluty.
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamLong (POSNET_HANDLE hRequest, unsigned long param)
| Wstaw parametr typu liczba całkowita o zakresie 4 bajtowym (0 - 2^32-1).
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamNumeric (POSNET_HANDLE hRequest, char *param)
| Wstaw parametr typu numerycznego.
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamQuantity (POSNET_HANDLE hRequest, char *param)
| Wstaw parametr typu ilościowego - 2 miejsca po przecinku [typ Q w/g instrukcji programisty].
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamString (POSNET_HANDLE hRequest, char *param)
| Wstaw parametr typu "Ciąg znakowy".
POSNET_API POSNET_STATUS __stdcall | POS_PushRequestParamWord (POSNET_HANDLE hRequest, unsigned short param)
| Wstaw parametr typu liczba całkowita o zakresie 2 bajtowym (0 - 65535).

## Opis szczegĂłĹ‚owy

W zależności od typu rozkazu może on posiadać odpowiednią ilość parametrów. Parametry te (w instrukcji programisty opisywane jako DATAxx) odkładane są na listę parametrów za pomocą kolejnych wywołań funkcji POS_PushRequestParamXXXXX.

## Dokumentacja funkcji

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamByte | ( | POSNET_HANDLE | hRequest,
|  | unsigned char | param |
| ) |  |  |

Wstaw parametr typu liczba całkowita o zakresie 1 bajtowym (0 - 255) (znak).

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Wartość 1 bajtowa

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamCurrency | ( | POSNET_HANDLE | hRequest,
|  | char * | param |
| ) |  |  |

Wstaw parametr typu walutowego podawany w "groszach" - najmniejszej jednostce waluty.

OstrzeĹĽenie:
  W obecnej wersji kasa COMBO nie wykorzystuje tego typu.

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Ciąg znaków będący reprezentacją tekstową liczby

Zobacz rĂłwnieĹĽ:
  POS_PushRequestParamQuantity

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamLong | ( | POSNET_HANDLE | hRequest,
|  | unsigned long | param |
| ) |  |  |

Wstaw parametr typu liczba całkowita o zakresie 4 bajtowym (0 - 2^32-1).

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Wartość 4 bajtowa

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamNumeric | ( | POSNET_HANDLE | hRequest,
|  | char * | param |
| ) |  |  |

Wstaw parametr typu numerycznego.

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Ciąg znaków będący reprezentacją tekstową liczby, bez miejsc dziesiętnych. Ilość miejsc dziesiętnych wynika bezpośrednio z dokumentacji kasy (Instrukcja Programisty) i jest zależna od polecenia.

Zobacz rĂłwnieĹĽ:
  POS_PushRequestParamQuantity

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamQuantity | ( | POSNET_HANDLE | hRequest,
|  | char * | param |
| ) |  |  |

Wstaw parametr typu ilościowego - 2 miejsca po przecinku [typ Q w/g instrukcji programisty].

W przeciwieństwie do sposobu reprezentacji liczb w protokole kasy biblioteka wymienia się z aplikacją reprezentacją tekstową liczb [tzw. Decimal String]. Biblioteka wewnętrznie tłumaczy otrzymany ciąg znaków na właściwy format liczby stosując jednocześnie technikę "ucinania" bez zaokrąglania orzymanej wartości. Na aplikacji spoczywa obowiązek dostarczenia licz w wymaganej precyzji (ilości miejsc po przecinku).

Biblioteka akceptuje ciagi znaków zawierające kropkę "." lub "," jako separator części dziesiętnej. Biblioteka nie akceptuje stosowania separatora tysięcy.

OstrzeĹĽenie:
  W obecnej wersji kasa COMBO nie wykorzystuje tego typu.

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Ciąg znaków będący reprezentacją tekstową liczby

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamString | ( | POSNET_HANDLE | hRequest,
|  | char * | param |
| ) |  |  |

Wstaw parametr typu "Ciąg znakowy".

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Ciąg znaków w konwencji języka C (zakończony znakiem 0)

POSNET_API POSNET_STATUS __stdcall POS_PushRequestParamWord | ( | POSNET_HANDLE | hRequest,
|  | unsigned short | param |
| ) |  |  |

Wstaw parametr typu liczba całkowita o zakresie 2 bajtowym (0 - 65535).

Parametry:

  | hRequest | Uchwyt rozkazu
  | param | Wartość 2 bajtowa