PokeS

PokeS()

Syntaxe

Resultat = PokeS(*Memoire, Texte$ [, Longueur [, Options]])

Description

Ecrit une chaîne de caractères, suivi d'un caractère #NULL de fin de chaîne en mémoire.

Arguments

*Memoire L'adresse mémoire où écrire.

Texte$ La chaîne de caractères à écrire.

Longueur (optionnel) Longueur maximale (en caractères).

Si ce paramètre n'est pas spécifié ou égal à -1 alors toute la chaîne est écrite.
Le caractère #NULL de fin de chaîne qui est toujours écrit (sauf si #PB_String_NoZero est défini) n'est pas inclus dans ce décompte.
Options (optionnel)
Peut prendre l'une des valeurs suivantes:
  #PB_Ascii  : Format ASCII
  #PB_UTF8   : Format UTF-8
  #PB_Unicode: Format Unicode (Par défaut)
  Combiné avec
  #PB_String_NoZero: N'écrit pas le caractère #NULL de fin de chaîne.

Valeur de retour

Renvoie le nombre d'octets écrits, non compris le caractère #NULL de fin de chaîne.
Le nombre d'octets écrit diffère de la longueur de la chaîne en caractères si le format est #PB_UTF8 ou #PB_Unicode.

Exemple

  *MemoireID = AllocateMemory(5000)
  If *MemoireID
    PokeS(*MemoireID, "PureBasic hé")   ; Stocke cette valeur dans la zone mémoire")
    Debug PeekS(*MemoireID)             ; Lit cette valeur depuis la zone mémoire")
    FreeMemory(*MemoireID)  
  Else
    Debug "Impossible d'allouer la mémoire demandée !"
  EndIf

Voir aussi

PeekS(), CopyMemoryString()

OS Supportés

Tous

<- PokeQ() - Memory Index - PokeU() ->

*Memoire	L'adresse mémoire où écrire.
Texte$	La chaîne de caractères à écrire.
Longueur (optionnel)	Longueur maximale (en caractères). Si ce paramètre n'est pas spécifié ou égal à -1 alors toute la chaîne est écrite. Le caractère #NULL de fin de chaîne qui est toujours écrit (sauf si #PB_String_NoZero est défini) n'est pas inclus dans ce décompte.
Options (optionnel)	Peut prendre l'une des valeurs suivantes: #PB_Ascii : Format ASCII #PB_UTF8 : Format UTF-8 #PB_Unicode: Format Unicode (Par défaut) Combiné avec #PB_String_NoZero: N'écrit pas le caractère #NULL de fin de chaîne.