Uize.String | Documentation | UIZE JavaScript Framework (original) (raw)

The Uize.String module is a deprecated module (DEPRECATED 2013-10-21).

DEVELOPERS: Chris van Rensburg

1.1. Deprecated

The Uize.String module has been deprecated in favor of various, smaller modules under the [Uize.Str](../reference/Uize.Str.html) and [Uize.Array](../reference/Uize.Array.html) namespaces.

1.1.1. The Rationale

The Uize.String module has been deprecated, with its various utility methods split amongst numerous smaller modules, in order to allow developers to deploy more compact code.

With the new arrangement of smaller modules under the purely namespace [Uize.Str](../reference/Uize.Str.html) module, it is now possible to use just some parts of the functionality without dragging along all of the baggage. Many of the methods in the Uize.String module were only infrequently used. The new arrangement of methods in mini modules provides a better strategy for making new functionality available in future without leading to bloat.

1.1.2. Backwards Compatibility

In order to maintain backwards compatibility while this module is still in the deprecated state, and before it is killed entirely, this module aggregates methods from the various newer modules contained under the [Uize.Str](../reference/Uize.Str.html) and [Uize.Array](../reference/Uize.Array.html) namespaces.

All the static methods that have been migrated to other modules are still supported in this module and behave in exactly the same way as before.

1.1.3. Update Your Code

In order to update your code to prepare for the eventual expiration of this backwards compatibility provision, you should change all calls to the methods of the Uize.String module in your code, according to the following map...

Uize.String.hugJoin >> BECOMES >> Uize.Array.Join.hugJoin

Uize.String.limitLength >> BECOMES >> Uize.Str.Limit.limitLength Uize.String.joinUsingSuffixPriority >> BECOMES >> Uize.Str.Limit.joinUsingSuffixPriority

Uize.String.contains >> BECOMES >> Uize.Str.Has.has Uize.String.startsWith >> BECOMES >> Uize.Str.Has.hasPrefix Uize.String.endsWith >> BECOMES >> Uize.Str.Has.hasSuffix

Uize.String.toCamel >> BECOMES >> Uize.Str.Camel.to

Uize.String.repeat >> BECOMES >> Uize.Str.Repeat.repeat

Uize.String.split >> BECOMES >> Uize_Str_Split.split Uize.String.splitInTwo >> BECOMES >> Uize_Str_Split.splitInTwo

Uize.String.hasPadding >> BECOMES >> Uize.Str.Trim.hasPadding Uize.String.trim >> BECOMES >> Uize.Str.Trim.trim Uize.String.trimLeft >> BECOMES >> Uize.Str.Trim.trimLeft Uize.String.trimRight >> BECOMES >> Uize.Str.Trim.trimRight

1.1.4. New Modules

In order to create homes for the various static methods that were migrated from the deprecated Uize.String module, the following new modules were created...

Uize.Array.Join - methods for joining array elements
Uize.Str.Camel - methods for working with CamelCase
Uize.Str.Has - methods for testing for presence of prefix, suffix, or substring
Uize.Str.Limit - methods for limiting the length of strings
Uize.Str.Repeat - methods for repeating strings
Uize.Str.Split - methods for splitting strings
Uize.Str.Trim- methods for dealing with whitespace padding

1.1.5. Migrated Modules

Because the Uize.String module has been deprecated, the following modules that were using it purely as a namespace, have been migrated to under the new [Uize.Str](../reference/Uize.Str.html) namespace...

Uize.String.Builder >> BECOMES >> Uize.Str.Builder Uize.String.Discombobulator >> BECOMES >> Uize.Str.Discombobulator Uize.String.Lines >> BECOMES >> Uize.Str.Lines Uize.String.Replace >> BECOMES >> Uize.Str.Replace

1.2. Examples

There are no dedicated showcase example pages for the Uize.String module.

SEARCH FOR EXAMPLES

Use the link below to search for example pages on the UIZE Web site that reference the Uize.String module...

1.3. Implementation Info

The Uize.String module defines the Uize.String package under the [Uize](../reference/Uize.html) namespace.

1.3.1. Features Introduced in This Module

The features listed in this section have been introduced in this module.

STATIC METHODS

STATIC PROPERTIES

[Uize.String.moduleName](#3%5F1) | [Uize.String.pathToResources](#3%5F2)

1.3.2. Features Overridden in This Module

No features have been overridden in this module.

1.3.3. Features Inherited From Other Modules

This module has no inherited features.

1.3.4. Modules Directly Under This Namespace

1.3.5. Unit Tests

The Uize.String module is unit tested by the [Uize.Test.Uize.String](../reference/Uize.Test.Uize.String.html) test module.

2.1. Uize.String.contains

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Has.has method implemented in the [Uize.Str.Has](../reference/Uize.Str.Has.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.2. Uize.String.endsWith

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Has.hasSuffix method implemented in the [Uize.Str.Has](../reference/Uize.Str.Has.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.3. Uize.String.hasPadding

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Trim.hasPadding method implemented in the [Uize.Str.Trim](../reference/Uize.Str.Trim.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.4. Uize.String.hugJoin

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Array.Join.hugJoin method implemented in the [Uize.Array.Join](../reference/Uize.Array.Join.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.5. Uize.String.joinUsingSuffixPriority

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Limit.joinUsingSuffixPriority method implemented in the [Uize.Str.Limit](../reference/Uize.Str.Limit.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.6. Uize.String.limitLength

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Limit.limitLength method implemented in the [Uize.Str.Limit](../reference/Uize.Str.Limit.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.7. Uize.String.repeat

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Repeat.repeat method implemented in the [Uize.Str.Repeat](../reference/Uize.Str.Repeat.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.8. Uize.String.split

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Split.split method implemented in the [Uize.Str.Split](../reference/Uize.Str.Split.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.9. Uize.String.splitInTwo

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Split.splitInTwo method implemented in the [Uize.Str.Split](../reference/Uize.Str.Split.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.10. Uize.String.startsWith

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Has.hasPrefix method implemented in the [Uize.Str.Has](../reference/Uize.Str.Has.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.11. Uize.String.toCamel

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Camel.to method implemented in the [Uize.Str.Camel](../reference/Uize.Str.Camel.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.12. Uize.String.trim

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Trim.trim method implemented in the [Uize.Str.Trim](../reference/Uize.Str.Trim.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.13. Uize.String.trimLeft

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Trim.trimLeft method implemented in the [Uize.Str.Trim](../reference/Uize.Str.Trim.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

2.14. Uize.String.trimRight

This method has been deprecated (DEPRECATED 2013-10-21) in favor of the new Uize.Str.Trim.trimRight method implemented in the [Uize.Str.Trim](../reference/Uize.Str.Trim.html) module.

IMPLEMENTATION INFO

this feature was introduced in this module

3.1. Uize.String.moduleName

IMPLEMENTATION INFO

this feature was introduced in this module

3.2. Uize.String.pathToResources

IMPLEMENTATION INFO

this feature was introduced in this module