Paket | flash.globalization |
Klasse | public final class StringTools |
Vererbung | StringTools Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
In einigen Situationen ist die Konvertierung von Groß- und Kleinbuchstaben nicht ein einfaches Zuordnen von einem Zeichen zu einem anderen, sondern benötigt sprachen- oder kontextabhängige Verarbeitung. Beispiel:
- In den Sprachen Türkisch und Azeri ist der entsprechende Großbuchstabe für das kleine i ein großes I mit Punkt: İ (U+0130). Dementsprechend ist der Kleinbuchstabe für das große I ohne Punkt ein kleines ı ohne Punkt (U+0131).
- Der deutsche Kleinbuchstabe ß (U+00DF) wird als Großbuchstabe in „SS“ umgewandelt.
- Im Griechischen gibt es zwei Darstellungen des kleinen sigma, σ (U+03C3) und ς (U+03C2), die beide in dasselbe große Sigma, Σ (U+03A3) konvertiert werden.
Die Methoden toLowerCase()
und toUpperCase()
dieser Klasse stellen diese speziellen Konvertierungslogiken bereit.
Aufgrund der Verwendung von Benutzereinstellungen, von Regeln für die Umwandlung von Groß- und Kleinbuchstaben, die vom Betriebssystem bereitgestellt werden, und von einem Ersatzgebietsschema, falls das angeforderte Gebietsschema nicht unterstützt wird, sehen die Benutzer möglicherweise unterschiedliche Groß-/Kleinbuchstabenkonvertierungen, selbst wenn sie dasselbe Gebietsschema verwenden.
Eigenschaft | Definiert von | ||
---|---|---|---|
actualLocaleIDName : String [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem StringTools-Objekt verwendet wird. | StringTools | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
lastOperationStatus : String [schreibgeschützt]
Der Status der letzten Operation, die dieses StringTools-Objekt ausgeführt hat. | StringTools | ||
requestedLocaleIDName : String [schreibgeschützt]
Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses StringTools-Objekts übergeben wurde. | StringTools |
Methode | Definiert von | ||
---|---|---|---|
StringTools(requestedLocaleIDName:String)
Konstruiert ein neues StringTools-Objekt, das Groß-/Kleinschreibungskonvertierung und andere Dienstprogramme gemäß den Konventionen eines gegebenen Gebietsschemas bietet. | StringTools | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | StringTools | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Konvertiert einen String in Großbuchstaben gemäß den Sprachkonventionen. | StringTools | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Konvertiert einen String in Kleinbuchstaben gemäß den Sprachkonventionen. | StringTools | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
actualLocaleIDName | Eigenschaft |
actualLocaleIDName:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der Gebietsschema-ID, die von diesem StringTools-Objekt verwendet wird.
Es gibt drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des requestedLocaleIDName
-Parameters, der an den StringTools()
-Konstruktor übergeben wird.
- Wenn das angeforderte Gebietsschema nicht
LocaleID.DEFAULT
war und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit derrequestedLocaleIDName
-Eigenschaft. - Wenn
LocaleID.DEFAULT
als Wert für denrequestedLocaleIDName
-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. DerLocaleID.DEFAULT
-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts alsrequestedLocaleIDName
-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung vonLocaleID.DEFAULT
, selbst wenn die beiden Gebietsschema-ID-Namen identisch sind. Der Benutzer hat die Gebietsschemaeinstellungen auf dem Computer möglicherweise angepasst. Wenn Sie einen expliziten Gebietsschema-ID-Namen anfordern, anstattLocaleID.DEFAULT
zu verwenden, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht. - Wenn das System den im Konstruktor angegebenen
requestedLocaleIDName
nicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.
Implementierung
public function get actualLocaleIDName():String
Verwandte API-Elemente
lastOperationStatus | Eigenschaft |
lastOperationStatus:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Status der letzten Operation, die dieses StringTools-Objekt ausgeführt hat. Die lastOperationStatus
-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine andere Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.
Implementierung
public function get lastOperationStatus():String
Verwandte API-Elemente
requestedLocaleIDName | Eigenschaft |
requestedLocaleIDName:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses StringTools-Objekts übergeben wurde.
Wenn der Wert LocaleID.DEFAULT
verwendet wurde, lautet der zurückgegebene Name "i-default". Das tatsächlich verwendete Gebietsschema kann vom angeforderten Gebietsschema abweichen, wenn ein Ersatzgebietsschema verwendet wird. Der Name des tatsächlich verwendeten Gebietsschemas kann mit der actualLocaleIDName
-Eigenschaft abgerufen werden.
Implementierung
public function get requestedLocaleIDName():String
Verwandte API-Elemente
StringTools | () | Konstruktor |
public function StringTools(requestedLocaleIDName:String)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Konstruiert ein neues StringTools-Objekt, das Groß-/Kleinschreibungskonvertierung und andere Dienstprogramme gemäß den Konventionen eines gegebenen Gebietsschemas bietet.
Dieser Konstruktor ermittelt, ob das aktuelle Betriebssystem den angeforderten Gebietsschema-ID-Namen unterstützt. Wenn dieser nicht unterstützt wird, wird stattdessen ein Ersatzgebietsschema verwendet. Wenn ein Ersatzgebietsschema verwendet wird, gibt die lastOperationStatus
-Eigenschaft den Typ der Ausweichlösung an und die actualLocaleIDName
-Eigenschaft enthält den Namen der Ersatzgebietsschema-ID.
Wenn dieser Konstruktor erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft auf diesen Wert gesetzt:
LastOperationStatus.NO_ERROR
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat lastOperationStatus
einen der folgenden Werte:
LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
requestedLocaleIDName:String — Der bevorzugte Gebietsschema-ID-Name, der beim Bestimmen von Datums- oder Uhrzeitformaten verwendet wird.
|
Auslöser
ArgumentError — wenn der requestedLocaleIDName -Parameter den Wert null hat
|
Verwandte API-Elemente
getAvailableLocaleIDNames | () | Methode |
public static function getAvailableLocaleIDNames():Vector.<String>
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Vector.<String> — Ein Vektor von Strings, der alle von dieser Klasse unterstützten Gebietsschema-ID-Namen enthält.
|
toLowerCase | () | Methode |
public function toLowerCase(s:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Konvertiert einen String in Großbuchstaben gemäß den Sprachkonventionen. Je nach Gebietsschema kann die Länge des Ausgabestrings von der Länge des Eingabestrings abweichen.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
s:String — Ein String, der in Kleinbuchstaben konvertiert werden soll.
|
String — Der konvertierte String in Kleinbuchstaben.
|
Auslöser
ArgumentError — wenn der s -Parameter den Wert null hat
|
Verwandte API-Elemente
toUpperCase | () | Methode |
public function toUpperCase(s:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Konvertiert einen String in Kleinbuchstaben gemäß den Sprachkonventionen. Je nach Gebietsschema kann die Länge des Ausgabestrings von der Länge des Eingabestrings abweichen.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus
-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus
-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus
-Klasse definiert sind.
Parameter
s:String — Ein String, der in Großbuchstaben konvertiert werden soll.
|
String — Der konvertierte String in Großbuchstaben.
|
Auslöser
ArgumentError — wenn der s -Parameter den Wert null hat
|
Verwandte API-Elemente
Dieses Beispiel führt die folgenden Schritte aus:
- Erstellt ein StringTools-Objekt.
- Definiert drei Strings mit Zeichen, die im Türkischen, Griechischen und Deutschen verwendet werden.
- Konvertiert jeden String in Großbuchstaben und Kleinbuchstaben und zeigt die Ergebnisse an. Dieses Beispiel demonstriert interessante gebietsschemaspezifische Verhaltensweisen für Zeichen wie das türkische „ı“ und „Ä°, das deutsche „ß“ und das griechische „Σςσ“.
package { import flash.display.Sprite; import flash.globalization.LocaleID; import flash.globalization.StringTools; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class StringToolsExample extends Sprite { public function StringToolsExample() { var localeName:String= LocaleID.DEFAULT; var strTool:StringTools = new StringTools(localeName); trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName + "; actual: " + nf.actualLocaleIDName); trace( "Last Operation Status:" + nf.lastOperationStatus ); var turkishStr:String = "iI ıİ"; var greekStr:String = "Σςσβΰ�Σ"; var germanStr:String= "ß"; var tfTurInp:TextField = createTextField(10, 10); tfTurInp.text="Turkish Input: \t " + turkishStr; var tfdash:TextField = createTextField(10, 20); tfdash.text="-------------------"; var tf1:TextField = createTextField(10, 30); tf1.text="\t Upper case: \t " + strTool.toUpperCase(turkishStr); var tf2:TextField = createTextField(10, 40); tf2.text="\t Lower case: \t " + strTool.toLowerCase(turkishStr); var tfgreekInp:TextField = createTextField(10, 60); tfgreekInp.text="Greek Input: \t " + greekStr; var tfdash1:TextField = createTextField(10, 70); tfdash1.text="-------------------"; var tf3:TextField = createTextField(10, 80); tf3.text="\t Upper case: \t " + strTool.toUpperCase(greekStr); var tf4:TextField = createTextField(10, 90); tf4.text="\t Lower case: \t " + strTool.toLowerCase(greekStr); var tfgermanInp:TextField = createTextField(10, 110); tfgermanInp.text="German Input: \t " + germanStr; var tfdash2:TextField = createTextField(10, 120); tfdash2.text="-------------------"; var tf5:TextField = createTextField(10, 130); tf5.text="\t Upper case: \t " + strTool.toUpperCase(germanStr); var tf6:TextField = createTextField(10, 140); tf6.text="\t Lower case: \t " + strTool.toLowerCase(germanStr); } private function createTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
Tue Jun 12 2018, 10:04 AM Z