Delen via

about_Numeric_Literals

  • Artikel

Korte beschrijving

In dit artikel worden de syntaxis en het gebruik van numerieke waarden in PowerShell beschreven.

Lange beschrijving

Er zijn twee soorten numerieke letterlijke waarden: geheel getal en reëel. Beide kunnen type- en vermenigvuldigerachtervoegsels hebben.

Letterlijke waarden voor gehele getallen

Letterlijke gehele getallen kunnen worden geschreven in decimale, hexadecimale of binaire notatie. Hexadecimale letterlijke waarden worden voorafgegaan door 0x en binaire letterlijke waarden worden voorafgegaan door 0b deze te onderscheiden van decimale getallen.

Letterlijke waarden voor gehele getallen kunnen een typeachtervoegsel en een vermenigvuldigerachtervoegsel hebben.

Achtervoegsel Betekenis Notitie
y ondertekend bytegegevenstype Toegevoegd in PowerShell 6.2
uy niet-ondertekend bytegegevenstype Toegevoegd in PowerShell 6.2
s kort gegevenstype Toegevoegd in PowerShell 6.2
us niet-ondertekend kort gegevenstype Toegevoegd in PowerShell 6.2
l lang gegevenstype
u niet-ondertekend int of lang gegevenstype Toegevoegd in PowerShell 6.2
ul niet-ondertekend lang gegevenstype Toegevoegd in PowerShell 6.2
n BigInteger-gegevenstype Toegevoegd in PowerShell 7.0
kb kibibyte (10241) vermenigvuldiger
mb mebibyte (10242) vermenigvuldiger
gb gigibyte (10243) vermenigvuldiger
tb teribyte (10244) vermenigvuldiger
pb petibyte (10245) vermenigvuldiger

Het type van een letterlijk geheel getal wordt bepaald door de waarde, het achtervoegsel van het type en het achtervoegsel van de numerieke vermenigvuldiger.

Voor een letterlijk geheel getal zonder typeachtervoegsel:

  • Als de waarde kan worden weergegeven op type [int], is dat het type.
  • Als de waarde anders kan worden vertegenwoordigd door type [long], is dat het bijbehorende type.
  • Als de waarde anders kan worden vertegenwoordigd door type [decimal], is dat het bijbehorende type.
  • Anders wordt deze vertegenwoordigd door het type [double].

Voor een letterlijk geheel getal met een typeachtervoegsel:

  • Als het achtervoegsel van het type is u en de waarde kan worden vertegenwoordigd door het type [uint] , is [uint]het bijbehorende type.
  • Als het achtervoegsel van het type is u en de waarde kan worden vertegenwoordigd door het type [ulong] , is [ulong]het bijbehorende type.
  • Als de waarde ervan kan worden vertegenwoordigd door het opgegeven type, is dat het type.
  • Anders is die letterlijke vorm onjuist.

Echte letterlijke gegevens

Echte letterlijke gegevens kunnen alleen worden geschreven in decimale notatie. Deze notatie kan breukwaarden bevatten na een decimaalteken en wetenschappelijke notatie met behulp van een exponentieel deel.

Het exponentiële deel bevat een e, gevolgd door een optioneel teken (+/-) en een getal dat de exponent vertegenwoordigt. De letterlijke waarde 1e2 is bijvoorbeeld gelijk aan de numerieke waarde 100.

Echte letterlijke gegevens kunnen een typeachtervoegsel en een vermenigvuldigerachtervoegsel hebben.

Achtervoegsel Betekenis
d Decimaal gegevenstype
kb kibibyte (10241) vermenigvuldiger
mb mebibyte (10242) vermenigvuldiger
gb gigibyte (10243) vermenigvuldiger
tb teribyte (10244) vermenigvuldiger
pb petibyte (10245) vermenigvuldiger

Er zijn twee soorten echte letterlijke waarden: dubbel en decimaal. Deze worden aangegeven door respectievelijk afwezigheid of aanwezigheid van het achtervoegsel van het decimaaltype. PowerShell biedt geen ondersteuning voor een letterlijke weergave van een [float] waarde. Een dubbele letterlijke letterlijke tekst heeft type [double]. Een letterlijke letterlijke decimale decimaal heeft een type [decimal]. Volgnullen in het breukgedeelte van een letterlijke decimaalteken zijn aanzienlijk.

