Documentation de Gambas - /dev/api/name/gb.numberfromstring

/dev/api/name/gb.numberfromstring

# GB.NumberFromString

int GB.NumberFromString ( int option , const char *str , long len , GB_VALUE *value );

Lit un nombre contenu dans une chaîne de caractères et le retourne dans une structure GB_VALUE.

- option est une combinaison des constantes suivantes :

  - GB_NB_READ_INTEGER pour lire un Integer.

  - GB_NB_READ_LONG pour lire un Long.

  - GB_NB_READ_INT_LONG pour lire un Integer ou un Long.

  - GB_NB_READ_FLOAT pour lire un nombre en virgule flottante Float.

  - GB_NB_READ_ALL pour lire un nombre quelconque.

  - GB_NB_READ_HEX_BIN permet la lecture de valeurs hexadécimales ou binaires.

  - GB_NB_LOCAL pour utiliser les paramètres de localisation.

- str est l’adresse de la chaîne de caractères.

- len est sa longueur.

- value pointe vers une structure GB_VALUE destinée à recevoir le résultat de la conversion.

Cette fonction retourne une valeur différente de zéro si rien ne peut être lu dans la chaîne spécifiée.

- Si la chaîne contient un Integer, le type champ de la structure GB_VALUE est défini comme GB_T_INTEGER, et vous pouvez forcer cette structure en GB_INTEGER pour acquérir la valeur.

- Si la chaîne contient un Long, le type champ de la structure GB_ VALUE est défini comme GB_T_LONG, et vous pouvez forcer cette structure en GB_LONG pour acquérir la valeur.

- Si la chaîne contient un nombre en virgule flottante, le type champ de la structure GB_ VALUE est défini comme GB_T_FLOAT, et vous pouvez forcer cette structure en GB_FLOAT pour acquérir la valeur.

### Voir aussi

- /wiki/api/cat/conv