DESCRIPTION.

Assemble plusieurs str ( ) en les séparant du symbole delimitant les répertoires dans un nom de chemin.

SYNTAXE.

Variable = os.path.join ( base , liste )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

os.path.join ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

base ⇨ premier élément du chemin [ OBLIGATOIRE ]

liste ⇨ liste des éléments à assembler [ OBLIGATOIRE ]

REMARQUES.

base peut être un str ( ) ou un bytes ( ) désignant un emplacement valide.

liste peut être plusieurs str ( ) ou bytes ( ), séparé d'une virgule, désignant des emplacements valides de façon relative.

L'appel de la méthode os.path.join ( ) correspond à l’utilisation de la sous-méthode str ( ).join ( ) de la forme os.path.sep.join ( ( base , liste ) ).

Si l'un des élément de liste est un chaine de caractères vide ("") il sera ignoré, sauf s'il s'agit du dernier élément de liste. Ainsi, placer une chaine de caractères vide en dernière position, retournera un emplacement se terminant par un symbole de séparation, c'est-à-dire d'un nom de répertoire.

Si l'un des éléments de liste correspond à un nom de chemin absolu, c'est-à-dire commençant par le symbole de séparation, / sous UNIX ou \ précédé du lecteur et une racine sous Windows de Microsoft, alors tous les éléments précédents seront ignorés et la chaine de caractères retournée commencera par cet élément.

Voir la méthode os.path.basename ( ) qui retourne le nom du fichier de chemin.

Voir la méthode os.path.dirname ( ) qui retourne le répertoire de chemin.

Voir la méthode os.path.split ( ) qui retourne os.path.dirname ( ) et os.path.basename ( ) dans un tuple ( ).

Voir la méthode os.path.splitdrive ( ) qui retourne le lecteur de chemin.

Voir la méthode os.path.splitext ( ) qui retourne l'extension d'un fichier, identifiant son type.

EXEMPLE.

import os.path

print ( os.path.join ( "lib" , "firmware" , "nvidia" , "tu104" ) )

print ( os.path.join ( "lib" , "firmware" , "nvidia" , "tu104" , "" ) )

print ( os.path.sep.join ( ( "lib" , "firmware" , "nvidia" , "tu104" , "" ) ) )

print ( os.path.join ( "lib" , "firmware" , "nvidia" , "tu104"  , "readme.txt" ) )