From 844f5103992238c0c23203286dad16a466e89c97 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:09 +0200 Subject: move *.html to *.md --- .../global_objects/string/substr/index.html | 136 --------------------- .../global_objects/string/substr/index.md | 136 +++++++++++++++++++++ 2 files changed, 136 insertions(+), 136 deletions(-) delete mode 100644 files/fr/web/javascript/reference/global_objects/string/substr/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/string/substr/index.md (limited to 'files/fr/web/javascript/reference/global_objects/string/substr') diff --git a/files/fr/web/javascript/reference/global_objects/string/substr/index.html b/files/fr/web/javascript/reference/global_objects/string/substr/index.html deleted file mode 100644 index 9ee8253861..0000000000 --- a/files/fr/web/javascript/reference/global_objects/string/substr/index.html +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: String.prototype.substr() -slug: Web/JavaScript/Reference/Global_Objects/String/substr -tags: - - Déprécié - - JavaScript - - Méthode - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String/substr -original_slug: Web/JavaScript/Reference/Objets_globaux/String/substr ---- -
{{JSRef}}
- -

Attention : Bien que String.prototype.substr(…) ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de l'Annexe B du standard ECMA-262 qui définit l'ensemble des fonctionnalités historiques qui doivent être évitées autant que possible. On utilisera la méthode {{jsxref("String.prototype.substring()")}} à la place.

- -

La méthode substr() retourne la partie d'une chaîne de caractères comprise entre l'indice de départ et un certain nombre de caractères après celui-ci.

- -
{{EmbedInteractiveExample("pages/js/string-substr.html")}}
- -

Syntaxe

- -
chn.substr(début[, longueur])
- -

Paramètres

- -
-
début
-
L'indice du premier caractère à inclure dans la sous-chaîne retournée.
-
longueur
-
Optionnel. Le nombre de caractères à extraire.
-
- -

Valeur de retour

- -

Une nouvelle chaîne contenant la partie indiquée de la chaîne donnée.

- -

Description

- -

substr() extrait longueur caractères d'une string, en comptant à partir de l'indice début.

- -

Si début est un nombre positif, l'indice commence à compter du début de la chaîne. Sa valeur est limitée à chn.length.

- -

Si début est un nombre négatif, l'indice commence à compter de la fin de la chaîne. Sa valeur est limitée à -chn.length.

- -

Note : dans JScript de Microsoft, les valeurs négatives de l'argument début ne sont pas considérées comme faisant référence à la fin de la chaîne.

- -

Si longueur est omise, substr() extrait les caractères jusqu'à la fin de la chaîne.

- -

Si longueur est {{jsxref("undefined")}}, substr() extrait les caractères jusqu'à la fin de la chaîne.

- -

Si longueur est négative, elle est traitée comme 0.

- -

Pour début comme pour longueur, NaN est traité comme 0.

- -

Exemples

- -
var uneChaine = 'Mozilla';
-
-console.log(uneChaine.substr(0, 1));   // 'M'
-console.log(uneChaine.substr(1, 0));   // ''
-console.log(uneChaine.substr(-1, 1));  // 'a'
-console.log(uneChaine.substr(1, -1));  // ''
-console.log(uneChaine.substr(-3));     // 'lla'
-console.log(uneChaine.substr(1));      // 'ozilla'
-console.log(uneChaine.substr(-20, 2)); // 'Mo'
-console.log(uneChaine.substr(20, 2));  // ''
- -

Prothèse d'émulation (polyfill)

- -

JScript de Microsoft ne supporte pas les valeurs négatives pour l'indice de début. Pour utiliser cette fonctionnalité, vous pouvez utiliser le code suivant :

- -
// N'appliquer que lorsque la fonction est incomplète
-if ('ab'.substr(-1) != 'b') {
-  /**
-   *  Obtenir la sous-chaîne d'une chaîne
-   *  @param  {entier}  début     où démarrer la sous-chaîne
-   *  @param  {entier}  longueur  combien de caractères à retourner
-   *  @return {chaîne}
-   */
-  String.prototype.substr = function(substr) {
-    return function(début, longueur) {
-      // Appel de la méthode originale
-      return substr.call(this,
-        // Si on a un début négatif, calculer combien il vaut à partir du début de la chaîne
-        // Ajuster le paramètre pour une valeur négative
-        début < 0 ? this.length + début : début,
-        longueur)
-    }
-  }(String.prototype.substr);
-}
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES3')}}{{Spec2('ES3')}}Définie dans la Compatibility Annex B (informative). Implémentée dans JavaScript 1.0.
{{SpecName('ES5.1', '#sec-B.2.3', 'String.prototype.substr')}}{{Spec2('ES5.1')}}Définie dans la Compatibility Annex B (informative).
{{SpecName('ES6', '#sec-string.prototype.substr', 'String.prototype.substr')}}{{Spec2('ES6')}}Définie dans l'Annex B (normative) pour les Additional ECMAScript Features for Web Browsers.
{{SpecName('ESDraft', '#sec-string.prototype.substr', 'String.prototype.substr')}}{{Spec2('ESDraft')}}Définie dans l'Annex B (normative) pour les Additional ECMAScript Features for Web Browsers
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.String.substr")}}

