Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:126945
Precedence: bulk
MIME-Version: 1.0
References: <CAH5C8xUb1O20ZDrOQNC=ckFxHUUWSK7sw_njQQzFBd0qgQqoww@mail.gmail.com>
 <dd61999c-1ebd-4765-9add-cd8065968965@gmail.com> <CAOV5rgYZ_s1of-igLFEK7oqqh6=3HeYv0=JvvKvvjkcp0F6Q9Q@mail.gmail.com>
 <CAH5C8xV67frqOBCvLt73RM7QO86_pu40sHP5h71_kDRbKPtA8Q@mail.gmail.com>
 <1BCB4144-231D-45EA-A914-98EE8F0F503A@automattic.com> <8E614C9C-BA85-45D8-9A4E-A30D69981C5D@automattic.com>
 <CAH5C8xV69pHnSKWJrVB8EQab7vPhcaXAwYezoG6z3Oj7ZkXBaQ@mail.gmail.com>
 <044E7A8E-B79D-44DB-B572-102A80CDFC3C@automattic.com> <CAH5C8xWpquzmvtbSk6=mL4U0z=Tupv2zD+FXag+zenF7q04HUQ@mail.gmail.com>
In-Reply-To: <CAH5C8xWpquzmvtbSk6=mL4U0z=Tupv2zD+FXag+zenF7q04HUQ@mail.gmail.com>
Date: Tue, 25 Mar 2025 23:23:03 +0100
Message-ID: <CAH5C8xXeJf96ETaphZvKoX19Ssd_Uc=8jMbc4J-HuciCUF=XzA@mail.gmail.com>
Subject: Re: [PHP-DEV] [RFC] [Discussion] Add WHATWG compliant URL parsing API
To: Dennis Snell <dennis.snell@automattic.com>
Cc: Internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary="000000000000b360a00631322a55"
From: kocsismate90@gmail.com (=?UTF-8?B?TcOhdMOpIEtvY3Npcw==?=)

--000000000000b360a00631322a55
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hi Dennis,

I am myself also a bit lost on the countless names that I tried out in the
> implementation, but I think I had toHumanFriendlyString() and
> toDisplayFriendlyString() methods at some point. These then ended up bein=
g
> toString() and toDisplayString() after some iterations. I would be ok wit=
h
> renaming getHost() and toString() so that their names suggest they don't
> use IDNA, but I'd clearly need a good enough suggestion, since neither
> "MachineFriendly", nor "NonDisplayable" sound like the best alternative f=
or
> me. I was also considering using getIdnaHost() and toIdnaString(), but I
> realized these are the worst looking names I have come up with so far.
>

What about getPunycodeHost(), getUnicodeHost(), toPunycodeString(),
toUnicodeString()? Or getAsciiHost() and toAsciiString() may also work.
These are the best names I managed to come up with so far.

In the meantime, I renamed RFC 3986's toString() methods too according to
another suggestion:
- toString() became toRawString()
- toNormalizedString() became toString()

The new names mirror exactly what their getter counterparts do.

M=C3=A1t=C3=A9

>

--000000000000b360a00631322a55
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr">Hi Dennis,</div><div dir=3D"ltr"><br></di=
v><div class=3D"gmail_quote gmail_quote_container"><blockquote class=3D"gma=
il_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,2=
04,204);padding-left:1ex"><div dir=3D"ltr"><div class=3D"gmail_quote"><div>=
I am myself also a bit lost on the countless names that I tried out in the =
implementation, but I think I had toHumanFriendlyString() and toDisplayFrie=
ndlyString() methods at some point. These then ended up being toString() an=
d toDisplayString() after some iterations. I would be ok with renaming getH=
ost() and toString() so=C2=A0that their names suggest they don&#39;t use ID=
NA,=C2=A0but I&#39;d clearly need a good enough=C2=A0suggestion, since neit=
her &quot;MachineFriendly&quot;, nor &quot;NonDisplayable&quot; sound like =
the best alternative for me. I was also considering using getIdnaHost() and=
 toIdnaString(), but I realized these are the worst looking names I have co=
me up with so=C2=A0far.</div></div></div></blockquote><div><br></div><div>W=
hat about getPunycodeHost(), getUnicodeHost(), toPunycodeString(), toUnicod=
eString()? Or getAsciiHost() and toAsciiString() may also work. These are t=
he best names I managed to come up with so far.</div><div><br></div><div>In=
 the=C2=A0meantime, I renamed RFC 3986&#39;s toString() methods too accordi=
ng to another suggestion:</div><div>- toString() became toRawString()</div>=
<div>- toNormalizedString() became toString()</div><div><br></div><div>The =
new names mirror exactly what their getter counterparts do.</div><div><br><=
/div><div>M=C3=A1t=C3=A9=C2=A0</div><blockquote class=3D"gmail_quote" style=
=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding=
-left:1ex">
</blockquote></div></div>

--000000000000b360a00631322a55--