DESCRIPTION.

Remplace une ou des suites d'octets par une autre dans un tableau d'octets parent, et retourne les modifications dans un nouveau tableau d'octets.

SYNTAXE.

BYA_Titre = tableau.replace ( origine , image , quota )

BYA_Titre = ⇨ variable qui recevra la chaine [ optionnel ]

tableau ⇨ tableau d'octets [ OBLIGATOIRE ]

.replace ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

origine ⇨ suite d'octets à remplacer [ OBLIGATOIRE ]

image ⇨ suite d'octets de remplacement [ OBLIGATOIRE ]

quota ⇨ occurrences à remplacer [ optionnel ]

REMARQUES.

tableau doit être un objet de type bytearray ( ) valide. 

origine et image doivent être du type bytes ( ) ou bytearray ( ). Si aucune occurrence de origine n'est présente dans tableau, la méthode bytearray ( ).replace ( ) retourne un nouvel objet bytearray ( ) contenant la même suite d'octets que tableau.

quota doit être un int ( ). Si quota est précisé, seules les premières quota suites d'octets de origine seront remplacées par image, les autres resteront inchangées. Si quota est omis, toutes les suites d'octets origine seront commutées en image.

Bien que tableau soit du type bytearray ( ), un tableau d'octets muable, la méthode bytearray ( ).replace ( ) ne modifie pas l'objet appelant, mais crée et retourne un nouveau objet bytearray ( ) avec les modifications demandées.

EXEMPLES.

BYA_Titre = bytearray ( b"Mon Python a moi." )

print ( BYA_Titre.replace ( b"a moi" , b"pour tous" ) ) retourne bytearray(b'Mon Python pour tous.')

print ( bytearray ( "Maun Pythaun à maui." , "utf-8" ).replace ( b"au" , b"o" ) ) retourne bytearray(b'Mon Python \xc3\xa0 moi.')

print ( BYA_Titre.replace ( b"o" , b"oOOo" , 2 ) ) retourne bytearray(b'MoOOon PythoOOon a moi.')

BYA_Titre = bytearray ( "Mon Python à moi." , "utf-8" )

BYA_Origine = bytearray ( "à moi." , "utf-8" )

BYA_Image = bytearray ( "POUR TOUS !!!" , "utf-8" )

BYA_Titre = BYA_Titre.replace ( BYA_Origine , BYA_Image )

print ( BYA_Titre ) retourne bytearray(b'Mon Python POUR TOUS !!!')