Ядро JavaScript 1.5. Справочник

       

ToString


Возвращает строку, представляющую специфицированный массив и его элементы.

Метод из Реализован в

JavaScript 1.1, NES 2.0Версия ECMA

ECMA-262


Синтаксис

toString()


Параметры

Отсутствуют.


Описание

Объект переопределяет метод toString

из . Для объектов метод toString объединяет массив и возвращает одну строку, содержащую все элементы массива, разделённые запятыми. Например, следующий код создаёт массив и использует toString

для конвертации массива в строку.



var monthNames = new Array("Jan","Feb","Mar","Apr")

myVar=monthNames.toString() // присваивает "Jan,Feb,Mar,Apr" переменной myVar

JavaScript вызывает метод toString

автоматически, когда массив представлен как текстовое значение или когда на массив имеется ссылка при конкатенации строк.


Обратная Совместимость


JavaScript 1.2.

Если Вы специфицируете LANGUAGE="JavaScript1.2" в тэге <SCRIPT>, toString возвращает строку, представляющую исходный код массива. Это то же самое значение, что и значение, возвращаемое методом toSource в JavaScript 1.3 и более поздних версиях.

<SCRIPT LANGUAGE="JavaScript1.2">

var monthNames = new Array("Jan","Feb","Mar","Apr")

myVar=monthNames.toString() // присваивает '["Jan", "Feb", "Mar", "Apr"]'

                            // переменной myVar

</SCRIPT>

См. также


Возвращает строку, представляющую специфицированный Boolean-объект.

Метод из

Реализован в

JavaScript 1.1, NES 2.0Версия ECMA

ECMA-262


Синтаксис

toString()


Параметры

Отсутствуют.


Описание

Объект переопределяет метод toString объекта ; он не наследует . Для -объектов метод toString возвращает строковое представление объекта.

JavaScript вызывает метод toString автоматически, если Boolean представлен как текстовое значение или если на Boolean имеется ссылка при конкатенации строк.

Для объектов и значений встроенный метод toString возвращает строку "true" или "false", в зависимости от значения булева объекта. В следующем коде flag.toString возвращает "true".

var flag = new Boolean(true)

var myVar=flag.toString()


См. также




Возвращает строку исходного кода функции.

Метод из

Реализован вJavaScript 1.1, NES 2.0

Версия ECMAECMA-262


Синтаксис

toString()


Параметры

Отсутствуют.

Описание

Объект переопределяет метод toString объекта ; он не наследует . Для объектов метод toString возвращает строку представления объекта.

JavaScript вызывает метод toString автоматически при представлении как текстового значения или когда на ссылаются при конкатенации строк.

Для объектов встроенный метод toString декомпилирует функцию обратно в JavaScript-исходник, который определяет функцию. Эта строка содержит ключевое слово Function, список аргументов, фигурные скобки и тело функции.

Например, предположим, у нас есть следующий код, определяющий тип объекта Dog

и создающий theDog, объект типа Dog:

Function Dog(name,breed,color,sex) {

   this.name=name

   this.breed=breed

   this.color=color

   this.sex=sex

}

theDog = new Dog("Gabby","Lab","chocolate","girl")

В любое время, когда Dog

используется в строковом контексте, JavaScript автоматически вызывает функцию toString, которая возвращает следующие строки:

Function Dog(name, breed, color, sex) { this.name = name; this.breed = breed; this.color = color; this.sex = sex; }


См. также

.

valueOf">




Возвращает строковое представление JavaArray.

Метод из

Реализован в

JavaScript 1.1, NES 2.0


Параметры

Отсутствуют.


Описание

Вызывает метод java.lang.Object.toString, который возвращает значение следующего выражения:

JavaArray.getClass().getName() + '@' +

     java.lang.Integer.toHexString(JavaArray.hashCode())


Обратная Совместимость

JavaScript 1.3 и ранее.

Метод toString наследуется из объекта Object и возвращает следующее значение:

[object JavaArray]

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.




Метод. Конвертирует JSObject в String.

Переопределяет: toString

в классе java.lang.Object.

Объявление
public String toString()

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.




Возвращает строку, представляющую специфицированный Number-объект.

Метод из Реализован в

JavaScript 1.1Версия ECMA

ECMA-262

Синтаксис

toString()

toString([radix])

Параметр

radix

Цело число в диапазоне от 2 до 36, специфицирующее базу для использования при представлении числовых значений.


Описание

Объект переопределяет метод toString объекта ; он не наследует . Для объектов , метод toString возвращает строковое представление объекта.

JavaScript вызывает метод toString

автоматически, когда число представляется как текстовое значение или когда на число ссылаются в конкатенации строк.

Если Вы используете метод toString

для числовых литералов и числовой литерал не содержит экспоненты и десятичной точки, оставьте пространство перед точкой, предшествующей вызову метода, для предотвращения интерпретации этой точки как десятичной точки.

Для -объектов и значений, встроенный метод toString возвращает строку, представляющую значение числа.

var howMany=10;

alert("howMany.toString() is " + howMany.toString())

alert("45 .toString() is " + 45 .toString())

См. также

, ,

.




Возвращает строку, представляющую специфицированный объект.

Метод из

Реализован вJavaScript 1.0

Версия ECMAECMA-262


Синтаксис

toString()

Описание

Каждый объект имеет метод toString, который автоматически вызывается, если объект представляется как текстовое значение или если на объект имеется ссылка в конкатенации строк. Например, следующие примеры требуют, чтобы theDog был представлен как строка:

document.write(theDog)

document.write("The dog is " + theDog)

По умолчанию метод toString наследуется каждым объектом - потомком от Object. Вы можете переопределять этот метод для специальных/custom объектов, создаваемых Вами. Если Вы не переопределяете toStringв специальном объекте, toString

возвращает [object type], где type  это тип объекта или имя функции constructor, создавшей этот объект.

Например:

var o = new Object()

o.toString // возвращает [object Object]

Встроенные методы toString.

Каждый встроенный объект ядра JavaScript переопределяет метод toString

из Object для возвращения соответствующего значения. JavaScript вызывает этот метод по мере необходимости для конвертации объекта в строку.

 

Переопределение метода toString по умолчанию.

Вы можете создать функцию, вызываемую вместо метода toString

по умолчанию. Метод toString

не принимает аргументов и должен возвращать строку. Метод toString, который Вы создаёте, может иметь любое нужное Вам значение, но он будет лучше использоваться, если будет работать с информацией объекта.

Этот код определяет тип объекта Dog и создаёт theDog, объект типа Dog:

function Dog(name,breed,color,sex) {

   this.name=name

   this.breed=breed

   this.color=color

   this.sex=sex

}

theDog = new Dog("Gabby","Lab","chocolate","girl")

Если Вы вызываете метод toString

в специальном объекте object, он возвращает значение по умолчанию, унаследованное из Object:

theDog.toString() //возвращает [object Object]

Следующий код создаёт dogToString, функцию, которая будет использоваться для переопределения метода toString

по умолчанию. Эта функция генерирует строку, содержащую каждое свойство, в форме "property = value;".

function dogToString() {

   var ret = "Dog " + this.name + " is [\n"

   for (var prop in this)

      ret += " " + prop + " is " + this[prop] + ";\n"

   return ret + "]"

}

Следующий код присваивает определённую пользователем функцию методу toString объекта:

Dog.prototype.toString = dogToString

Замещая предыдущий код, theDog

используется в любой момент в строковом контексте, JavaScript автоматически вызывает функцию dogToString, которая возвращает:

Dog Gabby is [

  name is Gabby;

  breed is Lab;

  color is chocolate;

  sex is girl;

]

Метод toString объекта обычно вызывается JavaScript,но Вы сами можете вызывать его так:

var dogString = theDog.toString()

Обратная Совместимость

JavaScript 1.2.

Поведение метода toString

зависит от того, специфицируете ли Вы LANGUAGE="JavaScript1.2" в тэге <SCRIPT>:

  • Если Вы специфицируете LANGUAGE="JavaScript1.2"

    в тэге <SCRIPT>, метод toString возвращает литерал объекта.

  • Если Вы не специфицируете LANGUAGE="JavaScript1.2" в тэге <SCRIPT>, метод toString возвращает[object type], как в других версиях JavaScript.


  • Примеры

    Пример 1:

    Объект location. Здесь печатается строковой эквивалент текущего location.

    document.write("location.toString() это " + location.toString() + "<BR>")

    На выходе будет:

    location.toString() это file:///C|/TEMP/myprog.htmll

    Пример 2:

    Объект без строкового значения. Предположим, у Вас есть объект Image

    с именем sealife, определённый так:

    <IMG NAME="sealife" SRC="images\seaotter.gif" ALIGN="left" VSPACE="10">

    Поскольку сам объект Image

    не имеет специального метода toString, sealife.toString() возвращает:

    [object Image]

     

    Пример 3:

    Параметр radix. Этот код печатает строковые эквиваленты чисел от 0 до 9 в десятичном и двоичном виде.

    for (x = 0; x < 10; x++) {

       document.write("Decimal: ", x.toString(10), " Binary: ",

          x.toString(2), "<BR>")

    }

    На выходе будет:

    Decimal: 0 Binary: 0

    Decimal: 1 Binary: 1

    Decimal: 2 Binary: 10

    Decimal: 3 Binary: 11

    Decimal: 4 Binary: 100

    Decimal: 5 Binary: 101

    Decimal: 6 Binary: 110

    Decimal: 7 Binary: 111

    Decimal: 8 Binary: 1000

    Decimal: 9 Binary: 1001

    См. также

    ,

    .




    Возвращает строку, представляющую специфицированный объект.

    Метод из Реализован вJavaScript 1.1, NES 2.0

    Версия ECMAECMA 262, Edition 3


    Синтаксис

    toString()

    Параметры

    Отсутствуют.

    Описание

    Объект переопределяет метод toString

    объекта ; он не наследует . Для объектов метод toString возвращает строку, представляющую специфицированный объект.


    Примеры

    Отображается строковое значение RegExp-объекта:

    myExp = new RegExp("a+b+c");

    alert(myExp.toString())         displays "/a+b+c/"

    См. также

    .

          

    Copyright © 2000 Все права зарезервированы.

    Дата последнего обновления: 28 сентября 2000 г.




    Возвращает строку, представляющую специфицированный объект.

    Метод из

    Реализован вJavaScript 1.1, NES 2.0

    Версия ECMA

    ECMA-262

    Синтаксис

    toString()

    Параметры

    Отсутствуют.


    Описание

    Объект переопределяет метод toString объекта ; он не наследует . Для -объектов метод toString

    возвращает строковое представление объекта.


    Примеры

    В этом примере выводится строковое значение String-объекта:

    x = new String("Hello world");

    alert(x.toString())      // Выводится "Hello world"

    См. также

    .



    Содержание раздела