Page 1 sur 1

HeaderSection ... EndHeaderSection

Publié : ven. 26/sept./2025 11:04
par falsam
Testant la version 6.30 de PureBasic je m'intéresse aujourd'hui à la possibilité d'inclure du code C dans nos codes PureBasic à travers la directive de compilation HeaderSection ... EndHeaderSection.

Commençons par un tout petit code dont l'objectif est d'additionner deux nombres entiers (Ok, PureBasic fait cela très bien sans passer par le C 🤪 )

■ Voici le code.

Code : Tout sélectionner

HeaderSection
int add(int a, int b)
{
   return a+b;
}
EndHeaderSection

; Récupération du resultat dans une variable
Define result

! v_result = add(2, 8);

Debug result
- Le code C est situé entre HeaderSection et EndHeaderSection et retourne une variable de type int correspondant à l'addition de deux nombres.

- Règle de nommage : Une variable du langage PureBasic qui doit accéder à un élément du langage C doit être précédée du préfixe "v_". Le nom de la variable doit être en minuscule.

Dans l'exemple ci dessus, la variable result appelle la fonction add() codée en langage C.

Re: HeaderSection ... EndHeaderSection

Publié : ven. 26/sept./2025 11:06
par falsam
Avec ce deuxième exemple, j'ai testé l'insertion d'une petite bibliothèque C.

Cas pratique, comment créer une fonction qui permet d'additionner plusieurs nombres ?

■ nous allons pour cela utiliser la bibliothéque <stdarg.h>

Code : Tout sélectionner

/* Copyright (C) 1989, 1997, 1998, 1999, 2000, 2009 Free Software Foundation, Inc.

This file is part of GCC.

GCC is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.

GCC is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

Under Section 7 of GPL version 3, you are granted additional
permissions described in the GCC Runtime Library Exception, version
3.1, as published by the Free Software Foundation.

You should have received a copy of the GNU General Public License and
a copy of the GCC Runtime Library Exception along with this program;
see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
<http://www.gnu.org/licenses/>.  */

/*
 * ISO C Standard:  7.15  Variable arguments  <stdarg.h>
 */

#ifndef _STDARG_H
#ifndef _ANSI_STDARG_H_
#ifndef __need___va_list
#define _STDARG_H
#define _ANSI_STDARG_H_
#endif /* not __need___va_list */
#undef __need___va_list

/* Define __gnuc_va_list.  */

#ifndef __GNUC_VA_LIST
#define __GNUC_VA_LIST
typedef __builtin_va_list __gnuc_va_list;
#endif

/* Define the standard macros for the user,
   if this invocation was from the user program.  */
#ifdef _STDARG_H

#define va_start(v,l)        __builtin_va_start(v,l)
#define va_end(v)        __builtin_va_end(v)
#define va_arg(v,l)        __builtin_va_arg(v,l)
#if !defined(__STRICT_ANSI__) || __STDC_VERSION__ + 0 >= 199900L || defined(__GXX_EXPERIMENTAL_CXX0X__)
#define va_copy(d,s)        __builtin_va_copy(d,s)
#endif
#define __va_copy(d,s)        __builtin_va_copy(d,s)

/* Define va_list, if desired, from __gnuc_va_list. */
/* We deliberately do not define va_list when called from
   stdio.h, because ANSI C says that stdio.h is not supposed to define
   va_list.  stdio.h needs to have access to that data type, 
   but must not use that name.  It should use the name __gnuc_va_list,
   which is safe because it is reserved for the implementation.  */

#ifdef _HIDDEN_VA_LIST  /* On OSF1, this means varargs.h is "half-loaded".  */
#undef _VA_LIST
#endif

#ifdef _BSD_VA_LIST
#undef _BSD_VA_LIST
#endif

#if defined(__svr4__) || (defined(_SCO_DS) && !defined(__VA_LIST))
/* SVR4.2 uses _VA_LIST for an internal alias for va_list,
   so we must avoid testing it and setting it here.
   SVR4 uses _VA_LIST as a flag in stdarg.h, but we should
   have no conflict with that.  */
#ifndef _VA_LIST_
#define _VA_LIST_
#ifdef __i860__
#ifndef _VA_LIST
#define _VA_LIST va_list
#endif
#endif /* __i860__ */
typedef __gnuc_va_list va_list;
#ifdef _SCO_DS
#define __VA_LIST
#endif
#endif /* _VA_LIST_ */
#else /* not __svr4__ || _SCO_DS */

/* The macro _VA_LIST_ is the same thing used by this file in Ultrix.
   But on BSD NET2 we must not test or define or undef it.
   (Note that the comments in NET 2's ansi.h
   are incorrect for _VA_LIST_--see stdio.h!)  */
#if !defined (_VA_LIST_) || defined (__BSD_NET2__) || defined (____386BSD____) || defined (__bsdi__) || defined (__sequent__) || defined (__FreeBSD__) || defined(WINNT)
/* The macro _VA_LIST_DEFINED is used in Windows NT 3.5  */
#ifndef _VA_LIST_DEFINED
/* The macro _VA_LIST is used in SCO Unix 3.2.  */
#ifndef _VA_LIST
/* The macro _VA_LIST_T_H is used in the Bull dpx2  */
#ifndef _VA_LIST_T_H
/* The macro __va_list__ is used by BeOS.  */
#ifndef __va_list__
typedef __gnuc_va_list va_list;
#endif /* not __va_list__ */
#endif /* not _VA_LIST_T_H */
#endif /* not _VA_LIST */
#endif /* not _VA_LIST_DEFINED */
#if !(defined (__BSD_NET2__) || defined (____386BSD____) || defined (__bsdi__) || defined (__sequent__) || defined (__FreeBSD__))
#define _VA_LIST_
#endif
#ifndef _VA_LIST
#define _VA_LIST
#endif
#ifndef _VA_LIST_DEFINED
#define _VA_LIST_DEFINED
#endif
#ifndef _VA_LIST_T_H
#define _VA_LIST_T_H
#endif
#ifndef __va_list__
#define __va_list__
#endif

#endif /* not _VA_LIST_, except on certain systems */

#endif /* not __svr4__ */

#endif /* _STDARG_H */

#endif /* not _ANSI_STDARG_H_ */
#endif /* not _STDARG_H */

Créer un fichier que vous nommez stdarg.h.

Les fonctionnalités se trouvent sur ce lien. https://koor.fr/C/cstdarg/cstdarg.wp

■ Passons maintenant au code PureBasic.

Code : Tout sélectionner

 ; Utilisation d'une bibliothéque C 
; Exemple avec la bibliothéque stdarg.h

; Le fichier d'en-tête <stdarg.h> déclare un type va_list 
; associé à quatres macros permettant de parcourir la liste d'arguments 
; dont le nombre et les types ne sont pas connus par la fonction appelée.


HeaderSection
#include "C:\Purebasic Project\Header Section\stdarg.h"

int add(int nb, ...)
{
  int result = 0;
  int i;
  
  va_list liste_parametres;  

  va_start(liste_parametres, nb);
  
  for (i = 0; i < nb; i++)
    result += va_arg(liste_parametres, int);
    
  va_end(liste_parametres);
  
  return(result);
}
EndHeaderSection


; TEST
Define result

; Addition des 5 nombres "1, 2, 4, 8, 12"
!v_result = add(5, 1, 2, 4, 8, 12);

Debug "Resultat de l'addition " + result
■ J'ai rencontré quelques soucis avant d'arriver à un résultat😕 :
- Le nom du dossier dans lequel se trouve l'entête d'une bibliothèque C doit être obligatoirement renseigné même si celui ci se trouve dans le même dossier que votre code PureBasic.

- Si l'entête de bibliothèque C comporte lui même des includes, vous obtiendrez des erreurs de compilation.

- L'insertion de plusieurs commentaires entre HeaderSection ... EndHeaderSection peut générer des erreurs de compilation.

- Il peut arriver que des mots clés du langage C commencent par des majuscules alors qu'ils sont en minuscules. Exemple for devient For ou return devient Return. Ce qui provoquera des erreurs de compilation.

Re: HeaderSection ... EndHeaderSection

Publié : ven. 26/sept./2025 15:57
par threedslider
Salut @falsam :)

Dans ton 2e poste, si tu veux inclure correctement ton path de ton fichier *.h, il faut que il y est pas de espace entre deux mots tu dois faire genre "Purebasic_Project\Header_Section\stdarg.h", voilà dis moi si ça marche mieux comme ça ?

Bon coding !

Re: HeaderSection ... EndHeaderSection

Publié : lun. 29/sept./2025 11:14
par falsam
threedslider a écrit : ven. 26/sept./2025 15:57 Dans ton 2e poste, si tu veux inclure correctement ton path de ton fichier *.h, il faut que il y est pas de espace entre deux mots tu dois faire genre "Purebasic_Project\Header_Section\stdarg.h", voilà dis moi si ça marche mieux comme ça ?
Hello threedslider,
Le deuxième code fonctionne bien même avec les espaces dans le nom du dossier. Par contre je trouve dommage de devoir indiquer le nom du dossier dans lequel se trouve l'entête (*.h) quand cet entête se trouve dans le même dossier que le code PureBasic.

En fait dans post en question (viewtopic.php?p=219268#p219268) je ne faisais que relater les soucis que j'ai rencontré pour arriver à la solution de ce test.

Un autre souci que j'ai rencontré : J'ai des erreurs de compilation quand j'utilise un include qui lui même fait appel à un autre include, par exemple miniaudio.h qui fait appel à de nombreux #include <stdint.h> , #include <stddef.h>, #include <pthread.h>, #include <stdarg.h>, #include <assert.h>, etc ....

Je n'ai pas la solution pour le moment et je suis dans une phase d'exploration 😉

J'ai hâte de lire vos commentaires si vous avez une expertise sur la façon d'utiliser HeaderSection ... EndHeaderSection.

D'avance merci.