lukechilds
/
node
mirror of https://github.com/lukechilds/node.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

doc: sort util alphabetically 

Reorders, with no contextual changes, the util documentation
alphabetically.

PR-URL: https://github.com/nodejs/node/pull/3662
Reviewed-By: Evan Lucas <evanlucas@me.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com>
v5.x
Tristian Flanagan 9 years ago
committed by Rod Vagg
parent
df07072b66
commit
0996b97240
1 changed files with 149 additions and 153 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 302
      doc/api/util.markdown

302
doc/api/util.markdown
View File

@ -12,6 +12,12 @@ purposes, however, you are encouraged to write your own utilities. We
are not interested in any future additions to the `util` module that
are unnecessary for node.js's internal functionality.
## util.debug(string)
Stability: 0 - Deprecated: use console.error() instead.
Deprecated predecessor of `console.error`.
## util.debuglog(section)
* `section` {String} The section of the program to be debugged
@ -43,6 +49,40 @@ environment variable set, then it will not print anything.
You may separate multiple `NODE_DEBUG` environment variables with a
comma. For example, `NODE_DEBUG=fs,net,tls`.
## util.deprecate(function, string)
Marks that a method should not be used any more.
var util = require('util');
exports.puts = util.deprecate(function() {
for (var i = 0, len = arguments.length; i < len; ++i) {
process.stdout.write(arguments[i] + '\n');
}
}, 'util.puts: Use console.log instead');
It returns a modified function which warns once by default.
If `--no-deprecation` is set then this function is a NO-OP. Configurable
at run-time through the `process.noDeprecation` boolean (only effective
when set before a module is loaded.)
If `--trace-deprecation` is set, a warning and a stack trace are logged
to the console the first time the deprecated API is used. Configurable
at run-time through the `process.traceDeprecation` boolean.
If `--throw-deprecation` is set then the application throws an exception
when the deprecated API is used. Configurable at run-time through the
`process.throwDeprecation` boolean.
`process.throwDeprecation` takes precedence over `process.traceDeprecation`.
## util.error([...])
Stability: 0 - Deprecated: Use console.error() instead.
Deprecated predecessor of `console.error`.
## util.format(format[, ...])
Returns a formatted string using the first argument as a `printf`-like format.
@ -74,12 +114,38 @@ Each argument is converted to a string with `util.inspect()`.
util.format(1, 2, 3); // '1 2 3'
## util.inherits(constructor, superConstructor)
## util.log(string)
Inherit the prototype methods from one
[constructor](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor)
into another. The prototype of `constructor` will be set to a new
object created from `superConstructor`.
Output with timestamp on `stdout`.
As an additional convenience, `superConstructor` will be accessible
through the `constructor.super_` property.
require('util').log('Timestamped message.');
var util = require("util");
var EventEmitter = require("events");
function MyStream() {
EventEmitter.call(this);
}
util.inherits(MyStream, EventEmitter);
MyStream.prototype.write = function(data) {
this.emit("data", data);
}
var stream = new MyStream();
console.log(stream instanceof EventEmitter); // true
console.log(MyStream.super_ === EventEmitter); // true
stream.on("data", function(data) {
console.log('Received data: "' + data + '"');
})
stream.write("It works!"); // Received data: "It works!"
## util.inspect(object[, options])
@ -164,7 +230,6 @@ formatted according to the returned Object. This is similar to how
util.inspect(obj);
// "{ bar: 'baz' }"
## util.isArray(object)
Stability: 0 - Deprecated
@ -182,20 +247,37 @@ Returns `true` if the given "object" is an `Array`. `false` otherwise.
util.isArray({})
// false
## util.isRegExp(object)
## util.isBoolean(object)
Stability: 0 - Deprecated
Returns `true` if the given "object" is a `RegExp`. `false` otherwise.
Returns `true` if the given "object" is a `Boolean`. `false` otherwise.
var util = require('util');
util.isRegExp(/some regexp/)
// true
util.isRegExp(new RegExp('another regexp'))
util.isBoolean(1)
// false
util.isBoolean(0)
// false
util.isBoolean(false)
// true
util.isRegExp({})
## util.isBuffer(object)
Stability: 0 - Deprecated
Use `Buffer.isBuffer()` instead.
Returns `true` if the given "object" is a `Buffer`. `false` otherwise.
var util = require('util');
util.isBuffer({ length: 0 })
// false
util.isBuffer([])
// false
util.isBuffer(new Buffer('hello world'))
// true
## util.isDate(object)
@ -227,19 +309,22 @@ Returns `true` if the given "object" is an `Error`. `false` otherwise.
util.isError({ name: 'Error', message: 'an error occurred' })
// false
## util.isBoolean(object)
## util.isFunction(object)
Stability: 0 - Deprecated
Returns `true` if the given "object" is a `Boolean`. `false` otherwise.
Returns `true` if the given "object" is a `Function`. `false` otherwise.
var util = require('util');
util.isBoolean(1)
// false
util.isBoolean(0)
function Foo() {}
var Bar = function() {};
util.isFunction({})
// false
util.isBoolean(false)
util.isFunction(Foo)
// true
util.isFunction(Bar)
// true
## util.isNull(object)
@ -289,54 +374,6 @@ Returns `true` if the given "object" is a `Number`. `false` otherwise.
util.isNumber(NaN)
// true
## util.isString(object)
Stability: 0 - Deprecated
Returns `true` if the given "object" is a `String`. `false` otherwise.
var util = require('util');
util.isString('')
// true
util.isString('foo')
// true
util.isString(String('foo'))
// true
util.isString(5)
// false
## util.isSymbol(object)
Stability: 0 - Deprecated
Returns `true` if the given "object" is a `Symbol`. `false` otherwise.
var util = require('util');
util.isSymbol(5)
// false
util.isSymbol('foo')
// false
util.isSymbol(Symbol('foo'))
// true
## util.isUndefined(object)
Stability: 0 - Deprecated
Returns `true` if the given "object" is `undefined`. `false` otherwise.
var util = require('util');
var foo;
util.isUndefined(5)
// false
util.isUndefined(foo)
// true
util.isUndefined(null)
// false
## util.isObject(object)
Stability: 0 - Deprecated
@ -355,24 +392,6 @@ Returns `true` if the given "object" is strictly an `Object` __and__ not a
util.isObject(function(){})
// false
## util.isFunction(object)
Stability: 0 - Deprecated
Returns `true` if the given "object" is a `Function`. `false` otherwise.
var util = require('util');
function Foo() {}
var Bar = function() {};
util.isFunction({})
// false
util.isFunction(Foo)
// true
util.isFunction(Bar)
// true
## util.isPrimitive(object)
Stability: 0 - Deprecated
@ -400,102 +419,74 @@ Returns `true` if the given "object" is a primitive type. `false` otherwise.
util.isPrimitive(new Date())
// false
## util.isBuffer(object)
## util.isRegExp(object)
Stability: 0 - Deprecated
Use `Buffer.isBuffer()` instead.
Returns `true` if the given "object" is a `Buffer`. `false` otherwise.
Returns `true` if the given "object" is a `RegExp`. `false` otherwise.
var util = require('util');
util.isBuffer({ length: 0 })
// false
util.isBuffer([])
// false
util.isBuffer(new Buffer('hello world'))
util.isRegExp(/some regexp/)
// true
util.isRegExp(new RegExp('another regexp'))
// true
util.isRegExp({})
// false
## util.inherits(constructor, superConstructor)
Inherit the prototype methods from one
[constructor](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor)
into another. The prototype of `constructor` will be set to a new
object created from `superConstructor`.
As an additional convenience, `superConstructor` will be accessible
through the `constructor.super_` property.
var util = require("util");
var EventEmitter = require("events");
function MyStream() {
EventEmitter.call(this);
}
util.inherits(MyStream, EventEmitter);
MyStream.prototype.write = function(data) {
this.emit("data", data);
}
var stream = new MyStream();
console.log(stream instanceof EventEmitter); // true
console.log(MyStream.super_ === EventEmitter); // true
stream.on("data", function(data) {
console.log('Received data: "' + data + '"');
})
stream.write("It works!"); // Received data: "It works!"
## util.isString(object)
## util.deprecate(function, string)
Stability: 0 - Deprecated
Marks that a method should not be used any more.
Returns `true` if the given "object" is a `String`. `false` otherwise.
var util = require('util');
exports.puts = util.deprecate(function() {
for (var i = 0, len = arguments.length; i < len; ++i) {
process.stdout.write(arguments[i] + '\n');
}
}, 'util.puts: Use console.log instead');
It returns a modified function which warns once by default.
util.isString('')
// true
util.isString('foo')
// true
util.isString(String('foo'))
// true
util.isString(5)
// false
If `--no-deprecation` is set then this function is a NO-OP. Configurable
at run-time through the `process.noDeprecation` boolean (only effective
when set before a module is loaded.)
## util.isSymbol(object)
If `--trace-deprecation` is set, a warning and a stack trace are logged
to the console the first time the deprecated API is used. Configurable
at run-time through the `process.traceDeprecation` boolean.
Stability: 0 - Deprecated
If `--throw-deprecation` is set then the application throws an exception
when the deprecated API is used. Configurable at run-time through the
`process.throwDeprecation` boolean.
Returns `true` if the given "object" is a `Symbol`. `false` otherwise.
`process.throwDeprecation` takes precedence over `process.traceDeprecation`.
var util = require('util');
## util.debug(string)
util.isSymbol(5)
// false
util.isSymbol('foo')
// false
util.isSymbol(Symbol('foo'))
// true
Stability: 0 - Deprecated: use console.error() instead.
## util.isUndefined(object)
Deprecated predecessor of `console.error`.
Stability: 0 - Deprecated
## util.error([...])
Returns `true` if the given "object" is `undefined`. `false` otherwise.
Stability: 0 - Deprecated: Use console.error() instead.
var util = require('util');
Deprecated predecessor of `console.error`.
var foo;
util.isUndefined(5)
// false
util.isUndefined(foo)
// true
util.isUndefined(null)
// false
## util.puts([...])
## util.log(string)
Stability: 0 - Deprecated: Use console.log() instead.
Output with timestamp on `stdout`.
Deprecated predecessor of `console.log`.
require('util').log('Timestamped message.');
## util.print([...])
@ -503,9 +494,14 @@ Deprecated predecessor of `console.log`.
Deprecated predecessor of `console.log`.
## util.pump(readableStream, writableStream[, callback])
Stability: 0 - Deprecated: Use readableStream.pipe(writableStream)
Deprecated predecessor of `stream.pipe()`.
## util.puts([...])
Stability: 0 - Deprecated: Use console.log() instead.
Deprecated predecessor of `console.log`.

Write Preview
Loading…
Cancel
Save