- -

Voir aussi

- - diff --git a/files/fr/web/javascript/reference/global_objects/string/substr/index.md b/files/fr/web/javascript/reference/global_objects/string/substr/index.md new file mode 100644 index 0000000000..9ee8253861 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/string/substr/index.md @@ -0,0 +1,136 @@ +--- +title: String.prototype.substr() +slug: Web/JavaScript/Reference/Global_Objects/String/substr +tags: + - Déprécié + - JavaScript + - Méthode + - Prototype + - Reference + - String +translation_of: Web/JavaScript/Reference/Global_Objects/String/substr +original_slug: Web/JavaScript/Reference/Objets_globaux/String/substr +--- +
{{JSRef}}
+ +

Attention : Bien que String.prototype.substr(…) ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de l'Annexe B du standard ECMA-262 qui définit l'ensemble des fonctionnalités historiques qui doivent être évitées autant que possible. On utilisera la méthode {{jsxref("String.prototype.substring()")}} à la place.

+ +

La méthode substr() retourne la partie d'une chaîne de caractères comprise entre l'indice de départ et un certain nombre de caractères après celui-ci.

+ +
{{EmbedInteractiveExample("pages/js/string-substr.html")}}
+ +

Syntaxe

+ +
chn.substr(début[, longueur])
+ +

Paramètres

+ +
+
début
+
L'indice du premier caractère à inclure dans la sous-chaîne retournée.
+
longueur
+
Optionnel. Le nombre de caractères à extraire.
+
+ +

Valeur de retour

+ +

Une nouvelle chaîne contenant la partie indiquée de la chaîne donnée.

+ +

Description

+ +

substr() extrait longueur caractères d'une string, en comptant à partir de l'indice début.

+ +

Si début est un nombre positif, l'indice commence à compter du début de la chaîne. Sa valeur est limitée à chn.length.

+ +

Si début est un nombre négatif, l'indice commence à compter de la fin de la chaîne. Sa valeur est limitée à -chn.length.

+ +

Note : dans JScript de Microsoft, les valeurs négatives de l'argument début ne sont pas considérées comme faisant référence à la fin de la chaîne.

+ +

Si longueur est omise, substr() extrait les caractères jusqu'à la fin de la chaîne.

+ +

Si longueur est {{jsxref("undefined")}}, substr() extrait les caractères jusqu'à la fin de la chaîne.

+ +

Si longueur est négative, elle est traitée comme 0.

+ +

Pour début comme pour longueur, NaN est traité comme 0.

+ +

Exemples

+ +
var uneChaine = 'Mozilla';
+
+console.log(uneChaine.substr(0, 1));   // 'M'
+console.log(uneChaine.substr(1, 0));   // ''
+console.log(uneChaine.substr(-1, 1));  // 'a'
+console.log(uneChaine.substr(1, -1));  // ''
+console.log(uneChaine.substr(-3));     // 'lla'
+console.log(uneChaine.substr(1));      // 'ozilla'
+console.log(uneChaine.substr(-20, 2)); // 'Mo'
+console.log(uneChaine.substr(20, 2));  // ''
+ +

Prothèse d'émulation (polyfill)

+ +

JScript de Microsoft ne supporte pas les valeurs négatives pour l'indice de début. Pour utiliser cette fonctionnalité, vous pouvez utiliser le code suivant :

+ +
// N'appliquer que lorsque la fonction est incomplète
+if ('ab'.substr(-1) != 'b') {
+  /**
+   *  Obtenir la sous-chaîne d'une chaîne
+   *  @param  {entier}  début     où démarrer la sous-chaîne
+   *  @param  {entier}  longueur  combien de caractères à retourner
+   *  @return {chaîne}
+   */
+  String.prototype.substr = function(substr) {
+    return function(début, longueur) {
+      // Appel de la méthode originale
+      return substr.call(this,
+        // Si on a un début négatif, calculer combien il vaut à partir du début de la chaîne
+        // Ajuster le paramètre pour une valeur négative
+        début < 0 ? this.length + début : début,
+        longueur)
+    }
+  }(String.prototype.substr);
+}
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('ES3')}}{{Spec2('ES3')}}Définie dans la Compatibility Annex B (informative). Implémentée dans JavaScript 1.0.
{{SpecName('ES5.1', '#sec-B.2.3', 'String.prototype.substr')}}{{Spec2('ES5.1')}}Définie dans la Compatibility Annex B (informative).
{{SpecName('ES6', '#sec-string.prototype.substr', 'String.prototype.substr')}}{{Spec2('ES6')}}Définie dans l'Annex B (normative) pour les Additional ECMAScript Features for Web Browsers.
{{SpecName('ESDraft', '#sec-string.prototype.substr', 'String.prototype.substr')}}{{Spec2('ESDraft')}}Définie dans l'Annex B (normative) pour les Additional ECMAScript Features for Web Browsers
+ +

Compatibilité des navigateurs

+ +

{{Compat("javascript.builtins.String.substr")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf