lundi 25 octobre 2021

Les fonctions prédéfinies

 

Qu'est-ce qu'une fonction prédéfinie ?


Une fonction est un morceau de code permettant d'automatiser un traitement ou de donner un affichage particulier.

Dans la langue Française, vous avez la possibilité de consulter un dictionnaire pour voir les mots et expressions existant(e)s.
Tout comme notre langue, Php possède plusieurs mots-clés et fonctions déjà existants dans le langage, nous pourrons les retrouver dans la documentation officielle de PHP.

Afficher la date du jour avec la fonction date()

Prenons un exemple pour afficher la date du jour :

1
2
3
<?php   
echo 'Date : <br>';
echo date("d/m/Y");


Lorsque vous voyez un mot-clé (qui n'est pas le votre), en anglais, suivi de parenthèse, c'est qu'il s'agit d'une fonction prédéfinie de PHP.

résultat

25/10/2021



Explications

La fonction date permet d'afficher la date avec les arguments suivants :

  • d : pour day (jour)

  • m : pour month (mois)

  • Y : pour année

Le fait de mettre les arguments (d/m/Y) en minuscule ou majuscule à une incidence sur le résultat. Faites le test !


Qu'est-ce qu'un argument ?

Un argument (aussi appelé paramètre) est une information entrante dans la fonction.

Afficher la taille d'une chaine avec la fonction strlen()

1
2
3
<?php   
$phrase = 'Mettez une phrase différente ici à cet endroit!';
echo strlen($phrase);

Nous transmettons l'argument (argument = paramètre) $phrase à la fonction prédéfinie strlen().

résultat

47


strlen() est une fonction prédéfinie permettant de retourner la taille (nombre de caractères) d'une chaine.

Les valeurs de retours sont :
- En cas de succès : INT
- En cas d'échec : BOOLEAN FALSE

Argument(s) :
1. Nous devons lui fournir la chaine à évaluer (pour connaitre la taille).

Il faut lui envoyer un texte, une phrase ou un mot (par l'intermédiaire d'une variable ou non), car pour vous renvoyer "la taille de quelque chose", il lui faut ce "quelque chose", cette fonction a donc besoin d'une information de départ pour compter le nombre de caractères, on appelle cette information un argument (ou paramètre).

Contexte : cela pourra être pratique lorsque nous souhaiterons connaitre le nombre de caractères dans un pseudo qui nous est transmis (lors d'une inscription).

Couper une chaine avec la fonction substr()

1
2
3
<?php   
$texte = "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged.";
echo substr($texte, 0, 20) . "...<a href="\"\""> Lire la suite </a>";

Nous transmettons l'argument (aussi appelé paramètre) $texte à la fonction prédéfinie substr() ainsi que 2 nombres (int).

résultat

Lorem Ipsum is simpl... Lire la suite


substr() est une fonction prédéfinie permettant d'afficher une partie coupée d'une chaine.

Les valeurs de retours sont :
En cas de succès : STRING
En cas d'échec : BOOLEAN FALSE

Argument(s) attendus :
1. nous devons lui fournir la chaine que l'on souhaite couper (string)
2. nous devons lui préciser la position de début (int)
3. nous devons lui préciser la position de fin (int)

Dans le cas présent, nous lui demandons d'afficher seulement les 20 premiers caractères de notre phrase (0,20).
Vous pouvez demander les 50 premiers caractères en modifiants les arguments entrants par : 0,50.

Contexte: substr est souvent utilisé pour afficher des actualités avec une "accroche".
Sur le web, il n'est pas rare de voir le début d'un article (l'accroche) puis ...lire la suite.

Cela ne veut pas dire que c'est toujours fait avec la fonction substr, parfois le texte affiché est un résumé et non le début de l'article.

Pour ne pas couper un mot il y a d'autres fonctions prédéfinies qui existent.

Tester l'existance d'une variable avec isset()

Il est possible de se servir de fonction prédéfinie dans le cadre de nos conditions, voici un exemple avec ISSET :

1
2
3
4
5
6
7
8
9
10
<?php
$pseudo = "joker";
if(isset($pseudo))
{
    echo 'la variable $pseudo existe!<br>';
}
else
{
    echo 'la variable $pseudo n\'existe PAS!<br>';
}
Résultat

la variable $pseudo existe!


Autre cas, cette fois-ci, sans déclarer la variable $pseudo :

1
2
3
4
5
6
7
8
9
<?php
if(isset($pseudo))
{
    echo 'la variable $pseudo existe!<br>';
}
else
{
    echo 'la variable $pseudo n\'existe PAS!<br>';
}
Résultat

la variable $pseudo n'existe PAS!



isset() est une fonction prédéfinie permettant de dire si une variable existe ou non (et différent de null).

Les valeurs de retours sont :
En cas de succès : boolean TRUE (la variable existe)
En cas d'échec : boolean FALSE (la variable n'existe pas)

Argument(s) attendus :
1. nous devons lui fournir la variable que l'on souhaite tester

Tester le contenu d'une variable avec empty()

Différent de isset, voici un exemple avec la fonction prédéfinie EMPTY :

1
2
3
4
5
6
7
8
9
10
<?php
$pseudo = "joker";
if(empty($pseudo))
{
    echo 'la variable $pseudo est vide!<br>';
}
else
{
    echo 'la variable $pseudo n\'est pas vide (et est donc remplie).<br>';
}
Résultat

la variable $pseudo n'est pas vide (et est donc remplie)!


Autre cas, cette fois-ci, sans remplir la variable $pseudo :

1
2
3
4
5
6
7
8
9
10
<?php
$pseudo = "";
if(empty($pseudo))
{
    echo 'la variable $pseudo est vide!<br>';
}
else
{
    echo 'la variable $pseudo n\'est pas vide (et est donc remplie)!<br>';
}
Résultat

la variable $pseudo est vide!



empty() est une fonction prédéfinie permettant de dire si une variable est vide ou non. (False sera considéré comme empty).

Les valeurs de retours sont :
En cas de succès : boolean TRUE (la variable est vide)
En cas d'échec : boolean FALSE (la variable n'est pas vide et est donc remplie)

Argument(s) attendus :
1. nous devons lui fournir la variable que l'on souhaite tester

Il est également possible de demander l'inverse "si ça n'est pas vide" avec l'opérateur !

1
2
3
4
5
6
<?php
$pseudo = "joker";
if(!empty($pseudo))
{
    echo 'la variable $pseudo n\'est pas vide (et est donc remplie)!<br>';
}

La simple présence du "!" (point d'exclamation) dans les parenthèses du IF permet de changer le sens de la condition, cette fois nous demandons : est-ce que la variable $pseudo n'est pas vide ? (en gros, est-elle remplie ?).

Résultat

la variable $pseudo n\'est pas vide (et est donc remplie)!



De nombreuses autres fonctions prédéfinies existent et pour toute sorte de chose, nous y reviendrons, d'ici là vous pouvez mettre en favoris le site de la documentation officielle de PHP.

On dit souvent qu'un bon développeur n'est pas celui qui connait le code par coeur mais celui qui sait lire et interpréter une documentation, avoir les bons mots-clés dans ses recherches Google, et être autonome dans l'exploitation et la mise en oeuvre du code.

Aucun commentaire:

Enregistrer un commentaire