Als de waarde van de cijfers van exponent-part in een [double] reële letterlijke waarde kleiner is dan het minimum dat wordt ondersteund, is de waarde van die [double] werkelijke letterlijke waarde 0. Als de waarde van de cijfers van exponent-part in een [decimal] echte letterlijke waarde kleiner is dan het minimum dat wordt ondersteund, is die letterlijke waarde ongeldig. Als de waarde van de cijfers van exponent-part in een [double] of [decimal] echte letterlijke waarde groter is dan het maximum dat wordt ondersteund, is die letterlijke waarde ongeldig.

Notitie

Met de syntaxis kan een dubbele letterlijke letterlijke tekst een lang-type achtervoegsel hebben. PowerShell behandelt dit geval als een letterlijk geheel getal waarvan de waarde wordt vertegenwoordigd door het type [long]. Deze functie is behouden voor achterwaartse compatibiliteit met eerdere versies van PowerShell. Programmeurs worden echter afgeraden om letterlijke gehele getallen van dit formulier te gebruiken, omdat ze de werkelijke waarde van de letterlijke waarde gemakkelijk kunnen verdoezelen. Heeft bijvoorbeeld 1.2L waarde 1, 1.2345e1L waarde 12 en 1.2345e-5L heeft waarde 0, die niet direct duidelijk zijn.

Numerieke vermenigvuldigers

Voor het gemak kunnen gehele getallen en reële letterlijke waarden een numerieke vermenigvuldiger bevatten, wat een van een reeks veelgebruikte machten van 2 aangeeft. De numerieke vermenigvuldiger kan worden geschreven in elke combinatie van hoofdletters of kleine letters.

De vermenigvuldigerachtervoegsels kunnen worden gebruikt in combinatie met elk typeachtervoegsel, maar moeten aanwezig zijn na het achtervoegsel van het type. De letterlijke waarde 100gbL is bijvoorbeeld ongeldig, maar de letterlijke waarde 100Lgb is geldig.

Als een vermenigvuldiger een waarde maakt die de mogelijke waarden voor het numerieke type overschrijdt dat door het achtervoegsel wordt opgegeven, is de letterlijke waarde ongeldig. De letterlijke waarde 1usgb is bijvoorbeeld onjuist, omdat de waarde 1gb groter is dan wat is toegestaan voor het [ushort] type dat is opgegeven door het us achtervoegsel.

Voorbeelden van vermenigvuldigers

PS> 1kb
1024

PS> 1.30Dmb
1363148.80

PS> 0x10Gb
17179869184

PS> 1.4e23tb
1.5393162788864E+35

PS> 0x12Lpb
20266198323167232

Numerieke typeversnellers

PowerShell ondersteunt de volgende typeversnellers:

Accelerator Notitie Beschrijving
[byte] Byte (niet-ondertekend)
[sbyte] Byte (ondertekend)
[Int16] 16-bits geheel getal
[short] alias voor [int16] 16-bits geheel getal
[UInt16] 16-bits geheel getal (niet ondertekend)
[ushort] alias voor [uint16] 16-bits geheel getal (niet ondertekend)
[Int32] 32-bits geheel getal
[int] alias voor [int32] 32-bits geheel getal
[UInt32] 32-bits geheel getal (niet-ondertekend)
[uint] alias voor [uint32] 32-bits geheel getal (niet-ondertekend)
[Int64] 64-bits geheel getal
[long] alias voor [int64] 64-bits geheel getal
[UInt64] 64-bits geheel getal (niet-ondertekend)
[ulong] alias voor [uint64] 64-bits geheel getal (niet-ondertekend)
[bigint] Zie BigInteger Struct
[single] Drijvende komma met één precisie
[float] alias voor [single] Drijvende komma met één precisie
[double] Dubbele precisie drijvende komma
[decimal] 128-bits drijvende komma

Notitie

De volgende typeversnellers zijn toegevoegd in PowerShell 6.2: [short], [ushort], [uint], . [ulong]

Voorbeelden

De volgende tabel bevat verschillende voorbeelden van numerieke letterlijke waarden en een lijst met het type en de waarde:

Aantal Type Weergegeven als
100 Int32 100
100u UInt32 100
100D Decimal 100
100l Int64 100
100uL UInt64 100
100us UInt16 100
100uy Byte 100
100y SByte 100
1e2 Dubbel 100
1.e2 Dubbel 100
0x1e2 Int32 482
0x1e2L Int64 482
0x1e2D Int32 7725
482D Decimal 482
482gb Int64 517543559168
482n gb BigInteger 517543559168
0x1e2lgb Int64 517543559168
0b1011011 Int32 91
0xFFFFs Int16 -1
0xFFFFFFFF Int32 -1
-0xFFFFFFFF Int32 1
0xFFFFFFFFu UInt32 4294967295

Werken met binaire of hexadecimale getallen

Te grote binaire of hexadecimale letterlijke waarden kunnen worden geretourneerd als [bigint] in plaats van dat het parseren mislukt, als en alleen als het n achtervoegsel is opgegeven. Teken-bits worden nog steeds gerespecteerd boven even [decimal] bereiken, maar:

  • Als een binaire tekenreeks een veelvoud van 8 bits lang is, wordt de hoogste bit behandeld als de teken-bit.
  • Als een hextekenreeks, die een lengte heeft die een veelvoud is van 8, het eerste cijfer met 8 of hoger heeft, wordt het numerieke getal beschouwd als negatief.

Als u een niet-ondertekend achtervoegsel op binaire en hex letterlijke tekens opgeeft, worden teken-bits genegeerd. Retourneert 0xFFFFFFFFbijvoorbeeld-1, maar 0xFFFFFFFFu retourneert de [uint]::MaxValue 4294967295.

In PowerShell 7.1 retourneert het gebruik van een typeachtervoegsel op een hex-letterlijke waarde nu een ondertekende waarde van dat type. In PowerShell 7.0 retourneert de expressie 0xFFFFs bijvoorbeeld een fout omdat de positieve waarde te groot is voor een [int16] type. PowerShell 7.1 interpreteert dit als -1 een [int16] type.

Als u het letterlijke voorvoegsel met een 0 letterlijke voorvoegsel gebruikt, wordt dit overgeslagen en als niet-ondertekend behandeld. Voorbeeld: 0b011111111. Dit kan nodig zijn wanneer u met letterlijke gegevens in het [bigint] bereik werkt, omdat de u en n achtervoegsels niet kunnen worden gecombineerd.

U kunt ook binaire en hex letterlijke gegevens ontkenen met behulp van het - voorvoegsel. Dit kan resulteren in een positief getal omdat teken-bits zijn toegestaan.

Teken-bits worden geaccepteerd voor BigInteger-achtervoegsels met cijfers:

  • BigInteger-achtervoegsel hex behandelt de hoge bit van elke letterlijke waarde met een lengte van 8 tekens als de teken-bit. De lengte bevat 0x geen voorvoegsel of eventuele achtervoegsels.
  • BigInteger-achtervoegsel binaire accepteert teken-bits met 96 en 128 tekens, en om de 8 tekens erna.

Conversie van numeriek type

Wanneer tekenreeksen worden geconverteerd naar getallen, worden aanvullende hexadecimale notatie-indicatoren ondersteund. Deze aanvullende indelingen worden niet herkend als letterlijke gegevens.

[int] '0xF' -eq 0xF
[int] '&hF' -eq 0xF
[int] '#F' -eq 0xF
[int] '0b1111' -eq 0b1111
[int] '0b1111' -eq 15

Opdrachten die eruitzien als numerieke letterlijke waarden

Elke opdracht die eruitziet als een geldige letterlijke numerieke waarde, moet worden uitgevoerd met behulp van de aanroepoperator (&), anders wordt deze geïnterpreteerd als een getal. Ongeldige letterlijke waarden met een geldige syntaxis, zoals 1usgb dit resulteert in de volgende fout:

PS> 1usgb
At line:1 char:6
+ 1usgb
+      ~
The numeric constant 1usgb is not valid.
+ CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
+ FullyQualifiedErrorId : BadNumericConstant

Ongeldige letterlijke tekens met ongeldige syntaxis worden 1gbus echter geïnterpreteerd als een standaardbare tekenreeks en kunnen worden geïnterpreteerd als een geldige opdrachtnaam in contexten waarin opdrachten kunnen worden aangeroepen.

Eigenschappen en methoden van numerieke objecten openen

