.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:54:03 1993 by Rik Faith (faith@cs.unc.edu) .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strtoul 3 "20 juli 2023" "Linux man\-pagina's 6.05.01" .SH NAAM strtoul, strtoull, strtouq \- converteert een tekenreeks naar een positief lang geheel getal .SH BIBLIOTHEEK Standard C bibliotheek (\fIlibc\fP, \fI\-lc\fP) .SH SAMENVATTING .nf \fB#include \fP .PP \fBunsigned long strtoul(const char *restrict \fP\fInptr\fP\fB,\fP \fB char **restrict \fP\fIendptr\fP\fB, int \fP\fIbase\fP\fB);\fP \fBunsigned long long strtoull(const char *restrict \fP\fInptr\fP\fB,\fP \fB char **restrict \fP\fIendptr\fP\fB, int \fP\fIbase\fP\fB);\fP .fi .PP .RS -4 Feature Test Macro´s eisen in glibc (zie \fBfeature_test_macros\fP(7)): .RE .PP \fBstrtoull\fP(): .nf _ISOC99_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .fi .SH BESCHRIJVING De \fBstrtuol\fP() functie converteert het initiële deel van een tekenreeks in \fInptr\fP naar een positief lang geheel getal met als \fIgrondtal\fP als grondtal, grondtal moet liggen tussen 2 en 36 (inclusief deze grenzen), of de speciale waarde 0. .PP De tekenreeks mag beginnen met een willekeurig aantal witruimtes (zoals bepaald door \fBisspace\fP(3)) gevolgd door een enkel optioneel teken \[aq]+\[aq] or \[aq]\-\[aq]. Als het \fIgrondtal\fP nul of 16 is, dan mag de string "0x" of "0X" bevatten en wordt het getal gelezen met 16 als grondtal; in andere gevallen zal het \fIgrondtal\fP 0 geïnterpreteerd worden als 10 (decimaal) behalve als het volgende teken \[aq]0\[aq] is, in welk geval het geïnterpreteerd wordt als 8 (octaal). .PP De rest van de tekenreeks zal geconverteerd worden naar een \fIlong\fP waarde in de voor de hand liggende manier, eindigende bij het eerste ongeldige teken in het gekozen grondtal. (Grondtallen groter dan 10, vertegenwoordigd de letter \(aqA\(aq in zowel hoofd\- als kleine letter 10, \[aq]B\[aq] vertegenwoordigd 11, en zo voorts, met \[aq]Z\[aq] vertegenwoordigde 35.) .PP Zodra \fIendptr\fP niet NULL is, zal \fBstrtoul\fP het adres van het eerste ongeldige teken in \fI*endptr\fP opslaan. Als er geen enkel cijfer was dan bewaart \fBstrtoul\fP() de originele waarde van \fInptr\fP in \fI*endptr\fP (en geeft een 0 terug). In het bijzonder, als \fI*nptr\fP niet gelijk is aan \[aq]\e0\[aq] maar \fI**endptr\fP is \[aq]\e0\[aq] bij terugkeer, dan is de hele tekenreeks geldig. .PP De \fBstrtoull\fP() functie werkt net als de \fBstrtoul\fP() functie maar geeft een positief\-lang\-lang gehele waarde terug. .SH "EIND WAARDE" De \fBstrtoul\fP() functie retourneert het resultaat van een conversie, of als er sprake was van een leidend min\-teken, de negatie van het resultaat van de conversie gerepresenteerd als een positieve waarde,, behalve als de originele (niet\-negatie) waarde zou onderlopen; in het laatste geval, retourneert \fBstrtoul\fP() \fBULONG_MAX\fP en zet \fIerrno\fP op \fBERANGE\fP. Precies hetzelfde is geldig voor \fBstrtoull\fP() (met \fBULLONG_MAX\fP in plaats van \fBULONG_MAX\fP). .SH FOUTEN .TP \fBEINVAL\fP (niet in C99) Het gegeven \fIgrondtal\fP bevat een niet ondersteunde waarde. .TP \fBERANGE\fP De resulterende waarde was buiten bereik. .PP De implementatie mag \fIerrno\fP zetten op \fBEINVAL\fP in het geval dat er geen omzetting plaats vond (geen cijfers gezien en 0 geretourneerd). .SH ATTRIBUTEN Voor een uitleg van de termen in deze sectie, zie \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribuut Waarde T{ .na .nh \fBstrtoul\fP(), \fBstrtoull\fP(), \fBstrtouq\fP() T} Thread veiligheid MT\-Safe taalgebied .TE .sp 1 .SH "VOLDOET AAN" C11, POSIX.1\-2008. .SH GESCHIEDENIS .TP \fBstrtoul\fP() POSIX.1\-2001, C89, SVr4. .TP \fBstrtoull\fP() POSIX.1\-2001, C99. .SH OPMERKINGEN Omdat \fBstrtoul\fP() legitiem 0, \fBULONG_MAX\fP, of \fBULONG_MIN\fP (\fBLLONG_MAX\fP of \fBLLONG_MIN\fP voor \fBstrtoull\fP()) kan retourneren bij zowel succes of falen, moet het aanroepende programma \fIerrno\fP op 0 zetten voor de aanroep, en vervolgens bepalen of een fout optrad door te controleren of \fIerrno\fP een niet\-nul waarde heeft na de aanroep. .PP Volgens POSIX.1, in taalgebieden anders dan "C" en "POSIX", mogen deze functies andere, implementatie afhankelijke numerieke tekenreeksen accepteren. .PP BSD heeft ook .PP .in +4n .EX \fBu_quad_t strtouq(const char *\fP\fInptr\fP\fB, char **\fP\fIendptr\fP\fB, int \fP\fIgrondtal\fP\fB);\fP .EE .in .PP met complete vergelijkbare definitie. Afhankelijk van de woordgrootte van de huidige architectuur, kan dit equivalent zijn aan \fBstrtoull\fP() of aan \fBstrtoul\fP(). .PP Negatieve waarden worden beschouwd als geldige invoer and worden stilzwijgend omgezet naar een equivalente \fIunsigned long\fP waarde. .SH VOORBEELDEN Zie het voorbeeld in de \fBstrtol\fP(3) handleiding; het gebruik van de functies beschreven in deze handleiding is vergelijkbaar. .SH "ZIE OOK" \fBa64l\fP(3), \fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoumax\fP(3) .PP .SH VERTALING De Nederlandse vertaling van deze handleiding is geschreven door Mario Blättermann en Luc Castermans . .PP Deze vertaling is vrije documentatie; lees de .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID. .PP Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar .MT debian-l10n-dutch@lists.debian.org .ME .