Als u toegang wilt krijgen tot een lid van een numerieke letterlijke waarde, zijn er gevallen waarin u de letterlijke waarde tussen haakjes moet insluiten.

  • De letterlijke gegevens hebben geen decimaalteken
  • De letterlijke notatie heeft geen cijfers na het decimaalteken
  • De letterlijke heeft geen achtervoegsel

Het volgende voorbeeld mislukt bijvoorbeeld:

PS> 2.GetType().Name
At line:1 char:11
+ 2.GetType().Name
+           ~
An expression was expected after '('.
+ CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
+ FullyQualifiedErrorId : ExpectedExpression

De volgende voorbeelden werken:

PS> 2uL.GetType().Name
UInt64
PS> 1.234.GetType().Name
Double
PS> (2).GetType().Name
Int32

De eerste twee voorbeelden werken zonder de letterlijke waarde tussen haakjes te plaatsen, omdat de PowerShell-parser kan bepalen waar de numerieke letterlijke waarde eindigt en de GetType-methode wordt gestart.

Hoe PowerShell numerieke letterlijke waarden parseert

PowerShell v7.0 heeft de manier gewijzigd waarop numerieke letterlijke waarden worden geparseerd om de nieuwe functies in te schakelen.

Echte numerieke letterlijke waarden parseren

Als de letterlijke waarde een decimaalteken of de e-notatie bevat, wordt de letterlijke tekenreeks geparseerd als een reëel getal.

  • Als het decimaalachtervoegsel aanwezig is, wordt het rechtstreeks in [decimal].
  • Parseer anders als [Double] en pas vermenigvuldiger toe op de waarde. Controleer vervolgens de achtervoegsels van het type en probeer te casten naar het juiste type.
  • Als de tekenreeks geen typeachtervoegsel heeft, parseert u deze als [Double].

Numerieke letterlijke numerieke getallen parseren

Letterlijke waarden voor geheel getaltypen worden geparseerd met behulp van de volgende stappen:

  1. De radix-indeling bepalen
    • Voor binaire indelingen kunt u parseren in [BigInteger].
    • Voor hexadecimale indelingen parseert u het [BigInteger] gebruik van speciale gevallen om oorspronkelijk gedrag te behouden wanneer de waarde zich in het [int] of [long] bereik bevindt.
    • Als zowel binair als hex, parseert u normaal als een [BigInteger].
  2. Pas de vermenigvuldigerwaarde toe voordat u casts uitvoert om ervoor te zorgen dat typegrenzen op de juiste wijze kunnen worden gecontroleerd zonder overloop.
  3. Controleer de achtervoegsels van het type.
    • Controleer de typegrenzen en probeer het in dat type te parseren.
    • Als er geen achtervoegsel wordt gebruikt, wordt de waarde ingecheckt in de volgende volgorde, wat resulteert in de eerste geslaagde test die het type van het getal bepaalt.
      • [int]
      • [long]
      • [decimal] (alleen letterlijke basis 10)
      • [double] (alleen letterlijke basis 10)
    • Als de waarde buiten het [long] bereik voor hex- en binaire getallen valt, mislukt de parsering.
    • Als de waarde buiten het [double] bereik voor het getal basis 10 valt, mislukt de parsering.
    • Hogere waarden moeten expliciet worden geschreven met behulp van het n achtervoegsel om de letterlijke waarde te parseren als een BigInteger.

Letterlijke waarden van grote waarden parseren

Eerder werden hogere gehele getallen geparseerd als dubbel voordat ze naar een ander type werden gecast. Dit resulteert in een verlies van precisie in de hogere bereiken. Voorbeeld:

PS> [bigint]111111111111111111111111111111111111111111111111111111
111111111111111100905595216014112456735339620444667904

Om dit probleem te voorkomen, moest u waarden schrijven als tekenreeksen en deze vervolgens converteren:

PS> [bigint]'111111111111111111111111111111111111111111111111111111'
111111111111111111111111111111111111111111111111111111

In PowerShell 7.0 moet u het N achtervoegsel gebruiken.

PS> 111111111111111111111111111111111111111111111111111111n
111111111111111111111111111111111111111111111111111111

Waarden tussen [ulong]::MaxValue en [decimal]::MaxValue moeten ook worden aangeduid met behulp van het decimaalachtervoegsel D om de nauwkeurigheid te behouden. Zonder het achtervoegsel worden deze waarden geparseerd als [Double] het gebruik van de echte parseringsmodus.